Objek Sumber Data SQL Server Native Client (OLE DB)

  • Artikel

Berlaku untuk: SQL Server Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

Penting

SNAC SQL Server Native Client (sering disingkat) telah dihapus dari SQL Server 2022 (16,x) dan SQL Server Management Studio 19 (SSMS). Penyedia SQL Server Native Client OLE DB (SQLNCLI atau SQLNCLI11) dan Penyedia Microsoft OLE DB warisan untuk SQL Server (SQLOLEDB) tidak direkomendasikan untuk pengembangan baru. Beralih ke Microsoft OLE DB Driver (MSOLEDBSQL) baru untuk SQL Server ke depannya.

SQL Server Native Client menggunakan istilah sumber data untuk kumpulan antarmuka OLE DB yang digunakan untuk membuat tautan ke penyimpanan data, seperti SQL Server. Membuat instans objek sumber data penyedia adalah tugas pertama dari konsumen SQL Server Native Client.

Setiap penyedia OLE DB mendeklarasikan pengidentifikasi kelas (CLSID) untuk dirinya sendiri. CLSID untuk penyedia SQL Server Native Client OLE DB adalah CLSID_SQLNCLI10 GUID C/C++ (simbol SQLNCLI_CLSID akan menyelesaikan progid yang benar dalam file sqlncli.h yang Anda referensikan). Dengan CLSID, konsumen menggunakan fungsi OLE CoCreateInstance untuk memproduksi instans objek sumber data.

SQL Server Native Client adalah server dalam proses. Instans objek penyedia SQL Server Native Client OLE DB dibuat menggunakan makro CLSCTX_INPROC_SERVER untuk menunjukkan konteks yang dapat dieksekusi.

Objek sumber data penyedia OLE DB SQL Server Native Client mengekspos antarmuka inisialisasi OLE DB yang memungkinkan konsumen untuk terhubung ke database SQL Server yang ada.

Setiap koneksi yang dibuat melalui penyedia SQL Server Native Client OLE DB mengatur opsi ini secara otomatis:

  • SET ANSI_WARNINGS AKTIF

  • SET ANSI_NULLS AKTIF

  • SET ANSI_PADDING AKTIF

  • ATUR ANSI_NULL_DFLT_ON AKTIF

  • SET QUOTED_IDENTIFIER AKTIF

  • SET CONCAT_OF_NULL_YIELDS_NULL AKTIF

Contoh ini menggunakan makro pengidentifikasi kelas untuk membuat objek sumber data penyedia SQL Server Native Client OLE DB dan mendapatkan referensi ke antarmuka IDBInitialize-nya.

IDBInitialize*   pIDBInitialize;  
HRESULT          hr;  
  
hr = CoCreateInstance(CLSID_SQLNCLI10, NULL, CLSCTX_INPROC_SERVER,  
    IID_IDBInitialize, (void**) &pIDBInitialize);  
  
if (SUCCEEDED(hr))  
{  
    //  Perform necessary processing with the interface.  
    pIDBInitialize->Uninitialize();  
    pIDBInitialize->Release();  
}  
else  
{  
    // Display error from CoCreateInstance.  
}

Dengan keberhasilan pembuatan instans objek sumber data penyedia SQL Server Native Client OLE DB, aplikasi konsumen dapat melanjutkan dengan menginisialisasi sumber data dan membuat sesi. Sesi OLE DB menyajikan antarmuka yang memungkinkan akses dan manipulasi data.

Penyedia SQL Server Native Client OLE DB membuat koneksi pertamanya ke instans SQL Server tertentu sebagai bagian dari inisialisasi sumber data yang berhasil. Koneksi dipertahankan selama referensi dipertahankan pada antarmuka inisialisasi sumber data apa pun, atau sampai metode IDBInitialize::Uninitialize dipanggil.

Di Bagian Ini

Lihat juga

SQL Server Native Client (OLE DB)