セッション (ネイティブクライアント OLE DB プロバイダー)

[アーティクル]
07/04/2024

適用対象: SQL Server Azure SQL Database 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 (SSMS) から削除されました。 SQL Server Native Client OLE DB プロバイダー (SQLNCLI または SQLNCLI11) とレガシ Microsoft OLE DB Provider for SQL Server (SQLOLEDB) はどちらも、新しい開発には推奨されません。今後は、新しい Microsoft OLE DB Driver (MSOLEDBSQL) for SQL Server に切り替えてください。

SQL Server Native Client OLE DB プロバイダーセッションは、SQL Server のインスタンスへの単一の接続を表します。

SQL Server Native Client OLE DB プロバイダーでは、セッションがデータソースのトランザクション領域を区切る必要があります。特定のセッションオブジェクトから作成されたすべてのコマンドオブジェクトは、そのセッションオブジェクトのローカルトランザクションまたは分散トランザクションに関係します。

初期化されたデータソースで最初に作成されるセッションオブジェクトが、初期化時に確立された SQL Server 接続を受け取ります。そのセッションオブジェクトのインターフェイスのすべての参照が解放されると、SQL Server のインスタンスへの接続で、データソースで作成される別のセッションオブジェクトを使用できるようになります。

データソースで新たに作成されるセッションオブジェクトは、データソースでの指定に従って、SQL Server のインスタンスへの独自の接続を確立します。 SQL Server のインスタンスへの接続は、そのセッションを作成したオブジェクトに対するすべての参照がアプリケーションによって解放された時点で削除されます。

次の例では、SQL Server Native Client OLE DB プロバイダーを使用して SQL Server データベースに接続する方法を示します。

int main()  
{  
    // Interfaces used in the example.  
    IDBInitialize*      pIDBInitialize      = NULL;  
    IDBCreateSession*   pIDBCreateSession   = NULL;  
    IDBCreateCommand*   pICreateCmd1        = NULL;  
    IDBCreateCommand*   pICreateCmd2        = NULL;  
    IDBCreateCommand*   pICreateCmd3        = NULL;  
  
    // Initialize COM.  
    if (FAILED(CoInitialize(NULL)))  
    {  
        // Display error from CoInitialize.  
        return (-1);  
    }  
  
    // Get the memory allocator for this task.  
    if (FAILED(CoGetMalloc(MEMCTX_TASK, &g_pIMalloc)))  
    {  
        // Display error from CoGetMalloc.  
        goto EXIT;  
    }  
  
    // Create an instance of the data source object.  
    if (FAILED(CoCreateInstance(CLSID_SQLNCLI10, NULL,  
        CLSCTX_INPROC_SERVER, IID_IDBInitialize, (void**)  
        &pIDBInitialize)))  
    {  
        // Display error from CoCreateInstance.  
        goto EXIT;  
    }  
  
    // The InitFromPersistedDS function   
    // performs IDBInitialize->Initialize() establishing  
    // the first application connection to the instance of SQL Server.  
    if (FAILED(InitFromPersistedDS(pIDBInitialize, L"MyDataSource",  
        NULL, NULL)))  
    {  
        goto EXIT;  
    }  
  
    // The IDBCreateSession interface is implemented on the data source  
    // object. Maintaining the reference received maintains the   
    // connection of the data source to the instance of SQL Server.  
    if (FAILED(pIDBInitialize->QueryInterface(IID_IDBCreateSession,  
        (void**) &pIDBCreateSession)))  
    {  
        // Display error from pIDBInitialize.  
        goto EXIT;  
    }  
  
    // Releasing this has no effect on the SQL Server connection  
    // of the data source object because of the reference maintained by  
    // pIDBCreateSession.  
    pIDBInitialize->Release();  
    pIDBInitialize = NULL;  
  
    // The session created next receives the SQL Server connection of  
    // the data source object. No new connection is established.  
    if (FAILED(pIDBCreateSession->CreateSession(NULL,  
        IID_IDBCreateCommand, (IUnknown**) &pICreateCmd1)))  
    {  
        // Display error from pIDBCreateSession.  
        goto EXIT;  
    }  
  
    // A new connection to the instance of SQL Server is established to support the  
    // next session object created. On successful completion, the  
    // application has two active connections on the SQL Server.  
    if (FAILED(pIDBCreateSession->CreateSession(NULL,  
        IID_IDBCreateCommand, (IUnknown**) &pICreateCmd2)))  
    {  
        // Display error from pIDBCreateSession.  
        goto EXIT;  
    }  
  
    // pICreateCmd1 has the data source connection. Because the  
    // reference on the IDBCreateSession interface of the data source  
    // has not been released, releasing the reference on the session  
    // object does not terminate a connection to the instance of SQL Server.  
    // However, the connection of the data source object is now   
    // available to another session object. After a successful call to   
    // Release, the application still has two active connections to the   
    // instance of SQL Server.  
    pICreateCmd1->Release();  
    pICreateCmd1 = NULL;  
  
    // The next session created gets the SQL Server connection  
    // of the data source object. The application has two active  
    // connections to the instance of SQL Server.  
    if (FAILED(pIDBCreateSession->CreateSession(NULL,  
        IID_IDBCreateCommand, (IUnknown**) &pICreateCmd3)))  
    {  
        // Display error from pIDBCreateSession.  
        goto EXIT;  
    }  
  
EXIT:  
    // Even on error, this does not terminate a SQL Server connection   
    // because pICreateCmd1 has the connection of the data source   
    // object.  
    if (pICreateCmd1 != NULL)  
        pICreateCmd1->Release();  
  
    // Releasing the reference on pICreateCmd2 terminates the SQL  
    // Server connection supporting the session object. The application  
    // now has only a single active connection on the instance of SQL Server.  
    if (pICreateCmd2 != NULL)  
        pICreateCmd2->Release();  
  
    // Even on error, this does not terminate a SQL Server connection   
    // because pICreateCmd3 has the connection of the   
    // data source object.  
    if (pICreateCmd3 != NULL)  
        pICreateCmd3->Release();  
  
    // On release of the last reference on a data source interface, the  
    // connection of the data source object to the instance of SQL Server is broken.  
    // The example application now has no SQL Server connections active.  
    if (pIDBCreateSession != NULL)  
        pIDBCreateSession->Release();  
  
    // Called only if an error occurred while attempting to get a   
    // reference on the IDBCreateSession interface of the data source.  
    // If so, the call to IDBInitialize::Uninitialize terminates the   
    // connection of the data source object to the instance of SQL Server.  
    if (pIDBInitialize != NULL)  
    {  
        if (FAILED(pIDBInitialize->Uninitialize()))  
        {  
            // Uninitialize is not required, but it fails if an  
            // interface has not been released. Use it for  
            // debugging.  
        }  
        pIDBInitialize->Release();  
    }  
  
    if (g_pIMalloc != NULL)  
        g_pIMalloc->Release();  
  
    CoUninitialize();  
  
    return (0);  
}

SQL Server Native Client OLE DB プロバイダーセッションオブジェクトを SQL Server のインスタンスに接続すると、セッションオブジェクトを継続的に作成および解放するアプリケーションに対して大きなオーバーヘッドが発生する可能性があります。 SQL Server Native Client OLE DB プロバイダーセッションオブジェクトを効率的に管理することで、オーバーヘッドを最小限に抑えることができます。 SQL Server Native Client OLE DB プロバイダーアプリケーションは、オブジェクトの少なくとも 1 つのインターフェイスで参照を維持することで、セッションオブジェクトの SQL Server 接続をアクティブな状態に保つことができます。

たとえば、コマンド作成オブジェクト参照のプールを保持することで、プール内にあるセッションオブジェクトのアクティブな接続が維持されます。セッションオブジェクトが必要になると、プールを保持するコードは、セッションを必要とするアプリケーションメソッドに対して、有効な IDBCreateCommand インターフェイスポインターを渡します。アプリケーションメソッドでセッションが不要になると、このメソッドは、プールを保持するコードにインターフェイスポインターを返します。ただし、コマンド作成オブジェクトへのアプリケーションの参照は解放されません。

Note

上記の例で IDBCreateCommand インターフェイスを使用したのは、ICommand インターフェイスに GetDBSession メソッドが実装されているためです。このメソッドは、オブジェクトが作成されたセッションを特定できる、コマンドまたは行セットのスコープ内にある唯一のメソッドです。したがって、コマンドオブジェクトを使用すると、追加のセッションを作成できるデータソースオブジェクトポインターをアプリケーションで取得できます。

参照

データソースオブジェクト (OLE DB)

次の方法で共有

セッション (ネイティブクライアント OLE DB プロバイダー)

参照

フィードバック

その他のリソース

次の方法で共有

セッション (ネイティブ クライアント OLE DB プロバイダー)

参照

フィードバック

その他のリソース

セッション (ネイティブクライアント OLE DB プロバイダー)