diff --git a/doc/src/sgml/ref/create_external_table.sgml b/doc/src/sgml/ref/create_external_table.sgml index 04746843c8187fdd8edf0981c516e804593ae69c..174e1b0f4956d6d60a60f6a29754d62d5965709f 100755 --- a/doc/src/sgml/ref/create_external_table.sgml +++ b/doc/src/sgml/ref/create_external_table.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -CREATE [READABLE] EXTERNAL TABLE table_name +CREATE [READABLE] EXTERNAL [TEMPORARY | TEMP] TABLE table_name ( column_name data_type [, ...] | LIKE other_table ) LOCATION ('file://seghost[:port]/path/file' [, ...]) | ('gpfdist://filehost[:port]/file_pattern[#transform]' @@ -48,7 +48,7 @@ CREATE [READABLE] EXTERNAL TABLE table_name [ ENCODING 'encoding' ] [ [LOG ERRORS] SEGMENT REJECT LIMIT count [ROWS | PERCENT] ] -CREATE [READABLE] EXTERNAL WEB TABLE table_name +CREATE [READABLE] EXTERNAL WEB [TEMPORARY | TEMP] TABLE table_name ( column_name data_type [, ...] | LIKE other_table ) LOCATION ('http://webhost[:port]/path/file' [, ...]) | EXECUTE 'command' [ON ALL @@ -76,7 +76,7 @@ CREATE [READABLE] EXTERNAL WEB TABLE table_name [ ENCODING 'encoding' ] [ [LOG ERRORS] SEGMENT REJECT LIMIT count [ROWS | PERCENT] ] -CREATE WRITABLE EXTERNAL TABLE table_name +CREATE WRITABLE EXTERNAL [TEMPORARY | TEMP] TABLE table_name ( column_name data_type [, ...] | LIKE other_table ) LOCATION('gpfdist://outputhost[:port]/filename[#transform]' | ('gpfdists://outputhost[:port]/file_pattern[#transform]' @@ -95,7 +95,7 @@ CREATE WRITABLE EXTERNAL TABLE table_name | 'CUSTOM' (Formatter=) [ ENCODING 'write_encoding' ] [ DISTRIBUTED BY (column, [ ... ] ) | DISTRIBUTED RANDOMLY ] -CREATE WRITABLE EXTERNAL WEB TABLE table_name +CREATE WRITABLE EXTERNAL WEB [TEMPORARY | TEMP] TABLE table_name ( column_name data_type [, ...] | LIKE other_table ) EXECUTE 'command' [ON ALL] FORMAT 'TEXT' diff --git a/gpdb-doc/dita/ref_guide/sql_commands/CREATE_EXTERNAL_TABLE.xml b/gpdb-doc/dita/ref_guide/sql_commands/CREATE_EXTERNAL_TABLE.xml index 7f57b1a6816eeff152240229e45b48e4eec572b1..6617e476fda4bd288a5e5c0dbdb86e2e4e51bf99 100644 --- a/gpdb-doc/dita/ref_guide/sql_commands/CREATE_EXTERNAL_TABLE.xml +++ b/gpdb-doc/dita/ref_guide/sql_commands/CREATE_EXTERNAL_TABLE.xml @@ -7,7 +7,7 @@

Defines a new external table.

Synopsis - CREATE [READABLE] EXTERNAL TABLE table_name      + CREATE [READABLE] EXTERNAL [TEMPORARY | TEMP] TABLE table_name      ( column_name data_type [, ...] | LIKE other_table )      LOCATION ('file://seghost[:port]/path/file' [, ...])        | ('gpfdist://filehost[:port]/file_pattern[#transform=trans_name]' @@ -41,7 +41,7 @@     [ [LOG ERRORS] SEGMENT REJECT LIMIT count       [ROWS | PERCENT] ] -CREATE [READABLE] EXTERNAL WEB TABLE table_name      +CREATE [READABLE] EXTERNAL WEB [TEMPORARY | TEMP] TABLE table_name      ( column_name data_type [, ...] | LIKE other_table )       LOCATION ('http://webhost[:port]/path/file' [, ...])     | EXECUTE 'command' [ON ALL @@ -70,7 +70,7 @@ CREATE [READABLE] EXTERNAL WEB TABLE table_name          [ [LOG ERRORS] SEGMENT REJECT LIMIT count        [ROWS | PERCENT] ] -CREATE WRITABLE EXTERNAL TABLE table_name +CREATE WRITABLE EXTERNAL [TEMPORARY | TEMP] TABLE table_name     ( column_name data_type [, ...] | LIKE other_table )      LOCATION('gpfdist://outputhost[:port]/filename[#transform=trans_name]'           [, ...]) @@ -94,7 +94,7 @@ CREATE WRITABLE EXTERNAL TABLE table_name     [ ENCODING 'write_encoding' ]     [ DISTRIBUTED BY (column, [ ... ] ) | DISTRIBUTED RANDOMLY ] -CREATE WRITABLE EXTERNAL TABLE table_name +CREATE WRITABLE EXTERNAL [TEMPORARY | TEMP] TABLE table_name     ( column_name data_type [, ...] | LIKE other_table )      LOCATION('s3://S3_endpoint[:port]/bucket_name/[S3_prefix] [region=S3-region] [config=config_file]')       [ON MASTER] @@ -109,7 +109,7 @@ CREATE WRITABLE EXTERNAL TABLE table_name                [FORCE QUOTE column [, ...]] ]                [ESCAPE [AS] 'escape'] )] -CREATE WRITABLE EXTERNAL WEB TABLE table_name +CREATE WRITABLE EXTERNAL WEB [TEMPORARY | TEMP] TABLE table_name     ( column_name data_type [, ...] | LIKE other_table )     EXECUTE 'command' [ON ALL]     FORMAT 'TEXT' @@ -174,6 +174,16 @@ CREATE WRITABLE EXTERNAL WEB TABLE table_name however, create an external web table that executes a third-party tool to read data from or write data to S3 directly. + + TEMPORARY | TEMP + If specified, creates a temporary readable or writable external table definition + in Greenplum Database. Temporary external tables exist in a special schema; you cannot + specify a schema name when you create the table. Temporary external tables are + automatically dropped at the end of a session. + An existing permanent table with the same name is not visible to the current session + while the temporary table exists, unless you reference the permanent table with its + schema-qualified name. + table_name