環境、接続、およびステートメント属性

  • [アーティクル]

ODBC では、環境、接続、またはステートメントに関連付けられているさまざまな属性を定義します。

環境属性は、接続プールが有効になっているかどうかなど、環境全体に影響します。 環境属性は SQLSetEnvAttr で設定され、SQLGetEnvAttr で取得されます。

接続属性は、ドライバーがデータ ソースに接続してからタイムアウトするまで待機する必要がある時間など、各接続に個別に影響します。接続属性は SQLSetConnectAttr で設定され、SQLGetConnectAttr で取得されます。 接続属性の詳細については、「 接続属性」を参照してください。

ステートメント属性は、ステートメントを非同期に実行する必要があるかどうかなど、各ステートメントに個別に影響します。 ステートメント属性は SQLSetStmtAttr で設定し、 SQLGetStmtAttr で取得します。 いくつかのステートメント属性は読み取り専用属性であり、設定できません。 たとえば、カーソル内の現在の行の数を取得するために使用される SQL_ATTR_ROW_NUMBER ステートメント属性は読み取り専用です。 ステートメントの属性を使用する方法の詳細については、「ステートメントの属性」を参照してください。

ODBC で定義された属性に加えて、ドライバーは独自の接続属性とステートメント属性を定義できます。 2 つのドライバー ベンダーが異なる独自の属性に同じ整数値を割り当てないように、ドライバー定義の属性を Open Group に登録する必要があります。 詳細については、「ドライバー固有のデータ型、記述子の種類、情報の種類、診断型、および属性」を参照してください。

属性の完全な一覧については、「SQLSetEnvAttr」、「SQLSetConnectAttr」、「SQLSetStmtAttr」を参照してください。 ほとんどの属性は、影響を受ける ODBC 関数の説明でも説明されています。