更新时间:2023-10-23 GMT+08:00

ALTER FOREIGN TABLE

功能描述

对外表进行修改。

注意事项

OPTIONS中的敏感字段(如passowrd、secret_access_key)在使用多层引号时,语义和不带引号的场景是不同的,因此不会被识别为敏感字段进行脱敏。

语法格式

ALTER FOREIGN TABLE [ IF EXISTS ]  table_name
    OPTIONS ( {[ ADD | SET | DROP ] option ['value']}[, ... ]);

ALTER FOREIGN TABLE [ IF EXISTS ] table_name
    ALTER column_name OPTIONS;

参数说明

  • table_name

    需要修改的外表名称。

    取值范围:已存在的外表名。

  • option

    改变外表或者外表字段的选项。ADD、SET和DROP指定执行的操作。如果没有显式设置,那么默认为ADD。选项的名字不允许重复(尽管表选项和表字段选项可以有相同的名字)。选项的名称和值也会通过外部数据封装器的类库进行校验。

    • 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选项里的字段相同。

  • value

    option的新值。