CREATE FOREIGN TABLE — 定义一个新的外部表
CREATE FOREIGN TABLE [ IF NOT EXISTS ]table_name( [ {column_namedata_type[ OPTIONS (option'value' [, ... ] ) ] [ COLLATEcollation] [column_constraint[ ... ] ] |table_constraint} [, ... ] ] ) [ INHERITS (parent_table[, ... ] ) ] SERVERserver_name[ OPTIONS (option'value' [, ... ] ) ] CREATE FOREIGN TABLE [ IF NOT EXISTS ]table_namePARTITION OFparent_table[ ( {column_name[ WITH OPTIONS ] [column_constraint[ ... ] ] |table_constraint} [, ... ] ) ] { FOR VALUESpartition_bound_spec| DEFAULT } SERVERserver_name[ OPTIONS (option'value' [, ... ] ) ] wherecolumn_constraintis: [ CONSTRAINTconstraint_name] { NOT NULL | NULL | CHECK (expression) [ NO INHERIT ] | DEFAULTdefault_expr| GENERATED ALWAYS AS (generation_expr) STORED } andtable_constraintis: [ CONSTRAINTconstraint_name] CHECK (expression) [ NO INHERIT ] andpartition_bound_specis: IN (partition_bound_expr[, ...] ) | FROM ( {partition_bound_expr| MINVALUE | MAXVALUE } [, ...] ) TO ( {partition_bound_expr| MINVALUE | MAXVALUE } [, ...] ) | WITH ( MODULUSnumeric_literal, REMAINDERnumeric_literal)
CREATE FOREIGN TABLE 在当前数据库中创建一个新的外部表。该表将归发布该命令的用户所有。
如果给出了模式名称（例如，CREATE FOREIGN TABLE myschema.mytable ...），则该表将在指定的模式中创建。否则，它将在当前模式中创建。外部表的名称必须与同一模式中的任何其他关系（表、序列、索引、视图、物化视图或外部表）的名称不同。
CREATE FOREIGN TABLE 还会自动创建一个数据类型，该数据类型表示与外部表的一行对应的复合类型。因此，外部表不能与同一模式中的任何现有数据类型具有相同的名称。
如果指定了 PARTITION OF 子句，则该表将创建为具有指定边界的 parent_table 的分区。
要创建外部表，您必须拥有外部服务器的 USAGE 权限，以及该表中使用的所有列类型的 USAGE 权限。
IF NOT EXISTS如果具有相同名称的关系已存在，则不抛出错误。在这种情况下会发出通知。请注意，不能保证现有关系与将要创建的关系相似。
table_name要创建的表的名称（可选地带有模式限定符）。
column_name要在新表中创建的列的名称。
data_type列的数据类型。这可以包括数组说明符。有关 PostgreSQL 支持的数据类型的更多信息，请参阅第 8 章。
COLLATE collationCOLLATE 子句将排序规则分配给列（必须是可排序的数据类型）。如果未指定，则使用列数据类型的默认排序规则。
INHERITS ( parent_table [, ... ] )可选的 INHERITS 子句指定一个表列表，新外部表将自动从这些表继承所有列。父表可以是普通表或外部表。有关更多详细信息，请参阅 CREATE TABLE 的类似形式。
PARTITION OF parent_table { FOR VALUES partition_bound_spec | DEFAULT }此形式可用于将外部表创建为给定父表的分区，并带有指定的分区边界值。有关更多详细信息，请参阅 CREATE TABLE 的类似形式。请注意，如果父表上存在 UNIQUE 索引，则目前不允许将外部表创建为父表的分区。（另请参阅 ALTER TABLE ATTACH PARTITION。）
CONSTRAINT constraint_name列或表约束的可选名称。如果违反了约束，则错误消息中会显示约束名称，因此可以使用诸如 col must be positive 之类的约束名称来向客户端应用程序传达有用的约束信息。（需要使用双引号来指定包含空格的约束名称。）如果未指定约束名称，则系统会生成一个名称。
NOT NULL不允许该列包含空值。
NULL允许该列包含空值。这是默认设置。
此子句仅为与非标准 SQL 数据库兼容而提供。不建议在新应用程序中使用它。
CHECK ( expression ) [ NO INHERIT ]CHECK 子句指定一个产生布尔结果的表达式，外部表中的每一行都应满足该表达式；也就是说，对于外部表中的所有行，表达式应生成 TRUE 或 UNKNOWN，而不是 FALSE。指定为列约束的检查约束应仅引用该列的值，而出现在表约束中的表达式可以引用多个列。
目前，CHECK 表达式不能包含子查询，也不能引用当前行以外的变量。可以引用系统列 tableoid，但不能引用任何其他系统列。
标记为 NO INHERIT 的约束不会传播到子表。
DEFAULT default_exprDEFAULT 子句为在其列定义中出现的列分配默认数据值。该值是任何无变量表达式（不允许子查询和对当前表中其他列的交叉引用）。默认表达式的数据类型必须与列的数据类型匹配。
默认表达式将用于任何未为该列指定值的插入操作中。如果某列没有默认值，则默认值为 null。
GENERATED ALWAYS AS ( generation_expr ) STORED此子句将列创建为生成列。该列不能写入，并且在读取时将返回指定表达式的结果。
关键字 STORED 是必需的，表示该列将在写入时计算。（计算值将呈现给外部数据包装器进行存储，并且必须在读取时返回。）
生成表达式可以引用表中的其他列，但不能引用其他生成列。使用的任何函数和运算符必须是不可变的。不允许引用其他表。
server_name要用于外部表的现有外部服务器的名称。有关定义服务器的详细信息，请参阅 CREATE SERVER。
OPTIONS ( option 'value' [, ...] )要与新外部表或其某一列关联的选项。允许的选项名称和值特定于每个外部数据包装器，并使用外部数据包装器的验证器函数进行验证。不允许重复的选项名称（尽管表选项和列选项具有相同的名称是可以的）。
外部表上的约束（例如 CHECK 或 NOT NULL 子句）不由核心 PostgreSQL 系统强制执行，大多数外部数据包装器也不尝试强制执行它们；也就是说，只是假设约束为真。这种强制执行没有什么意义，因为它只适用于通过外部表插入或更新的行，而不适用于通过其他方式修改的行，例如直接在远程服务器上修改的行。相反，附加到外部表的约束应表示远程服务器正在强制执行的约束。
一些特殊用途的外部数据包装器可能是它们访问的数据的唯一访问机制，在这种情况下，外部数据包装器本身执行约束强制可能比较合适。但是，您不应该假设包装器会这样做，除非其文档说明了这一点。
尽管 PostgreSQL 不尝试强制执行外部表上的约束，但为了查询优化的目的，它确实假设它们是正确的。如果外部表中存在不满足声明的约束的可见行，则对表的查询可能会产生错误或不正确的答案。用户有责任确保约束定义与实际情况相符。
当外部表用作分区表的分区时，会有一个隐式约束，即其内容必须满足分区规则。同样，用户有责任确保情况属实，最好的方法是在远程服务器上安装匹配的约束。
在包含外部表分区的分区表中，更改分区键值的 UPDATE 可以导致行从本地分区移动到外部表分区，前提是外部数据包装器支持元组路由。但是，目前不可能将行从外部表分区移动到另一个分区。假设远程服务器正确强制执行分区约束，则由于分区约束，需要执行此操作的 UPDATE 将会失败。
类似的考虑因素适用于生成的列。存储的生成列在本地 PostgreSQL 服务器上插入或更新时计算，并传递给外部数据包装器以写入到外部数据存储，但并不强制执行对外部表的查询返回的值对于与生成表达式一致的存储生成列的值。同样，这可能会导致不正确的查询结果。
创建外部表 films，该表将通过服务器 film_server 访问
CREATE FOREIGN TABLE films (
code char(5) NOT NULL,
title varchar(40) NOT NULL,
did integer NOT NULL,
date_prod date,
kind varchar(10),
len interval hour to minute
)
SERVER film_server;
创建外表 measurement_y2016m07，它将通过服务器 server_07 访问，作为范围分区表 measurement 的一个分区。
CREATE FOREIGN TABLE measurement_y2016m07
PARTITION OF measurement FOR VALUES FROM ('2016-07-01') TO ('2016-08-01')
SERVER server_07;
CREATE FOREIGN TABLE 命令在很大程度上符合SQL标准；然而，与 CREATE TABLE 类似，允许使用 NULL 约束和零列外表。指定列默认值的能力也是 PostgreSQL 的扩展。以 PostgreSQL 定义的形式出现的表继承是非标准的。
如果您在文档中看到任何不正确、与您使用特定功能的经验不符或需要进一步澄清的内容，请使用此表单来报告文档问题。