無料スクリプト配布のPHP.TO   PHPの実用的なtips PHPマニュアル MySQLマニュアル Apacheマニュアル PostgreSQLマニュアル マニュアル検索    

52.3. 外部データラッパヘルパ関数

FDWオプションのようなFDW関連オブジェクトの属性に外部データラッパの作者が簡単にアクセスできるように、いくつかのヘルパ関数がコアサーバからエクスポートされています。 これらの関数を使用するには、ヘッダファイル foreign/foreign.h をあなたのソースファイルにインクルードする必要があります。 このヘッダはまたこれらの関数が返す構造体も定義しています。

ForeignDataWrapper *
GetForeignDataWrapper(Oid fdwid);

この関数は指定されたOIDを持つ外部データラッパの ForeignDataWrapper オブジェクトを返します。 ForeignDataWrapper オブジェクトはFDWのプロパティを含みます(詳細は foreign/foreign.h を参照して下さい)。

ForeignServer *
GetForeignServer(Oid serverid);

この関数は指定されたOIDを持つ外部サーバの ForeignServer オブジェクトを返します。 ForeignServer オブジェクトは外部サーバのプロパティを含みます(詳細は foreign/foreign.h を参照して下さい)。

UserMapping *
GetUserMapping(Oid userid, Oid serverid);

この関数は指定されたロールと指定された外部サーバのユーザマッピングの UserMapping オブジェクトを返します。(もし特定のユーザのマッピングがない場合は、 PUBLIC のためのマッピングを返すか、それもなければエラーを発生させます。) UserMapping オブジェクトはユーザマッピングのプロパティを含みます(詳細は foreign/foreign.h を参照して下さい)。

ForeignTable *
GetForeignTable(Oid relid);

この関数は指定されたOIDを持つ外部テーブルの ForeignTable オブジェクトを返します。 ForeignTable オブジェクトは外部テーブルのプロパティを含みます(詳細は foreign/foreign.h を参照して下さい)。

List *
GetForeignColumnOptions(Oid relid, AttrNumber attnum);

この関数は指定された外部テーブルOIDと属性番号に該当する列の列単位のFDWオプションを DefElem のリスト形式で返します。その列がオプションを持たない場合はNILが返ります。

いくつかのオブジェクト種別については、OIDベースのものに加えて名前ベースの検索関数もあります。

ForeignDataWrapper *
GetForeignDataWrapperByName(const char *name, bool missing_ok);

この関数は指定された名前の外部データラッパの ForeignDataWrapper オブジェクトを返します。外部データラッパが見つからない場合は、missing_okがtrueの場合はNULLを返し、それ以外の場合はエラーを発生させます。

ForeignServer *
GetForeignServerByName(const char *name, bool missing_ok);

この関数は指定された名前の外部サーバの ForeignServer オブジェクトを返します。外部サーバが見つからない場合は、missing_okがtrueの場合はNULLを返し、それ以外の場合はエラーを発生させます。


powered by SEO.CUG.NET