CREATE SERVER

功能描述

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

注意事项

• 本章节只包含dolphin新增的语法，原openGauss的语法未做删除和修改。
• 相比于原始的openGauss，dolphin对于CREATE SERVER语法的修改主要为：
  1. 新增fdw_name可选值mysql，其功能与mysql_fdw一致。
  2. 对于fdw_name为mysql_fdw时，增加可选OPTIONS：DATABASE, USER, PASSWORD, SOCKET, OWNER。

语法格式

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

参数说明

• fdw_name

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

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

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

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

  • mysql_fdw支持的options包括：

    • host （默认值为 127.0.0.1）

      MySQL Server/MariaDB的地址。

    • port （默认值为 3306）

      MySQL Server/MariaDB侦听的端口号。

    • user （默认为空）

      MySQL Server/MariaDB用于连接的用户名。若OPTIONS指定此选项，openGauss将自动创建当前用户到新建server的用户映射。

    • password （默认为空）

      MySQL Server/MariaDB用于连接的用户密码。若OPTIONS指定此选项，openGauss将自动创建当前用户到新建server的用户映射。

    • database （默认为空）

      无实际意义，仅做语法兼容。指定MySQL Server/MariaDB连接的数据库请在CREATE FOREIGN TABLE或ALTER FOREIGN TABLE中完成。

    • owner （默认为空）

      无实际意义，仅做语法兼容。

    • socket （默认为空）

      无实际意义，仅做语法兼容。

示例

创建server。

openGauss=# create server server_test foreign data wrapper mysql options(host '192.108.0.1', port '3306', user 'foreign_server_test',
password 'password@123', database 'my_db', owner 'test_user');
WARNING:  Option database will be deprecated for CREATE SERVER.
WARNING:  Option owner will be deprecated for CREATE SERVER.
WARNING:  USER MAPPING for current user to server server_test created.
CREATE SERVER

相关链接

ALTER SERVER，DROP SERVER