Foreign Data Wrapper Dialog

目次

Foreign Data Wrapper Dialog#

Foreign Data Wrapper ダイアログを使用して、外部データラッパーを作成または変更します。外部データラッパーは、Postgresデータベースと別のデータソースに保存されているデータ間のアダプターです。

外部データラッパーを作成するには、スーパーユーザーである必要があります。

Foreign Data Wrapper ダイアログは、次のダイアログタブ General 、 Definition 、 Options 、および Security を介して外部データラッパーの開発を編成します。 [ * SQL* ]タブには、ダイアログ選択によって生成されたSQLコードが表示されます。

外部データラッパーダイアログの一般タブ

[ General ]タブのフィールドを使用して、外部データラッパーを識別します。

  • Name フィールドを使用して、外部データラッパーの説明的な名前を追加します。外部データラッパー名はデータベース内で一意である必要があります。名前は pgAdmin ツリーコントロールに表示されます。

  • Owner の横にあるドロップダウンリストボックスを使用して、外部データラッパーを所有するロールの名前を選択します。

  • 外部データラッパーに関するメモを コメント フィールドに保存します。

[ 定義 ]タブをクリックして続行します。

外部データラッパーダイアログ定義タブ

Definition タブのフィールドを使用して、パラメーターを設定します。

  • Select the name of the handler function from the drop-down listbox in the Handler field. This is the name of an existing function that will be called to retrieve the execution functions for foreign tables.

  • Validator フィールドのドロップダウンリストボックスからバリデーターファンクションの名前を選択します。これは、外部データラッパーに指定された汎用オプション、および外部データラッパーを使用する外部サーバー、ユーザーマッピング、および外部テーブルのオプションを確認するために呼び出される既存のファンクションの名前です。

[ オプション ]タブをクリックして続行します。

外部データラッパーダイアログオプションタブ

Options タブのフィールドを使用して、オプションを指定します。

  • Add アイコン+ボタンをクリックして、外部データラッパーのオプションと値のペアを追加します。サポートされるオプション/値のペアは、選択した外部データラッパーに固有です。

  • Option フィールドにオプション名を指定し、 Value フィールドに対応する値を入力します。

Add アイコン+をクリックして、追加の各ペアを指定します。オプションを破棄するには、行の左側にあるゴミ箱アイコンをクリックし、 Delete Row ポップアップで削除を確認します。

[ セキュリティ ]タブをクリックして続行します。

外部データラッパーダイアログのセキュリティタブ

[ セキュリティ ]タブを使用して、セキュリティ特権を割り当てます。 Add アイコン+をクリックして、一連の特権を割り当てます。

  • Grantee フィールドのドロップダウンリストボックスからロールの名前を選択します。

  • Privileges フィールド内をクリックします。 1つ以上の特権の左側のチェックボックスをオンにして、選択した特権を指定したユーザーに付与します。

  • 特権を付与するデフォルトの付与者である現在のユーザーが Grantor フィールドに表示されます。

addをクリックして、追加の特権を割り当てます。特権を破棄するには、行の左側にあるゴミ箱アイコンをクリックし、 Delete Row ポップアップで削除を確認します。

[ * SQL* ]タブをクリックして続行します。

Foreign Data Wrapper ダイアログの入力は、 SQLコマンドを生成します。以下の例を参照してください。確認には * SQL* タブを使用します。再度アクセスするか、タブを切り替えて、 SQLコマンドを変更します。

例#

以下は、 Foreign Data Wrapper ダイアログでのユーザー選択によって生成されたsqlコマンドの例です。

外部データラッパーダイアログSQLタブ

この例では、既存のバリデーターおよびハンドラーファンクション dblink_fdw_validator および libpg_fdw_handler を使用する lib_qp_debug という名前の外部データラッパーを作成します。 [ Options ]タブの選択により、 debug が true に等しく設定されます。 外部データラッパーは、 postgres が所有しています。

  • Click the Help button (?) to access online help.

  • Save ボタンをクリックして、作業を保存します。

  • Click the Close button to exit without saving work.

  • Reset ボタンをクリックして、構成パラメーターを復元します。