共通 SQL API ストアード・プロシージャー

共通 SQL API ストアード・プロシージャーは、クロス・データベースおよびクロス・オペレーティング・システムの SQL API を実装します。この SQL API は、IBM® データ・サーバー (Db2® for Linux, UNIX, and Windows など) 間で移植可能です。

共通 SQL API は、IBM データ・サーバー間の共通ツール機能をサポートするソリューション・レベルの API です。 この共通 SQL API により、データ・サーバーのアップグレード時にツールの機能は停止せず、データベース・サーバーの新機能を利用するツール機能のアップグレードが使用可能になった時点で、呼び出し元に通知が送信されます。 複数の IBM データ・サーバーに対応するアプリケーションでは、 共通 SQL API を使用すると実装の複雑さが軽減されるため、共通 SQL API を使用することでメリットを享受できます。このようなアプリケーションは通常、さまざまな共通管理機能を実行します。例えば、これらのストアード・プロシージャーを使用してデータ・サーバー構成情報を取得し、データ・サーバーに関するシステム情報を戻し、SQLCODE の短いメッセージ・テキストを戻すことができます。

共通 SQL API には、Db2 で提供されている以下のストアード・プロシージャーが含まれています。

これらのストアード・プロシージャーは、安定バージョンの XML 文書をパラメーターとして使用します。 これらの XML パラメーター文書は、1 つの共通文書型定義 (DTD) に準拠しています。この DTD は、階層構造とバイナリー・データを表現できる十分な柔軟性を備えています。XML パラメーター文書の解析には、Apache Commons Configuration コンポーネントが使用されます。

3 つの各 XML パラメーター文書にはそれぞれ名前とバージョンが設定されており、一般に 1 つのストアード・プロシージャーが関連付けられています。この 3 種類の XML パラメーター文書を以下に示します。
  • XML 入力文書
  • XML 出力文書
  • XML メッセージ文書
XML 入力文書は、ストアード・プロシージャーへの入力として渡されます。 XML 出力文書は出力として戻され、XML メッセージ文書はメッセージを戻します。XML パラメーター文書の構造、属性、またはタイプが変更されると、XML パラメーター文書のバージョンが変更されます。3 つのすべての文書のバージョンは、ストアード・プロシージャーの呼び出し時には同期した状態になります。例えば、 GET_SYSTEM_INFO ストアード・プロシージャーを呼び出し、major_version パラメーターに 1 を指定し、minor_version パラメーターに 1 を指定すると、 XML 入力文書、XML 出力文書、および XML メッセージ文書のバージョンは 1.1 になります。