CREATE SERVER

功能描述

定义一个新的外部服务器。

语法格式

CREATE SERVER server_name
    FOREIGN DATA WRAPPER fdw_name
    OPTIONS ( { option_name ' value ' } [, ...] ) ;

参数说明

server_name

server的名称。

取值范围：长度必须小于等于63。
fdw_name

指定外部数据封装器的名称。

取值范围：dist_fdw，hdfs_fdw，log_fdw，file_fdw，mot_fdw，oracle_fdw，mysql_fdw，postgres_fdw，jdbc_fdw。

OPTIONS ( { option_name ' value ' } [, …] )

这个子句为服务器指定选项。这些选项通常定义该服务器的连接细节，但是实际的名称和值取决于该服务器的外部数据包装器。

oracle_fdw支持的options包括：
- dbserver：远端Oracle数据库的连接字符串。
- isolation_level：oracle数据库的事务隔离级别，取值范围：serializable、 read_committed 、 read_only，默认值为serializable。
mysql_fdw支持的options包括：
- host：MySQL Server/MariaDB的地址，默认值为 127.0.0.1。
- port：MySQL Server/MariaDB侦听的端口号，默认值为 3306。
jdbc_fdw支持的options包括：
- drivername：驱动类名称。
- url：JDBC驱动连接串。
- querytimeout：查询超时时间。
- jarfile：驱动包路径。
- maxheapsize：JVM最大堆内存。

postgres_fdw支持的options同libpq支持的连接参数一致，如下表所示：

字符串	描述
host	要链接的主机名。如果主机名以斜杠开头，则它声明使用Unix域套接字通讯而不是TCP/IP通讯；该值就是套接字文件所存储的目录。如果没有声明host，那么默认是与位于/tmp目录（或者安装数据库的时候声明的套接字目录）里面的Unix-域套接字链接。在没有Unix域套接字的机器上，默认与localhost链接。
hostaddr	与之链接的主机的IP地址，是标准的IPv4地址格式，比如，172.28.40.9。如果机器支持IPv6，那么也可以使用IPv6的地址。如果声明了一个非空的字符串，那么使用TCP/IP通讯机制。使用hostaddr取代host可以让应用避免一次主机名查找，这一点对于那些有时间约束的应用来说可能是非常重要的。不过，GSSAPI或SSPI认证方法要求主机名（host）。因此，应用下面的规则：如果声明了不带hostaddr的host那么就强制进行主机名查找。如果声明中没有host，hostaddr的值给出服务器网络地址；如果认证方法要求主机名，那么链接尝试将失败。如果同时声明了host和hostaddr，那么hostaddr的值作为服务器网络地址。host的值将被忽略，除非认证方法需要它，在这种情况下它将被用作主机名。须知：要注意如果host不是网络地址hostaddr处的服务器名，那么认证很有可能失败。如果主机名（host）和主机地址都没有，那么libpq将使用一个本地的Unix域套接字进行链接；或者是在没有Unix域套接字的机器上，它将尝试与localhost链接。
port	主机服务器的端口号，或者在Unix域套接字链接时的套接字扩展文件名。
user	要链接的用户名，缺省是与运行该应用的用户操作系统名同名的用户。
dbname	数据库名，缺省和用户名相同。
password	如果服务器要求口令认证，所用的口令。
connect_timeout	链接的最大等待时间，以秒计（用十进制整数字符串书写），0或者不声明表示无穷。不建议把链接超时的值设置得小于2秒。
client_encoding	为这个链接设置client_encoding配置参数。除了对应的服务器选项接受的值，用户可以使用auto从客户端中的当前环境中确定正确的编码（Unix系统上是LC_CTYPE环境变量）。
options	添加命令行选项以在运行时发送到服务器。
application_name	为application_name配置参数指定一个值，表明当前用户身份。
keepalives	控制客户端侧的TCP保持激活是否使用。缺省值是1，意思为打开，但是如果不想要保持激活，用户可以更改为0，意思为关闭。通过Unix域套接字做的链接忽略这个参数。
keepalives_idle	在TCP应该发送一个保持激活的信息给服务器之后，控制不活动的秒数。0值表示使用系统缺省。通过Unix域套接字做的链接或者如果禁用了保持激活则忽略这个参数。
keepalives_interval	在TCP保持激活信息没有被应该传播的服务器承认之后，控制秒数。0值表示使用系统缺省。通过Unix域套接字做的链接或者如果禁用了保持激活则忽略这个参数。
keepalives_count	添加命令行选项以在运行时发送到服务器。例如，设置为`-c comm_debug_mode=off`，则设置guc参数comm_debug_mode参数的会话的值为off。

需要注意的是，以下几个options不支持修改：

user和password：用户名和密码将在创建user mapping时指定。
client_encoding：将自动获取本地server的编码方式并设置该值。
application_name：总是设置成postgres_fdw。

用于指定外部服务器的各类参数，详细的参数说明如下所示：
- encrypt：是否对数据进行加密，该参数仅支持type为OBS时设置。默认值为on。
  
  取值范围：
  - on表示对数据进行加密，使用HTTPS协议通信。
  - off表示不对数据进行加密，使用HTTP协议通信。
- access_key：OBS访问协议对应的AK值（OBS云服务界面由用户获取），创建外表时AK值会加密保存到数据库的元数据表中。该参数仅支持type为OBS时设置。
- secret_access_key：OBS访问协议对应的SK值（OBS云服务界面由用户获取），创建外表时SK值会加密保存到数据库的元数据表中。该参数仅支持type为OBS时设置。
除了libpq支持的连接参数外，还额外提供3个options：
- use_remote_estimate：控制postgres_fdw是否发出EXPLAIN命令以获取运行消耗估算。默认值为false。
- fdw_startup_cost：执行一个外表扫描时的启动耗时估算。这个值通常包含建立连接、远端对请求的分析和生成计划的耗时。默认值为100。
- fdw_typle_cost：在远端服务器上对每一个元组进行扫描时的额外消耗。这个值通常表示数据在server间传输的额外消耗。默认值为0.01。

示例

创建server。

CREATE FOREIGN DATA WRAPPER extstats_dummy_fdw;
CREATE SERVER extstats_dummy_srv FOREIGN DATA WRAPPER extstats_dummy_fdw;

VastbaseG100

CREATE SERVER

功能描述

语法格式

参数说明

示例

相关链接

弹框头部