Rowsets (Penyedia OLE DB Klien Asli)
Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Kumpulan baris adalah sekumpulan baris yang berisi kolom data. Himpunan 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 set baris. Penyedia SQL Server Native Client OLE DB mendukung kedua antarmuka ini. Kedua metode ini dijelaskan di sini.
Buat set baris dengan memanggil metode IOpenRowset::OpenRowset .
Ini setara dengan membuat set baris melalui 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 tempat membuat set baris.
Buat objek perintah dengan memanggil metode IDBCreateCommand::CreateCommand .
Objek perintah menjalankan perintah yang didukung penyedia. Dengan penyedia SQL Server Native Client OLE DB, konsumen dapat menentukan pernyataan Transact-SQL apa pun, seperti pernyataan SELECT atau panggilan ke prosedur tersimpan. Langkah-langkah untuk membuat set baris dengan menggunakan objek perintah adalah:
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 .
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 set baris. 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 aksesor. Jika Anda memiliki antarmuka IAccessor , antarmuka tersebut masih harus dirilis.