Microsoft OLE DB Provider for ODBC

ADO または RDS のプログラマーにとって、すべてのデータ ソースで OLE DB インターフェイスが公開され、ADO でデータ ソースを直接呼び出すことができれば理想的です。OLE DB インターフェイスを実装するデータベース提供者が増えていますが、まだこの方法がとられていないデータ ソースもあります。ただし、現在使用できる実質上のすべての DBMS システムでは、ODBC によるアクセスが可能です。

ODBC ドライバは、Oracle などのMicrosoft 以外のデータベース製品だけでなく、Microsoft® SQL Server™、Microsoft® Access (Microsoft Jet データベース エンジン)、Microsoft® FoxPro® など、現在使用できる主な DBMS のすべてで利用できます。

ただし、この Microsoft ODBC Provider を利用すると、ADO からすべての ODBC データ ソースに接続できます。このプロバイダは、フリースレッドであり、Unicode を使用できます。

このプロバイダは、トランザクションをサポートしています。ただし、DBMS エンジンの種類によって、サポートするトランザクションの種類が異なります。たとえば、Microsoft Access は、5 レベルまでのネストされたトランザクションをサポートします。

このプロバイダは、ADO の既定プロバイダであり、プロバイダに依存するすべての ADO プロパティおよび ADO メソッドをサポートします。

接続文字列パラメータ

このプロバイダに接続するには、ConnectionString プロパティの Provider= 引数を次のように設定します。

MSDASQL

Provider プロパティを取得した場合も、この文字列が返されます。

接続文字列の例

このプロバイダの代表的な接続文字列を次に示します。

"Provider=MSDASQL;DSN=dsnName;UID=userName;PWD=userPassword;"

この接続文字列は、次に示すキーワードで構成されています。

OLE DB Provider for ODBC は ADO の既定プロバイダであり、接続文字列で Provider= パラメータを省略した場合は、このプロバイダへの接続の確立が試行されます。

このプロバイダは、ADO で定義された接続パラメータ以外の独自の接続パラメータはサポートしません。ADO 以外の接続パラメータが指定されている場合は、そのパラメータを ODBC ドライバ マネージャに渡します。

Provider パラメータを省略できるので、同じデータ ソースに対して ODBC 接続文字列とまったく同じ ADO 接続文字列を作成できます。ODBC 接続文字列を作成する場合と同じパラメータ名 (DRIVER=、DATABASE=、DSN= など)、パラメータ値、および構文を使用してください。定義済みのデータ ソース名 (DSN) または FileDSN を指定してもしなくても、接続することができます。

DSN または FileDSN を指定する場合の構文:

"[Provider=MSDASQL;] { DSN=name | FileDSN=filename } ; [DATABASE=database;] UID=user; PWD=password"

DSN を指定しない場合の構文 (DSN なしの接続):

"[Provider=MSDASQL;] DRIVER=driver; SERVER=server; DATABASE=database; UID=user; PWD=password"

DSN または FileDSN を使用する場合は、Windows のコントロール パネルの [ODBC データ ソース アドミニストレータ] で定義しておく必要があります。Microsoft Windows 2000 では、ODBC アドミニストレータは管理ツールに含まれています。以前のバージョンの Windows では、ODBC アドミニストレータのアイコンは [32 ビット ODBC] または [ODBC] という名前で表示されています。

DSN を設定する別の方法として、"SQL Server" などの ODBC ドライバ (DRIVER=)、サーバー名 (SERVER=)、およびデータベース名 (DATABASE=) を指定することもできます。

また、ユーザー アカウント名 (UID=) と、そのユーザー アカウント用のパスワード (PWD=) を、ODBC 用のパラメータ、または ADO で定義されている標準の User ID パラメータと Password パラメータに指定することができます。

DSN の定義にデータベースが指定されている場合でも、DSN に加えて DATABASE パラメータを指定すると、別のデータベースに接続することができます。DSN を使用するときは、必ず DATABASE パラメータを指定することをお勧めします。そうすることで、最後に DSN の定義を確認した後で別のユーザーが既定のデータベースのパラメータを変更している場合でも、目的のデータベースに確実に接続することができます。

プロバイダ固有の接続プロパティ

OLE DB provider for ODBC は、Connection オブジェクトの Properties コレクションに各種のプロパティを追加します。次の表は、このプロバイダに固有のプロパティの一覧です。かっこ内に、対応する OLE DB プロパティ名を示しています。

プロバイダ固有のレコードセットとコマンドのプロパティ

OLE DB Provider for ODBC は、Recordset オブジェクトおよび Command オブジェクトの Properties コレクションに各種のプロパティを追加します。次の表は、このプロバイダに固有のプロパティの一覧です。かっこ内に、対応する OLE DB プロパティ名を示しています。

コマンド テキスト

Command オブジェクトの使用方法は、データ ソース、および受け入れるクエリまたはコマンド ステートメントの種類によって大きく異なります。

ODBC には、ストアド プロシージャを呼び出すための専用の構文があります。Command オブジェクトの CommandText プロパティ、Connection オブジェクトの Execute メソッドの CommandText 引数、または Recordset オブジェクトの Open メソッドの Source 引数の場合は、次の構文で文字列を渡します。

"{ [ ? = ] call procedure [ ( ? [, ? [ , ? ]] ) ] }"

構文中の ? は、Parameters コレクションのオブジェクトを参照します。最初の ? は Parameters(0) を参照し、次の ? は Parameters(1) を参照し、以下同様に続きます。

パラメータの参照は省略可能であり、ストアド プロシージャの構造に依存します。パラメータを定義していないストアド プロシージャを呼び出す場合の構文は、次のようになります。

"{ call procedure }"

2 つのクエリ パラメータを持つ場合は、次のようになります。

"{ call procedure ( ?, ? ) }"

ストアド プロシージャが値を返す場合、戻り値は別のパラメータとして扱われます。クエリ パラメータがなく、戻り値がある場合は、次のようになります。

"{ ? = call procedure }"

戻り値があり、2 つのクエリ パラメータがある場合は、次のようになります。

"{ ? = call procedure ( ?, ? ) }"

Recordset の動作

次の表は、このプロバイダで開いた Recordset オブジェクトで利用可能な標準の ADO メソッドおよび ADO プロパティの一覧です。

プロバイダの設定による Recordset の動作の詳細については、Supports メソッドを実行し、Recordset の Properties コレクションを列挙して、プロバイダ固有のダイナミック プロパティがあるかどうかを確認します。

標準 ADO Recordset プロパティの有用性:

バージョン 1.0 の Microsoft OLE DB Provider for ODBC を ADO で使用する場合は、AbsolutePosition プロパティおよび AbsolutePage プロパティは書き込み専用になります。

標準 ADO Recordset メソッドの有用性:

* Microsoft Access データベースではサポートされていません。

ダイナミック プロパティ

Microsoft OLE DB Provider for ODBC は、開かれていない Connection オブジェクト、Recordset オブジェクト、および Command オブジェクトの Properties コレクションに各種のダイナミック プロパティを追加します。

次の表は、各ダイナミック プロパティの ADO プロパティ名および対応する OLE DB プロパティ名の一覧です。「OLE DB Programmer's Reference」では、「Description」で ADO プロパティ名について触れています。これらのプロパティの詳細については、「OLE DB Programmer's Reference」の「Index」で OLE DB プロパティ名を検索するか、または「Appendix C: OLE DB Properties」を参照してください。

Connection ダイナミック プロパティ

次に示すプロパティが、Connection オブジェクトの Properties コレクションに追加されます。

Recordset ダイナミック プロパティ

次に示すプロパティが、Recordset オブジェクトの Properties コレクションに追加されます。

Command ダイナミック プロパティ

次に示すプロパティが、Command オブジェクトの Properties コレクションに追加されます。

関連項目   Microsoft OLE DB Provider for ODBC の実際の使用方法および機能に関する情報については、Microsoft OLE DB Provider for ODBC のマニュアルおよび MDAC SDK の「Microsoft OLE DB Programmer's Reference」を参照するか、Microsoft Universal Data Access の Web サイトを参照してください。