IMPORT FOREIGN SCHEMA

PostgreSQL 17.0文書
		SQLコマンド	誤訳等の報告
前へ	上へ	IMPORT FOREIGN SCHEMA	次へ

IMPORT FOREIGN SCHEMA <refpurpose>import table definitions from a foreign server</refpurpose> — 外部サーバからテーブル定義をインポートする

概要

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

説明

<title>Description</title>

<command>IMPORT FOREIGN SCHEMA</command> creates foreign tables that represent tables existing on a foreign server. The new foreign tables will be owned by the user issuing the command and are created with the correct column definitions and options to match the remote tables. IMPORT FOREIGN SCHEMAは外部サーバ上に存在するテーブルを表す外部テーブルを作成します。新しい外部テーブルは、コマンドを実行するユーザに所有され、リモートのテーブルにマッチする正しい列定義とオプションで作成されます。

By default, all tables and views existing in a particular schema on the foreign server are imported. Optionally, the list of tables can be limited to a specified subset, or specific tables can be excluded. The new foreign tables are all created in the target schema, which must already exist. デフォルトでは、外部サーバ上の特定のスキーマ内に存在するすべてのテーブルとビューがインポートされます。オプションで、インポートするテーブルを指定した部分集合に制限したり、特定のテーブルを除外することができます。新しい外部テーブルは、すべてターゲットとなるスキーマ内に作成され、そのスキーマは既存である必要があります。

To use <command>IMPORT FOREIGN SCHEMA</command>, the user must have <literal>USAGE</literal> privilege on the foreign server, as well as <literal>CREATE</literal> privilege on the target schema. IMPORT FOREIGN SCHEMAを使用するには、外部サーバのUSAGE権限、およびターゲットとなるスキーマのCREATE権限が必要です。

パラメータ

<title>Parameters</title>

remote_schema: The remote schema to import from. The specific meaning of a remote schema depends on the foreign data wrapper in use. インポート元となるリモートのスキーマです。リモートのスキーマの具体的な意味は、使用する外部データラッパーに依存します。
LIMIT TO ( table_name [, ...] ): Import only foreign tables matching one of the given table names. Other tables existing in the foreign schema will be ignored. 指定したテーブル名の1つにマッチする外部テーブルだけをインポートします。外部スキーマ内に存在する他のテーブルは無視されます。
EXCEPT ( table_name [, ...] ): Exclude specified foreign tables from the import. All tables existing in the foreign schema will be imported except the ones listed here. 指定した外部テーブルをインポートから除外します。ここに列挙したものを除き、外部スキーマ内に存在するすべてのテーブルがインポートされます。
server_name: The foreign server to import from. インポート元となる外部サーバです。
local_schema: The schema in which the imported foreign tables will be created. インポートされた外部テーブルが作成されるスキーマです。
OPTIONS ( option 'value' [, ...] ): Options to be used during the import. The allowed option names and values are specific to each foreign data wrapper. インポート時に使用されるオプションです。使用できるオプションの名前と値は、各外部データラッパーに依存します。

例

<title>Examples</title>

Import table definitions from a remote schema <structname>foreign_films</structname> on server <structname>film_server</structname>, creating the foreign tables in local schema <structname>films</structname>: サーバfilm_server上のリモートのスキーマforeign_filmsからテーブルの定義をインポートし、ローカルのスキーマfilms内に外部テーブルを作成します。

IMPORT FOREIGN SCHEMA foreign_films
    FROM SERVER film_server INTO films;

As above, but import only the two tables <structname>actors</structname> and <literal>directors</literal> (if they exist): 上と同様ですが、2つのテーブルactorsとdirectorsだけを（それらが存在するなら）インポートします。

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

互換性

<title>Compatibility</title>

The <command>IMPORT FOREIGN SCHEMA</command> command conforms to the <acronym>SQL</acronym> standard, except that the <literal>OPTIONS</literal> clause is a <productname>PostgreSQL</productname> extension. IMPORT FOREIGN SCHEMAコマンドは、OPTIONS句がPostgreSQLの拡張であるという点を除き、標準SQLに準拠しています。

IMPORT FOREIGN SCHEMA

概要

説明

パラメータ

例

互換性

関連項目