Kumpulan baris

  • Artikel

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

Unduh driver OLE DB

Kumpulan baris adalah sekumpulan baris yang berisi kolom data. Kumpulan baris adalah objek pusat yang memungkinkan semua penyedia data OLE DB mengekspos data tataan hasil dalam bentuk tabular.

Setelah konsumen membuat sesi dengan menggunakan metode IDBCreateSession::CreateSession , konsumen dapat menggunakan antarmuka IOpenRowset atau IDBCreateCommand pada sesi untuk membuat rowset. Driver OLE DB untuk SQL Server mendukung kedua antarmuka ini. Kedua metode ini dijelaskan di sini.

  • Buat set baris dengan memanggil metode IOpenRowset::OpenRowset .

    Ini setara dengan membuat kumpulan baris di atas satu tabel. Metode ini membuka dan mengembalikan set baris yang menyertakan semua baris dari satu tabel dasar. Salah satu argumen ke OpenRowset adalah ID tabel yang mengidentifikasi tabel untuk membuat set baris.

  • Buat objek perintah dengan memanggil metode IDBCreateCommand::CreateCommand .

    Objek perintah menjalankan perintah yang didukung penyedia. Dengan Driver OLE DB untuk SQL Server, konsumen dapat menentukan pernyataan T-SQL apa pun, seperti pernyataan SELECT atau panggilan ke prosedur tersimpan. Langkah-langkah untuk membuat set baris dengan menggunakan objek perintah adalah:

    1. Konsumen memanggil metode IDBCreateCommand::CreateCommand pada sesi untuk mendapatkan objek perintah yang meminta antarmuka ICommandText pada objek perintah. Antarmuka ICommandText ini mengatur dan mengambil teks perintah aktual. Konsumen mengisi perintah teks dengan memanggil metode ICommandText::SetCommandText .

    2. Pengguna memanggil metode ICommand::Execute pada perintah . Objek set baris yang dibangun saat perintah dijalankan berisi tataan hasil dari perintah .

Konsumen dapat menggunakan antarmuka ICommandProperties untuk mendapatkan atau mengatur properti untuk set baris yang dikembalikan oleh perintah yang dijalankan oleh antarmuka ICommand::Execute . Properti yang paling umum diminta adalah antarmuka yang harus didukung oleh rowset. Selain antarmuka, konsumen dapat meminta properti yang memodifikasi perilaku set baris atau antarmuka.

Konsumen merilis rowset dengan metode IRowset::Release . Merilis set baris merilis handel baris apa pun yang dipegang oleh konsumen pada set baris tersebut. Merilis set baris tidak merilis pengaktor. Jika Anda memiliki antarmuka IAccessor , antarmuka tersebut masih harus dirilis.

Di Bagian Ini

Lihat juga

Driver OLE DB untuk Pemrograman SQL Server