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