次の方法で共有


SQL Server Native Client と ADO の併用

適用対象: SQL Server Azure SQL データベース Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

重要

SQL Server Native Client (SNAC) は同梱されていません。

  • SQL Server 2022 (16.x) 以降のバージョン
  • SQL Server Management Studio 19 以降のバージョン

SQL Server Native Client (SQLNCLI または SQLNCLI11) と従来の Microsoft OLE DB Provider for SQL Server (SQLOLEDB) は、新しいアプリケーション開発には推奨されません。

新しいプロジェクトの場合は、次のいずれかのドライバーを使用します。

SQL Server データベース エンジン (バージョン 2012 から 2019) のコンポーネントとして付属する SQLNCLI については、この「サポート ライフサイクルの例外」を参照してください。

複数のアクティブな結果セット (MARS)、クエリ通知、ユーザー定義型 (UDT)、新しい xml データ型など、SQL Server 2005 (9.x) で導入された新機能を利用するには、ActiveX データ オブジェクト (ADO) を使用する既存のアプリケーションで、データ アクセス プロバイダーとして SQL Server Native Client OLE DB プロバイダーを使用する必要があります。

SQL Server 2005 (9.x) で導入された新機能を使用する必要がない場合は、SQL Server Native Client OLE DB プロバイダーを使用する必要はありません。現在のデータ アクセス プロバイダー (通常は SQLOLEDB) を引き続き使用できます。 既存のアプリケーションを拡張していて、SQL Server 2005 (9.x) で導入された新機能を使用する必要がある場合は、SQL Server Native Client OLE DB プロバイダーを使用する必要があります。

Note

新しいアプリケーションを開発する場合は、SQL Server Native Client ではなく ADO.NET と .NET Framework Data Provider for SQL Server を使用して、最新バージョンの SQL Server のすべての新機能にアクセスすることを検討することをお勧めします。 .NET Framework Data Provider for SQL Server の詳細については、ADO.NET の .NET Framework SDK ドキュメントを参照してください。

ADO で最新バージョンの SQL Server の新機能を使用できるようにするために、OLE DB のコア機能を拡張する SQL Server Native Client OLE DB プロバイダーにいくつかの機能強化が行われています。 ADO アプリケーションはこのような機能強化により、SQL Server の新しい機能、および SQL Server 2005 (9.x) で導入された 2 つのデータ型 (xmludt) を使用できるようになります。 また、この機能強化では、varcharnvarcharvarbinary の各データ型に対する機能も強化されています。 SQL Server Native Client は、新しいデータ型が ADO と互換性のある方法で公開されるように、ADO アプリケーションで使用するためにDBPROPSET_SQLSERVERDBINIT プロパティ セットにSSPROP_INIT_DATATYPECOMPATIBILITY初期化プロパティを追加します。 さらに、SQL Server Native Client OLE DB プロバイダーでは、接続文字列で設定DataTypeCompatibility という名前の新しい接続文字列 キーワードも定義されます。

Note

既存の ADO アプリケーションは、SQLOLEDB プロバイダーを使用して、XML、UDT、および大きな値のテキストやバイナリのフィールド値にアクセスして更新できます。 サイズの大きな値をとる新しいデータ型 varchar(max)nvarchar(max)varbinary(max) はそれぞれ、adLongVarCharadLongVarWCharadLongVarBinary という ADO 型として返されます。 XML 列は adLongVarChar として返され、UDT 列は adVarBinary として返されます。 ただし、SQLOLEDB ではなく SQL Server Native Client OLE DB プロバイダー (SQLNCLI11) を使用する場合は、新しいデータ型が ADO データ型に正しくマップされるように、 DataTypeCompatibility キーワードを "80" に設定する必要があります。

ADO からの SQL Server Native Client の有効化

SQL Server Native Client の使用を有効にするには、ADO アプリケーションで次のキーワードを接続文字列に実装する必要があります。

  • Provider=SQLNCLI11

  • DataTypeCompatibility=80

SQL Server Native Client でサポートされている ADO 接続文字列キーワードの詳細については、「 SQL Server Native Client での接続文字列キーワードの使用を参照してください。

次に示す例は、SQL Server Native Client で完全に有効になっている ADO 接続文字列を確立する例です。MARS 機能の有効化も含まれます。

Dim con As New ADODB.Connection  
  
con.ConnectionString = "Provider=SQLNCLI11;" _  
         & "Server=(local);" _  
         & "Database=AdventureWorks;" _   
         & "Integrated Security=SSPI;" _  
         & "DataTypeCompatibility=80;" _  
         & "MARS Connection=True;"  
con.Open  

次のセクションでは、SQL Server Native Client OLE DB プロバイダーで ADO を使用する方法の例を示します。

XML 列データの取得

この例では、レコードセットを使用し、SQL Server AdventureWorks サンプル データベースの XML 列からデータを取得および表示します。

Dim con As New ADODB.Connection  
Dim rst As New ADODB.Recordset  
Dim sXMLResult As String  
  
con.ConnectionString = "Provider=SQLNCLI11;" _  
         & "Server=(local);" _  
         & "Database=AdventureWorks;" _   
         & "Integrated Security=SSPI;" _   
         & "DataTypeCompatibility=80;"  
  
con.Open  
  
' Get the xml data as a recordset.  
Set rst.ActiveConnection = con  
rst.Source = "SELECT AdditionalContactInfo FROM Person.Contact " _  
   & "WHERE AdditionalContactInfo IS NOT NULL"  
rst.Open  
  
' Display the data in the recordset.  
While (Not rst.EOF)  
   sXMLResult = rst.Fields("AdditionalContactInfo").Value  
   Debug.Print (sXMLResult)  
   rst.MoveNext  
End While  
  
con.Close  
Set con = Nothing  

Note

レコードセットのフィルター選択は、XML 列でサポートされません。 これを使用すると、エラーが返されます。

UDT 列データの取得

この例では、Command オブジェクトを使用して、UDT を返す SQL クエリを実行します。その後、UDT データを更新し、新しいデータをデータベースに挿入します。 ここでは、Point UDT が既にデータベースに登録されていることを前提としています。

Dim con As New ADODB.Connection  
Dim cmd As New ADODB.Command  
Dim rst As New ADODB.Recordset  
Dim strOldUDT As String  
Dim strNewUDT As String  
Dim aryTempUDT() As String  
Dim strTempID As String  
Dim i As Integer  
  
con.ConnectionString = "Provider=SQLNCLI11;" _  
         & "Server=(local);" _  
         & "Database=AdventureWorks;" _   
         & "Integrated Security=SSPI;" _  
         & "DataTypeCompatibility=80;"  
  
con.Open  
  
' Get the UDT value.  
Set cmd.ActiveConnection = con  
cmd.CommandText = "SELECT ID, Pnt FROM dbo.Points.ToString()"  
Set rst = cmd.Execute  
strTempID = rst.Fields(0).Value  
strOldUDT = rst.Fields(1).Value  
  
' Do something with the UDT by adding i to each point.  
arytempUDT = Split(strOldUDT, ",")  
i = 3  
strNewUDT = LTrim(Str(Int(aryTempUDT(0)) + i)) + "," + _  
   LTrim(Str(Int(aryTempUDT(1)) + i))  
  
' Insert the new value back into the database.  
cmd.CommandText = "UPDATE dbo.Points SET Pnt = '" + strNewUDT + _  
   "' WHERE ID = '" + strTempID + "'"  
cmd.Execute  
  
con.Close  
Set con = Nothing  

MARS の有効化と使用

この例では、SQL Server Native Client OLE DB プロバイダーを介して MARS を有効にするために接続文字列を構築し、同じ接続を使用して実行する 2 つのレコードセット オブジェクトを作成します。

Dim con As New ADODB.Connection  
  
con.ConnectionString = "Provider=SQLNCLI11;" _  
         & "Server=(local);" _  
         & "Database=AdventureWorks;" _   
         & "Integrated Security=SSPI;" _  
         & "DataTypeCompatibility=80;" _  
         & "MARS Connection=True;"  
con.Open  
  
Dim recordset1 As New ADODB.Recordset  
Dim recordset2 As New ADODB.Recordset  
  
Dim recordsaffected As Integer  
Set recordset1 =  con.Execute("SELECT * FROM Table1", recordsaffected, adCmdText)  
Set recordset2 =  con.Execute("SELECT * FROM Table2", recordsaffected, adCmdText)  
  
con.Close  
Set con = Nothing  

以前のバージョンの OLE DB プロバイダーでは、アクティブな結果セットを 1 つの接続ごとに 1 つしか開くことができなかったので、このコードにより 2 回目の実行時に暗黙の接続が作成されました。 暗黙の接続が OLE DB 接続プールにプールされなかったので、これが原因でオーバーヘッドが増加することになります。 SQL Server Native Client OLE DB プロバイダーによって公開されている MARS 機能を使用すると、1 つの接続で複数のアクティブな結果が得られます。

参照

SQL Server Native Client を使用したアプリケーションのビルド