CREATE FOREIGN TABLE

功能描述

创建外表。

注意事项

• 外表中暂不支持使用系统列（如tableoid，ctid等）。
• 其中Private和Shares模式的外表，需要初始用户和运维模式下（operation_mode）的运维管理员权限。

语法格式

CreateForeignTable ::= CREATE FOREIGN TABLE [ IF NOT EXISTS ] table_name ( [
    column_name type_name [ OPTIONS ( option 'value') ] [ COLLATE collation ] [ column_constraint [ ... ] ]
    [, ... ]
] )
  SERVER server_name
[ OPTIONS ( option 'value' ) ]

这里column_constraint可以是:

column_constraint ::= [ CONSTRAINT constraint_name ]
{ NOT NULL |
  NULL |
  DEFAULT default_expr }

参数说明

• IF NOT EXISTS

  如果已经存在相同名称的表，不会抛出一个错误，而会发出一个通知，告知表关系已存在。

• table_name

  外表的表名。

  取值范围: 字符串，要符合标识符的命名规范。

• column_name

  外表中的字段名。

  取值范围: 字符串，要符合标识符的命名规范。

• type_name

  字段的数据类型。

• SERVER server_name

  外表的server名称。默认值为mot_server。

  如果需要创建Oracle、MySQL、PostgreSQL、File类型的外部表，则需要先手动创建相应的server，创建server的语句参见CREATE SERVER。此处server_name需要跟create server语句中自定义的server_name相同。

• OPTIONS ( option 'value' [, … ] )

  选项与新外部表或外部表中的字段有关。允许的选项名称和值，是由每一个外部数据封装器指定的。 也是通过外部数据封装器的验证函数来验证。重复的选项名称是不被允许的（尽管表选项和表字段选项可以有相同的名字）。

  • oracle_fdw支持的options包括：

    • table

      oracle server侧的表名。需要同oracle系统表中记录的表名完全一致，通常是由大写字符组成。

    • schema

      表所对应的schema（或owner）。需要同oracle系统表中记录的表名完全一致，通常是由大写字符组成。

  • mysql_fdw支持的options包括：

    • dbname

      MySQL的database名称。

    • table_name

      MySQL侧的表名。

  • postgres_fdw支持的options包括：

    • schema_name

      远端server的schema名称。如果不指定的话，将使用外表自身的schema名称作为远端的schema名称。

    • table_name

      远端server的表名。如果不指定的话，将使用外表自身的表名作为远端的表名。

    • column_name

      远端server的表的列名。如果不指定的话，将使用外表自身的列名作为远端的的表的列名。

  • file_fdw支持的options包括：

    • filename

      指定要读取的文件，必需的参数，且必须是一个绝对路径名。

    • format

      远端server的文件格式，支持text/csv/binary/fixed四种格式，和COPY语句的FORMAT选项相同。

    • header

      指定的文件是否有标题行，与COPY语句的HEADER选项相同。

    • delimiter

      指定文件的分隔符，与COPY的DELIMITER选项相同。

    • quote

      指定文件的引用字符，与COPY的QUOTE选项相同。

    • escape

      指定文件的转义字符，与COPY的ESCAPE选项相同。

    • null

      指定文件的null字符串，与COPY的NULL选项相同。

    • encoding

      指定文件的编码，与COPY的ENCODING选项相同。

    • force_not_null

      这是一个布尔选项。如果为真，则声明字段的值不应该匹配空字符串（也就是， 文件级别null选项）。与COPY的 FORCE_NOT_NULL选项里的字段相同。

    说明: 更多使用说明请参见file_fdw、oracle_fdw、mysql_fdw、postgres_fdw。

相关链接

ALTER FOREIGN TABLE，DROP FOREIGN TABLE