カタログ照会関数

カタログ関数は、異なるオペレーティング・システム上の Db2® サーバーにまたがり、照会を実行し、整合した結果セットを戻すための汎用インターフェースを用意しています。多くの場合、この整合性により、お客様のアプリケーションでのサーバー固有およびリリース固有の カタログ照会を防止できます。

カタログ関数は、概念的には、カタログ表に対して SELECT ステートメントを 実行する SQLExecDirect() 関数に相当します。カタログ関数は、呼び出したときのステートメント・ハンドルを通じて、 標準の結果セットを戻します。 標準の結果セットを使って取り出すのと同じように、SQLFetch() を使用してこの結果セットから個々の行を取り出します。

以下の関数はそれぞれ、カタログを照会し結果セットを戻します。 これらの関数は、それぞれ、特定の順序に配置された列を持つ結果セットを 戻します。X/Open および ISO 規格の進展に従って列名は変更される可能性がありますが、 これらの列の位置は ODBC ドライバー間では変わりません。 将来のリリースで、これらの結果セットに列が追加される場合は、最後の位置に追加されます。

アプリケーションの移植可能性を向上するには、カタログ関数が生成する結果セットを 処理する場合は、位置によって列を参照してください。 また、追加となる列がアプリケーションに悪影響を与えないような方法で、アプリケーションを作成してください。

Db2 ODBC 初期化ファイルの CURRENTAPPENSCH キーワードは、他のすべての結果セットの場合と同様に、 カタログ照会からの文字データに対するコード化スキームを判別します。

カタログ関数によっては、かなり複雑な照会を実行する場合もあります。 このため、このような関数は、カタログ情報を必要とする場合のみ、呼び出すようにしてください。 カタログ情報を保管しておく方が、カタログ照会を繰り返すよりも優れた方法です。