Microsoft OLE DB Provider for SQL Server 概要

Microsoft OLE DB Provider for SQL Server (SQLOLEDB) を使用すると、ADO で Microsoft SQL Server にアクセスできます。

接続文字列パラメーター

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

SQLOLEDB

Provider プロパティを使って、この値の設定または読み取りを行うこともできます。

一般的な接続文字列

このプロバイダーの一般的な接続文字列は次のとおりです。

"Provider=SQLOLEDB;Data Source=serverName;"
Initial Catalog=databaseName;
User ID=MyUserID;Password=MyPassword;"

この文字列は次のキーワードで構成されます。

プロバイダー固有の接続パラメーター

プロバイダーは、ADO で定義されているものに加えて、プロバイダー固有の接続パラメーターをサポートします。 ADO 接続プロパティと同様に、これらのプロバイダー固有のプロパティは、Connection の Properties コレクションを使用して設定することも、ConnectionString の一部として設定することもできます。

Command オブジェクトの使用

ODBC、ANSI、SQL Server 固有の Transact-SQL が混在する構文を SQLOLEDB で有効な構文として使用できます。 たとえば、次の SQL ステートメントでは、ODBC SQL のエスケープ シーケンスを使用して、LCASE 文字列関数を指定しています。

SELECT customerid={fn LCASE(CustomerID)} FROM Customers

LCASE 関数は、大文字をすべて小文字に変換した文字列を返します。 ANSI SQL の文字列関数 LOWER も同じ操作を実行します。つまり、次の SQL ステートメントは、前述の ODBC ステートメントと同等の ANSI ステートメントです。

SELECT customerid=LOWER(CustomerID) FROM Customers

SQLOLEDB では、どちらの形式のステートメントも、コマンドのテキストとして指定すると正常に処理されます。

ストアド プロシージャ

SQLOLEDB のコマンドを使用して SQL Server ストアド プロシージャを実行するときには、コマンド テキストで ODBC プロシージャ呼び出しエスケープ シーケンスを使用します。 そうすると、SQLOLEDB では、SQL Server のリモート プロシージャ コールのメカニズムを使用して、コマンド処理が最適化されます。 たとえば次のような場合、Transact-SQL ステートメント形式ではなく、ODBC SQL ステートメントをコマンド テキストとして使用することをお勧めします。

ODBC SQL

{call SalesByCategory('Produce', '1995')}

Transact-SQL

EXECUTE SalesByCategory 'Produce', '1995'

SQL Server の機能

SQL Server では、ADO で Command 入力に XML を使用し、Recordset オブジェクトではなく XML ストリーム形式で結果を取得できます。 詳細については、「コマンド入力にストリームを使用する」および「ストリーム形式で結果セットを取得する」を参照してください。

MDAC 2.7、MDAC 2.8、または Windows DAC 6.0 を使用した sql_variant データへのアクセス

Microsoft SQL Server には、sql_variant というデータ型があります。 OLE DB の DBTYPE_VARIANT と同様に、sql_variant データ型には、いくつかの異なる型のデータを格納できます。 ただし、DBTYPE_VARIANT と sql_variant にはいくつかの重要な違いがあります。 また、ADO では、sql_variant 値として格納されたデータが、他のデータ型の処理とは異なる方法で処理されます。 次の一覧で、sql_variant 型の列に格納された SQL Server データにアクセスするときに考慮すべき問題について説明します。

• MDAC 2.7、MDAC 2.8、Windows Data Access Components (Windows DAC) 6.0 の場合は、OLE DB Provider for SQL Server で sql_variant 型がサポートされています。 OLE DB Provider for ODBC では、そうではありません。

• sql_variant 型は、DBTYPE_VARIANT データ型と完全には一致しません。 sql_variant 型では、DBTYPE_VARIANT でサポートされていない GUID、ANSI (非 UNICODE) 文字列、BIGINT などのいくつかの新しいサブタイプがサポートされています。 前述したもの以外のサブタイプを使用しても、正しく機能します。

• sql_variant のサブタイプである NUMERIC は、DBTYPE_DECIMAL とサイズが一致しません。

• 複数のデータ型の強制型変換によって、型が一致しなくなります。 たとえば、GUID というサブタイプを持つ sql_variant を DBTYPE_VARIANT に強制型変換すると、safearray(bytes) というサブタイプになります。 この型を sql_variant に変換すると、array(bytes) という新しいサブタイプになります。

• sql_variant データを含む Recordset フィールドは、リモート処理 (マーシャリング) することができます。または、sql_variant に特定のサブタイプが含まれている場合に限り、永続化することもできます。 次のサポートされていないサブタイプを使用してデータをリモート処理または永続化しようとすると、Microsoft 永続化プロバイダー (MSPersist) から実行時エラー (サポートされていない変換) が発生します: VT_VARIANT、VT_RECORD、VT_ILLEGAL、VT_UNKNOWN、VT_BSTR、VT_DISPATCH。

• MDAC 2.7、MDAC 2.8、Windows DAC 6.0 の OLE DB Provider for SQL Server には、Allow Native Variants (ネイティブ バリアントの許可) という動的プロパティがあります。この名前が示すように、開発者はこれを使用して、DBTYPE_VARIANT ではなくネイティブ形式で sql_variant にアクセスできます。 このプロパティを設定し、クライアント カーソル エンジン (adUseClient) を使用して Recordset を開くと、Recordset.Open 呼び出しは失敗します。 このプロパティを設定し、サーバー カーソル (adUseServer) を使用して Recordset を開くと、Recordset.Open 呼び出しは成功しますが、sql_variant 型の列にアクセスするとエラーが発生します。

• MDAC 2.5 を使用するクライアント アプリケーションでは、sql_variant データを Microsoft SQL Server に対するクエリで使用できます。 ただし、sql_variant データの値は文字列として扱われます。 このようなクライアント アプリケーションは、MDAC 2.7、MDAC 2.8、または Windows DAC 6.0 にアップグレードする必要があります。

レコードセットの動作

SQLOLEDB は、多数のコマンドによって生成される複数の結果をサポートするために SQL Server カーソルを使用することはできません。 SQL Server カーソル サポートを必要とするレコードセットをコンシューマーが要求した場合に、使用されているコマンド テキストが結果として複数のレコードセットを生成すると、エラーが発生します。

スクロール可能な SQLOLEDB レコードセットは、SQL Server カーソルでサポートされています。 SQL Server では、他のデータベース ユーザーの変更によって影響を受けるカーソルに制限が設けらます。 具体的には、一部のカーソル内の行を並べ替えることができないため、SQL ORDER BY 句を含むコマンドを使用してレコードセットを作成しようとすると失敗する可能性があります。

動的プロパティ

Microsoft OLE DB Provider for SQL Server によって、開いていない Connection、Recordset、Command オブジェクトの Properties コレクションにいくつかの動的プロパティが挿入されます。

以下の表は、動的プロパティごとの ADO 名と OLE DB 名の相互インデックスです。 OLE DB プログラマーズ リファレンスでは、ADO プロパティ名が "説明" という用語で参照されています。これらのプロパティの詳細は、OLE DB プログラマーズ リファレンスで確認できます。 インデックスで OLE DB プロパティ名を検索するか、「付録 C: OLE DB プロパティ」を参照してください。

Connection の動的プロパティ

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

Recordset の動的プロパティ

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

Command の動的プロパティ

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

Microsoft SQL Server OLE DB Provider に関する具体的な実装の詳細と機能情報については、「SQL Server プロバイダー」を参照してください。

参照

ConnectionString プロパティ (ADO)Provider プロパティ (ADO)Recordset オブジェクト (ADO)