IMPORT FOREIGN SCHEMA#

Примечание

Эта страница переведена при помощи нейросети GigaChat.

IMPORT FOREIGN SCHEMA - импорт определений таблиц с внешнего сервера.

Синтаксис#

IMPORT FOREIGN SCHEMA remote_schema
    [ { LIMIT TO | EXCEPT } ( table_name [, ...] ) ]
    FROM SERVER server_name
    INTO local_schema
    [ OPTIONS ( option 'value' [, ... ] ) ]

Описание#

IMPORT FOREIGN SCHEMA создает внешние таблицы, представляющие таблицы, существующие на внешнем сервере. Новые внешние таблицы будут принадлежать пользователю, выдавшему команду, и создаются с правильными определениями столбцов и параметрами, соответствующими удаленным таблицам.

По умолчанию импортируются все таблицы и представления, существующие в определенной схеме на внешнем сервере. При необходимости список таблиц можно ограничить до указанной подмножества или исключить определенные таблицы. Все новые внешние таблицы создаются в целевой схеме, которая уже должна существовать.

Чтобы использовать IMPORT FOREIGN SCHEMA, пользователь должен иметь привилегию USAGE на внешнем сервере, а также привилегию CREATE на целевую схему.

Параметры#

remote_schema: Имя удаленной схемы, из которой производится импорт. Конкретное значение и интерпретация удаленной схемы зависят от используемого внешней оболочки данных.
LIMIT TO ( table_name [, ...] ): Импорт только тех иностранных таблиц, которые соответствуют одному из указанных имен таблиц. Другие таблицы, существующие во внешней схеме, будут проигнорированы.
EXCEPT ( table_name [, ...] ): Исключение указанных внешних таблиц из импорта. Все таблицы, существующие во внешней схеме, будут импортированы за исключением тех, которые указаны в параметре.
server_name: Имя внешнего сервера, с которого осуществляется импорт.
local_schema: Схема, в которой будут созданы импортированные внешние таблицы.
OPTIONS ( option 'value' [, ...] ): Дополнительные параметры, используемые во время импорта. Допустимые имена и значения параметров зависят от конкретной внешней оболочки данных.

Примеры#

Импорт определений таблиц из удаленной схемы foreign_films на сервере film_server с созданием сторонних таблиц в локальной схеме films:

IMPORT FOREIGN SCHEMA foreign_films
    FROM SERVER film_server INTO films;

Та же операция, но импортируются только таблицы actors и directors (если они существуют):

IMPORT FOREIGN SCHEMA foreign_films LIMIT TO (actors, directors)
    FROM SERVER film_server INTO films;

Совместимость#

Команда IMPORT FOREIGN SCHEMA соответствует стандарту SQL, за исключением выражения OPTIONS, которое является расширением PostgreSQL.

Смотрите также#

CREATE FOREIGN TABLE, CREATE SERVER