SPI_connect
SPI_connect, SPI_connect_ext — подключить функцию на C к менеджеру SPI
Синтаксис
int SPI_connect(void)
int SPI_connect_ext(int options)Описание
SPI_connect устанавливает подключение вызова функции на C к менеджеру SPI. Данную функцию необходимо использовать, если вы хотите выполнять команды через SPI. Некоторые вспомогательные функции SPI могут вызываться из неподключённых функций.
SPI_connect_ext делает то же самое, но принимает один аргумент, через который можно передать дополнительные флаги. В настоящее время поддерживаются следующие флаги:
SPI_OPT_NONATOMICПереводит подключение SPI в неатомарный режим, в котором разрешаются вызовы функций управления транзакциями (
SPI_commit,SPI_rollback). В обычном режиме вызов этих функций приводит к немедленной ошибке.
Вызов SPI_connect() равнозначен SPI_connect_ext(0).
Возвращаемое значение
SPI_OK_CONNECTпри успехе
SPI_ERROR_CONNECTпри ошибке
CREATE SERVER
CREATE SERVER — define a new foreign server
Synopsis
CREATE SERVER [IF NOT EXISTS]server_name[ TYPE 'server_type' ] [ VERSION 'server_version' ] FOREIGN DATA WRAPPERfdw_name[ OPTIONS (option'value' [, ... ] ) ]
Description
CREATE SERVER defines a new foreign server. The user who defines the server becomes its owner.
A foreign server typically encapsulates connection information that a foreign-data wrapper uses to access an external data resource. Additional user-specific connection information may be specified by means of user mappings.
The server name must be unique within the database.
Creating a server requires USAGE privilege on the foreign-data wrapper being used.
Parameters
IF NOT EXISTSDo not throw an error if a server with the same name already exists. A notice is issued in this case. Note that there is no guarantee that the existing server is anything like the one that would have been created.
server_nameThe name of the foreign server to be created.
server_typeOptional server type, potentially useful to foreign-data wrappers.
server_versionOptional server version, potentially useful to foreign-data wrappers.
fdw_nameThe name of the foreign-data wrapper that manages the server.
OPTIONS (option'value' [, ... ] )This clause specifies the options for the server. The options typically define the connection details of the server, but the actual names and values are dependent on the server's foreign-data wrapper.
Notes
When using the dblink module, a foreign server's name can be used as an argument of the dblink_connect function to indicate the connection parameters. It is necessary to have the USAGE privilege on the foreign server to be able to use it in this way.
Examples
Create a server myserver that uses the foreign-data wrapper postgres_fdw:
CREATE SERVER myserver FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host 'foo', dbname 'foodb', port '5432');
See postgres_fdw for more details.
Compatibility
CREATE SERVER conforms to ISO/IEC 9075-9 (SQL/MED).