IMPORT FOREIGN SCHEMA
IMPORT FOREIGN SCHEMA — импортировать определения таблиц со стороннего сервера
Синтаксис
IMPORT FOREIGN SCHEMA удаленная_схема
[ { LIMIT TO | EXCEPT } ( имя_таблицы [, ...] ) ]
FROM SERVER имя_сервера
INTO локальная_схема
[ OPTIONS ( параметр 'значение' [, ... ] ) ]
Описание
Команда IMPORT FOREIGN SCHEMA создает сторонние таблицы, которые представляют
таблицы, существующие на стороннем сервере. Новые сторонние таблицы будут
принадлежать пользователю, выполнившему эту команду, и создаются с корректными
определениями столбцов и параметрами, соответствующими удаленным таблицам.
По умолчанию импортируются все таблицы и представления, существующие в определенной схеме на стороннем сервере. При желании список таблиц можно ограничить указанным подмножеством или исключить определенные таблицы. Все новые сторонние таблицы создаются в целевой схеме, которая уже должна существовать.
Чтобы использовать IMPORT FOREIGN SCHEMA, необходимо иметь право USAGE на
стороннем сервере, а также право CREATE в целевой схеме.
Параметры
удаленная_схема
Удаленная схема, предназначенная для импорта из нее. Что именно представляет собой удаленная схема, зависит от применяемой обертки сторонних данных.
LIMIT TO ( имя_таблицы [, ...] )
Импортировать только сторонние таблицы, соответствующие одному из указанных имен таблиц. Другие таблицы, существующие в сторонней схеме, будут игнорироваться.
EXCEPT ( имя_таблицы [, ...] )
Исключить указанные сторонние таблицы из импорта. Все существующие в сторонней схеме таблицы, за исключением перечисленных здесь, будут импортированы.
имя_сервера
Сторонний сервер, предназначенный для импорта из него.
локальная_схема
Схема, в которой будут созданы импортируемые сторонние таблицы.
OPTIONS ( параметр 'значение' [, ...] )
Параметры, которые будут использоваться во время импорта. Допустимые имена и значения параметров являются специфичными для каждой обертки сторонних данных.
Примеры
Импорт определений таблиц из удаленной схемы 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, являющегося расширением QHB.