CREATE FOREIGN TABLE

功能描述

创建外表。

注意事项

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

语法格式

1. CREATE FOREIGN TABLE [ IF NOT EXISTS  ] table_name ( {
2. column_name type_name POSITION ( offset, length ) [column_constraint ]
3. | LIKE source_table | table_constraint } [, ...] )
4. SEVER gsmpp_server
5. OPTIONS (  { option_name ' value '  }  [, ...] )
6. [ { WRITE ONLY  |  READ ONLY  }]
7. [ WITH error_table_name | LOG INTO error_table_name ]
8. [ REMOTE LOG 'name' ]
9. [PER NODE REJECT LIMIT 'value']
10. [ TO { GROUP groupname | NODE ( nodename [, ... ] ) } ];
11. CREATE FOREIGN TABLE [ IF NOT EXISTS ] table_name ( {
12. column_name type_name
13. [ { [CONSTRAINT constraint_name] NULL |
14. [CONSTRAINT constraint_name] NOT NULL |
15. column_constraint [...]} ] |
16. table_constraint} [, ...] )
17. SERVER server_name
18. OPTIONS ( { option_name ' value ' } [, ...] )
19. DISTRIBUTE BY {ROUNDROBIN | REPLICATION}
20. [ TO { GROUP groupname | NODE ( nodename [, ... ] ) } ]
21. [ PARTITION BY ( column_name ) [AUTOMAPPED]] ;
22. CREATE FOREIGN TABLE [ IF NOT EXISTS ] table_name ( [ {
23. column_name type_name | LIKE source_table } [, ...] ] )
24. SERVER server_name
25. OPTIONS ( { option_name ' value ' } [, ...] )
26. [ READ ONLY ]
27. [ DISTRIBUTE BY {ROUNDROBIN} ]
28. [ TO { GROUP groupname | NODE ( nodename [, ... ] ) } ];

30. 这里 column_constraint 可以是:
31. [ CONSTRAINT constraint_name ]
32. { PRIMARY KEY | UNIQUE }
33. [ NOT ENFORCED [ ENABLE QUERY OPTIMIZATION | DISABLE QUERY OPTIMIZATION ] | ENFORCED ]
34. where table_constraint can be:
35. [ CONSTRAINT constraint_name ]
36. { PRIMARY KEY | UNIQUE } ( column_name )
37. [ NOT ENFORCED [ ENABLE QUERY OPTIMIZATION | DISABLE QUERY OPTIMIZATION ] | ENFORCED ]

参数说明

  • 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选项里的字段相同。 > CREATE FOREIGN TABLE - 图1 说明： file_fdw更多使用请参见file_fdw。

相关链接

ALTER FOREIGN TABLE，DROP FOREIGN TABLE