SQL Server Native Client での非同期操作の実行

[アーティクル]
01/10/2024

適用対象: 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 については、この「サポートライフサイクルの例外」を参照してください。

SQL Server では、アプリケーションは非同期のデータベース操作を実行できます。非同期処理により、呼び出し側のスレッドをブロックしないで直ちに制御を返すことができるようになります。これは、マルチスレッドの持つ能力と柔軟性を大きく引き出し、開発者が明示的にスレッドを作成したり、同期を処理する手間を省くことができる機能です。アプリケーションは、データベース接続を初期化するときや、コマンドの実行結果を初期化するときに、非同期処理を要求します。

データベース接続の開閉

SQL Server Native Client OLE DB プロバイダーを使用する場合、データソースオブジェクトを非同期的に初期化するように設計されたアプリケーションでは、 IDBInitialize::Initialize を呼び出す前に、DBPROP_INIT_ASYNCH プロパティにDBPROPVAL_ASYNCH_INITIALIZE ビットを設定できます。このプロパティが設定されると、プロバイダーは Initialize の呼び出しからすぐに制御を戻し、操作が直ちに完了した場合は S_OK、初期化が非同期に続行される場合は DB_S_ASYNCHRONOUS を返します。アプリケーションは、データソースオブジェクトの IDBAsynchStatus または ISSAsynchStatus インターフェイスを照会してから、 IDBAsynchStatus::GetStatus またはISSAsynchStatus::WaitForAsynchCompletion を呼び出して初期化の状態を取得できます。

また、DBPROPSET_SQLSERVERROWSET プロパティセットに SSPROP_ISSAsynchStatus プロパティが追加されています。 ISSAsynchStatus インターフェイスをサポートするプロバイダーは、値 VARIANT_TRUE を指定してこのプロパティを実装する必要があります。

IDBAsynchStatus::Abort または ISSAsynchStatus::Abort を呼び出すと、非同期 Initialize 呼び出しを中止できます。コンシューマーは、明示的にデータソースの非同期の初期化を要求できます。この要求を行わない場合、IDBInitialize::Initialize はデータソースオブジェクトが完全に初期化されるまで、制御を戻しません。

Note

接続プールに使用されるデータソースオブジェクトは、SQL Server Native Client OLE DB プロバイダーの ISSAsynchStatus インターフェイスを呼び出すことができません。 ISSAsynchStatus インターフェイスは、プールされたデータソースオブジェクトには公開されません。

アプリケーションが明示的にカーソルエンジンの使用を設定している場合、IOpenRowset::OpenRowset と IMultipleResults::GetResult は非同期処理をサポートしません。

さらに、リモート処理プロキシ/スタブ dll (MDAC 2.8) は、SQL Server Native Client の ISSAsynchStatus インターフェイスを呼び出すことができません。 ISSAsynchStatus インターフェイスは、リモート処理経由では公開されません。

サービスコンポーネントは、ISSAsynchStatus をサポートしません。

実行と行セットの初期化

コマンドの実行結果を非同期に開くようデザインされているアプリケーションは、DBPROP_ROWSET_ASYNCH プロパティに DBPROPVAL_ASYNCH_INITIALIZE ビットを設定できます。 IDBInitialize::Initialize、ICommand::Execute、IOpenRowset::OpenRowset または IMultipleResults::GetResult を呼び出す前にこのビットを設定するときは、riid 引数を IID_IDBAsynchStatus、IID_ISSAsynchStatus、または IID_IUnknown に設定する必要があります。

メソッドはすぐに制御を戻し、行セットの初期化が直ちに完了した場合は S_OK、行セットの初期化が非同期に続行される場合は DB_S_ASYNCHRONOUS を返して、ppRowset を行セット上の要求されたインターフェイスに設定します。 SQL Server Native Client OLE DB プロバイダーの場合、このインターフェイスは、IDBAsynchStatus または ISSAsynchStatus のみにできます。このインターフェイスは、行セットが完全に初期化されるまでは中断状態にあるかのように動作し、IID_IDBAsynchStatus または IID_ISSAsynchStatus 以外のインターフェイスに対して QueryInterface が呼び出された場合、E_NOINTERFACE を返すことがあります。コンシューマーが明示的に非同期処理を要求しない限り、行セットは同期的に初期化されます。 IDBAsynchStaus::GetStatus または ISSAsynchStatus::WaitForAsynchCompletion が非同期操作が完了したことを示す値を返した場合、要求したすべてのインターフェイスを使用できます。これは、必ずしも行セットに完全にデータが格納されたことを意味するものではありませんが、行セットは完成し、完全に機能します。

実行されたコマンドが行セットを返さない場合でも、このコマンドは、IDBAsynchStatus をサポートするオブジェクトを直ちに返します。

非同期コマンドの実行により複数の結果を取得する必要がある場合は、次の操作を行います。

コマンドを実行する前に、DBPROP_ROWSET_ASYNCH プロパティに DBPROPVAL_ASYNCH_INITIALIZE ビットを設定します。
ICommand::Execute を呼び出し、IMultipleResults を要求します。

その結果、QueryInterface を使用して複数の結果のインターフェイスをクエリすることで、IDBAsynchStatus および ISSAsynchStatus インターフェイスを取得できるようになります。

コマンドの実行が完了すると、IMultipleResults を通常どおり使用できます。ただし、非同期処理の場合は 1 つだけ例外があり、DB_S_ASYNCHRONOUS が返される可能性があります。この場合、IDBAsynchStatus または ISSAsynchStatus を使用して、操作が完了しているかどうかを確認できます。

例

次の例では、アプリケーションが非ブロッキングメソッドを呼び出し、いくつか他の処理を実行し、制御を戻して結果を処理します。 ISSAsynchStatus::WaitForAsynchCompletion は、非同期実行操作が完了するか、dwMilisecTimeOut により指定された時間が経過するまで、内部イベントオブジェクト上で待機します。

// Set the DBPROPVAL_ASYNCH_INITIALIZE bit in the   
// DBPROP_ROWSET_ASYNCH property before calling Execute().  
  
DBPROPSET CmdPropset[1];  
DBPROP CmdProperties[1];  
  
CmdPropset[0].rgProperties = CmdProperties;  
CmdPropset[0].cProperties = 1;  
CmdPropset[0].guidPropertySet = DBPROPSET_ROWSET;  
  
// Set asynch mode for command.  
CmdProperties[0].dwPropertyID = DBPROP_ROWSET_ASYNCH;  
CmdProperties[0].vValue.vt = VT_I4;  
CmdProperties[0].vValue.lVal = DBPROPVAL_ASYNCH_INITIALIZE;  
CmdProperties[0].dwOptions = DBPROPOPTIONS_REQUIRED;  
  
hr = pICommandProps->SetProperties(1, CmdPropset);  
  
hr = pICommand->Execute(  
   pUnkOuter,  
   IID_ISSAsynchStatus,  
   pParams,  
   pcRowsAffected,  
   (IUnknown**)&pISSAsynchStatus);  
  
if (hr == DB_S_ASYNCHRONOUS)  
{  
   // Do some work here...  
  
   hr = pISSAsynchStatus->WaitForAsynchCompletion(dwMilisecTimeOut);  
   if ( hr == S_OK)  
   {  
      hr = pISSAsynchStatus->QueryInterface(IID_IRowset, (void**)&pRowset);  
      pISSAsynchStatus->Release();  
   }  
}

ISSAsynchStatus::WaitForAsynchCompletion は、非同期実行操作が完了するか、dwMilisecTimeOut の値が示す時間が経過するまで、内部イベントオブジェクト上で待機します。

次の例は、複数の結果セットを返す非同期処理のコードです。

DBPROP CmdProperties[1];  
  
// Set asynch mode for command.  
CmdProperties[0].dwPropertyID = DBPROP_ROWSET_ASYNCH;  
CmdProperties[0].vValue.vt = VT_I4;  
CmdProperties[0].vValue.lVal = DBPROPVAL_ASYNCH_INITIALIZE;  
  
hr = pICommand->Execute(  
   pUnkOuter,  
   IID_IMultipleResults,  
   pParams,  
   pcRowsAffected,  
   (IUnknown**)&pIMultipleResults);  
  
// Use GetResults for ISSAsynchStatus.  
hr = pIMultipleResults->GetResult(IID_ISSAsynchStatus, (void **) &pISSAsynchStatus);  
  
if (hr == DB_S_ASYNCHRONOUS)  
{  
   // Do some work here...  
  
   hr = pISSAsynchStatus->WaitForAsynchCompletion(dwMilisecTimeOut);  
   if (hr == S_OK)  
   {  
      hr = pISSAsynchStatus->QueryInterface(IID_IRowset, (void**)&pRowset);  
      pISSAsynchStatus->Release();  
   }  
}

ブロックを防ぐため、次の例のように、クライアントでは実行中の非同期操作の状態を確認できます。

// Set the DBPROPVAL_ASYNCH_INITIALIZE bit in the   
// DBPROP_ROWSET_ASYNCH property before calling Execute().  
hr = pICommand->Execute(  
   pUnkOuter,  
   IID_ISSAsynchStatus,  
   pParams,  
   pcRowsAffected,  
   (IUnknown**)&pISSAsynchStatus);   
  
if (hr == DB_S_ASYNCHRONOUS)  
{  
   do{  
      // Do some work...  
      hr = pISSAsynchStatus->GetStatus(DB_NULL_HCHAPTER, DBASYNCHOP_OPEN, NULL, NULL, &ulAsynchPhase, NULL);  
   }while (DBASYNCHPHASE_COMPLETE != ulAsynchPhase)  
   if SUCCEEDED(hr)  
   {  
      hr = pISSAsynchStatus->QueryInterface(IID_IRowset, (void**)&pRowset);  
   }  
   pIDBAsynchStatus->Release();  
}

次の例は、現在実行中の非同期操作を中止する方法を示しています。

// Set the DBPROPVAL_ASYNCH_INITIALIZE bit in the   
// DBPROP_ROWSET_ASYNCH property before calling Execute().  
hr = pICommand->Execute(  
   pUnkOuter,  
   IID_ISSAsynchStatus,  
   pParams,  
   pcRowsAffected,  
   (IUnknown**)&pISSAsynchStatus);  
  
if (hr == DB_S_ASYNCHRONOUS)  
{  
   // Do some work...  
   hr = pISSAsynchStatus->Abort(DB_NULL_HCHAPTER, DBASYNCHOP_OPEN);  
}

参照

SQL Server Native Client の機能
 行セットのプロパティと動作
 ISSAsynchStatus (OLE DB)

次の方法で共有

SQL Server Native Client での非同期操作の実行

データベース接続の開閉

実行と行セットの初期化

例

参照

フィードバック

その他のリソース