更新时间:2024-06-03 GMT+08:00

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 SERVERDROP SERVER