環境属性、接続属性、およびステートメント属性の設定と取り出しのための関数

Db2® ODBC では、環境属性、接続属性、およびステートメント属性のサブセットの設定と取り出しを行う関数を提供します。

環境、接続、およびステートメントにはそれぞれ、定義された 1 セットの属性 (またはオプション) があります。 これらの属性はすべて照会可能ですが、この属性値をデフォルト値から変更できるのは、そのうちの 一部に限られます。 属性値を変更すると、Db2 ODBC の動作が変わります。

変更可能な属性については、下記にリストされる属性設定関数の詳細説明に一覧表を記載してあります。
  • SQLSetEnvAttr() - 環境属性を設定する
  • SQLSetConnectAttr() - 接続属性を設定する
  • SQLSetStmtAttr() - ステートメント属性を設定する
  • SQLSetColAttr() - 列属性を設定する

読み取り専用属性 (存在する場合) については、属性取得関数の詳細説明と一緒に一覧表を記載してあります。

通常は、デフォルトの属性設定値を使用してアプリケーションを作成しますが、アプリケーションの特定のユーザーにとってはこのようなデフォルトは必ずしも適切とは限りま せん。Db2 ODBC では 2 つのポイントを提供して、アプリケーションのユーザーが実行時に属性のデフォルト値を変更 できるようにしています。SQLDriverConnect() 接続ストリングを使用するインターフェースで 属性値を指定するか、もしくは Db2 ODBC 初期化ファイルで属性値を指定できます。

Db2 ODBC 初期化ファイルには、Db2 ODBC アプリケーションすべてについて デフォルト属性値が指定されています。アプリケーションが SQLDriverConnect() 接続ストリングに対するインターフェースをユーザーに提供していない場合は、ユーザーは初期化ファイルを通じてのみ、 デフォルトの属性値を変更することができます。SQLDriverConnect() で指定された属性値は、Db2 ODBC 初期化 ファイルで設定されている値を、どの特定接続に対してもオーバーライドします。

重要: 初期化ファイルおよび接続ストリングは、ユーザーによる チューニングを意図したものです。 アプリケーション開発者は、適切な属性設定関数を使用して属性値を変更してください。 属性設定関数を使用して属性値を設定すると、初期化ファイルの値、およびその属性用 の SQLDriverConnect() 接続ストリング値が、指定したその値によりオーバーライドされます。

次の図は、基本接続シナリオ内での属性値の設定と取り出し方法を示しています。

図 1. 属性の設定と取り出し
図の要約の開始 この図は、基本接続シナリオで使用される関数を表したフローチャートです。
詳細な説明が可能