カタログ照会関数
カタログ関数は、異なるオペレーティング・システム上の Db2® サーバーにまたがり、照会を実行し、整合した結果セットを戻すための汎用インターフェースを用意しています。多くの場合、この整合性により、お客様のアプリケーションでのサーバー固有およびリリース固有の カタログ照会を防止できます。
カタログ関数は、概念的には、カタログ表に対して SELECT ステートメントを 実行する SQLExecDirect() 関数に相当します。カタログ関数は、呼び出したときのステートメント・ハンドルを通じて、 標準の結果セットを戻します。 標準の結果セットを使って取り出すのと同じように、SQLFetch() を使用してこの結果セットから個々の行を取り出します。
以下の関数はそれぞれ、カタログを照会し結果セットを戻します。
- SQLColumnPrivileges() - 列特権を取得する
- SQLColumns() - 列情報を取得する
- SQLForeignKeys() - 外部キー列のリストを取得する
- SQLPrimaryKeys() - 表の主キー列を取得する
- SQLProcedureColumns() - プロシージャー入出力パラメーター情報を取得する
- SQLProcedures() - プロシージャー名のリストを取得する
- SQLSpecialColumns() - 特別な (行 ID) 列を取得する
- SQLStatistics() - 基本表の索引および統計情報を取得する
- SQLTablePrivileges() - 表の特権を取得する
- SQLTables() - 表情報を取得する
アプリケーションの移植可能性を向上するには、カタログ関数が生成する結果セットを 処理する場合は、位置によって列を参照してください。 また、追加となる列がアプリケーションに悪影響を与えないような方法で、アプリケーションを作成してください。
Db2 ODBC 初期化ファイルの CURRENTAPPENSCH キーワードは、他のすべての結果セットの場合と同様に、 カタログ照会からの文字データに対するコード化スキームを判別します。
カタログ関数によっては、かなり複雑な照会を実行する場合もあります。 このため、このような関数は、カタログ情報を必要とする場合のみ、呼び出すようにしてください。 カタログ情報を保管しておく方が、カタログ照会を繰り返すよりも優れた方法です。