CREATE SERVER

功能描述

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

注意事项

OPTIONS中的敏感字段（如password, secret_access_key）在使用多层引号时，语义和不带引号的场景是不同的，因此不会被识别为敏感字段进行脱敏。

语法格式

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

参数说明

• server_name

  server的名称。

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

• fdw_name

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

  取值范围：dist_fdw，log_fdw，file_fdw。其中log_fdw和file_fdw仅作语法兼容，可以创建外表，无实际使用意义，不做额外使用说明。

• OPTIONS ( { option_name ' value ' } [, ...] )

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

  • 用于指定外部服务器的各类参数，详细的参数说明如下所示。
    • encrypt

      是否对数据进行加密，该参数仅支持type为OBS时设置。默认值为on。

      取值范围：

      • on表示对数据进行加密，使用HTTPS协议通信。
      • off表示不对数据进行加密，使用HTTP协议通信。
    • access_key

      OBS访问协议对应的AK值（OBS云服务界面由用户获取）。该参数仅支持type为OBS时设置。

    • secret_access_key

      OBS访问协议对应的SK值（OBS云服务界面由用户获取）。该参数仅支持type为OBS时设置。

  除了libpq支持的连接参数外，还额外提供以下参数：

  • fdw_startup_cost

    执行一个外表扫描时的启动耗时估算。这个值通常包含建立连接、远端对请求的分析和生成计划的耗时。默认值为100。取值范围为大于0的实数。

  • fdw_typle_cost

    在远端服务器上对每一个元组进行扫描时的额外消耗。这个值通常表示数据在server间传输的额外消耗。默认值为0.01。取值范围为大于0的实数。

示例

--创建SERVER。
gaussdb=# CREATE SERVER my_server FOREIGN DATA WRAPPER log_fdw;
CREATE SERVER

--删除SERVER。
gaussdb=# DROP SERVER my_server;
DROP SERVER

相关链接

ALTER SERVER，DROP SERVER