Bagikan melalui

Objek Sumber Data Klien Asli SQL Server (OLE DB)

Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Penting

SQL Server Native Client (sering disingkat SNAC) 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 SQL Server Native Client OLE DB 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

  • ATUR ANSI_NULLS AKTIF

  • SET ANSI_PADDING AKTIF

  • SET ANSI_NULL_DFLT_ON AKTIF

  • AKTIFKAN QUOTED_IDENTIFIER

  • 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

Klien Asli SQL Server (OLE DB)

  • Last updated on