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。

语法格式

  1. CREATE SERVER server_name
  2.     FOREIGN DATA WRAPPER fdw_name
  3.     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。

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

相关链接

ALTER SERVER，DROP SERVER