CREATE FOREIGN TABLE

功能描述

创建外表。

注意事项

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

语法格式

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 可以是:
[ CONSTRAINT constraint_name ]
{ NOT NULL |
  NULL |
  DEFAULT default_expr }

参数说明

  • IF NOT EXISTS

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

  • table_name

    外表的表名。

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

  • column_name

    外表中的字段名。

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

  • type_name

    字段的数据类型。

  • SERVER server_name

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

  • 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更多使用请参见file_fdw

相关链接

ALTER FOREIGN TABLEDROP FOREIGN TABLE

意见反馈
编组 3备份
openGauss 2024-03-19 00:48:12
取消