Properti dan Perilaku Set Baris
Berlaku untuk:
SQL Server Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)
Berikut ini adalah driver OLE DB untuk properti set baris SQL Server:
| ID Properti | Deskripsi |
|---|---|
| DBPROP_ABORTPRESERVE | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Perilaku set baris setelah operasi pembatalan ditentukan oleh properti ini. VARIANT_FALSE: Driver OLE DB untuk SQL Server membatalkan set baris setelah operasi batalkan. Fungsionalitas objek set baris hampir hilang. Ini hanya mendukung operasi IUnknown dan rilis handel baris dan aksesor yang luar biasa. VARIANT_TRUE: Driver OLE DB untuk SQL Server mempertahankan set baris yang valid. |
| DBPROP_ACCESSORDER | R/W: Baca/tulis Default: DBPROPVAL_AO_RANDOM Deskripsi: Urutan akses. Urutan kolom mana yang harus diakses pada set baris. DBPROPVAL_AO_RANDOM: Kolom dapat diakses dalam urutan apa pun. DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: Kolom yang terikat sebagai objek penyimpanan hanya dapat diakses dalam urutan berurutan yang ditentukan oleh kolom ordinal. DBPROPVAL_AO_SEQUENTIAL: Semua kolom harus diakses dalam urutan berurutan yang ditentukan oleh ordinal kolom. |
| DBPROP_APPENDONLY | Properti set baris ini tidak diimplementasikan oleh Driver OLE DB untuk SQL Server. Mencoba membaca atau menulis nilai properti menghasilkan kesalahan. |
| DBPROP_BLOCKINGSTORAGEOBJECTS | R/W: Baca-saja Default: VARIANT_TRUE Deskripsi: Driver OLE DB untuk blok objek penyimpanan SQL Server menggunakan metode set baris lainnya. |
| DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Driver OLE DB untuk SQL Server mendukung marka buku untuk identifikasi baris set baris saat DBPROP_BOOKMARKS atau DBPROP_LITERALBOOKMARKS VARIANT_TRUE. Mengatur salah satu properti ke VARIANT_TRUE tidak mengaktifkan penempatan set baris menurut marka buku. Atur DBPROP_IRowsetLocate atau DBPROP_IRowsetScroll ke VARIANT_TRUE untuk membuat set baris yang mendukung penempatan set baris menurut marka buku. Driver OLE DB untuk SQL Server menggunakan kursor Microsoft SQL Server untuk mendukung set baris yang berisi marka buku. Untuk informasi selengkapnya, lihat Kumpulan Baris dan kursor SQL Server. Catatan: Mengatur properti ini bertentangan dengan Driver OLE DB lainnya untuk properti penentuan kursor SQL Server menyebabkan kesalahan. Misalnya, mengatur DBPROP_BOOKMARKS ke VARIANT_TRUE saat DBPROP_OTHERINSERT juga VARIANT_TRUE menghasilkan kesalahan saat konsumen mencoba membuka set baris. |
| DBPROP_BOOKMARKSKIPPED | R/W: Baca-saja Default: VARIANT_FALSE Deskripsi: Driver OLE DB untuk SQL Server mengembalikan DB_E_BADBOOKMARK jika konsumen menunjukkan marka buku yang tidak valid saat memosisikan atau mencari set baris yang diberi marka buku. |
| DBPROP_BOOKMARKTYPE | R/W: Baca-saja Default: DBPROPVAL_BMK_NUMERIC Deskripsi: Driver OLE DB untuk SQL Server hanya mengimplementasikan marka buku numerik. Driver OLE DB untuk bookmark SQL Server adalah bilangan bulat yang tidak ditandatangani 32-bit, ketik DBTYPE_UI4. |
| DBPROP_CACHEDEFERRED | Properti set baris ini tidak diimplementasikan oleh Driver OLE DB untuk SQL Server. Mencoba membaca atau menulis nilai properti menghasilkan kesalahan. |
| DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Driver OLE DB untuk SQL Server mendukung pengambilan dan pengguliran mundur dalam himpunan baris yang tidak berurut. Driver OLE DB untuk SQL Server membuat set baris yang didukung kursor saat DBPROP_CANFETCHBACKWARDS atau DBPROP_CANSCROLLBACKWARDS VARIANT_TRUE. Untuk informasi selengkapnya, lihat Kumpulan Baris dan kursor SQL Server. |
| DBPROP_CANHOLDROWS | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Secara default, Driver OLE DB untuk SQL Server mengembalikan DB_E_ROWSNOTRELEASED jika konsumen mencoba mendapatkan lebih banyak baris untuk set baris saat perubahan tertunda ada pada baris yang saat ini berada di set baris. Perilaku ini dapat dimodifikasi. Mengatur DBPROP_CANHOLDROWS dan DBPROP_IRowsetChange ke VARIANT_TRUE menyiratkan kumpulan baris yang diberi marka buku. Jika kedua properti VARIANT_TRUE, antarmuka IRowsetLocate tersedia pada set baris dan DBPROP_BOOKMARKS dan DBPROP_LITERALBOOKMARKS keduanya VARIANT_TRUE. Driver OLE DB untuk kumpulan baris SQL Server yang berisi bookmark didukung oleh kursor SQL Server. |
| DBPROP_CHANGEINSERTEDROWS | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Properti ini hanya dapat diatur ke VARIANT_TRUE jika set baris menggunakan kursor berbasis set kunci. |
| DBPROP_COLUMNRESTRICT | R/W: Baca-saja Default: VARIANT_FALSE Deskripsi: Driver OLE DB untuk SQL Server mengatur properti ke VARIANT_TRUE saat kolom dalam set baris tidak dapat diubah oleh konsumen. Kolom lain dalam set baris mungkin dapat diperbarui dan baris itu sendiri dapat dihapus. Ketika properti VARIANT_TRUE, konsumen memeriksa anggota dwFlags dari struktur DBCOLUMNINFO untuk menentukan apakah nilai kolom individu dapat ditulis atau tidak. Untuk kolom yang dapat dimodifikasi, dwFlags menunjukkan DBCOLUMNFLAGS_WRITE. |
| DBPROP_COMMANDTIMEOUT | R/W: Baca/tulis Default: 0 Deskripsi: Secara default, Driver OLE DB untuk SQL Server tidak kehabisan waktu pada metode ICommand::Execute. |
| DBPROP_COMMITPRESERVE | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Perilaku set baris setelah operasi penerapan ditentukan oleh properti ini. VARIANT_TRUE: Driver OLE DB untuk SQL Server mempertahankan set baris yang valid. VARIANT_FALSE: Driver OLE DB untuk SQL Server membatalkan set baris setelah operasi penerapan. Fungsionalitas objek set baris hampir hilang. Ini hanya mendukung operasi IUnknown dan rilis handel baris dan aksesor yang luar biasa. |
| DBPROP_DEFERRED | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Saat diatur ke VARIANT_TRUE Driver OLE DB untuk SQL Server mencoba menggunakan kursor server untuk set baris. Kolom teks, ntext, dan gambar tidak dikembalikan dari server hingga diakses oleh aplikasi. |
| DBPROP_DELAYSTORAGEOBJECTS | R/W: Baca-saja Default: VARIANT_FALSE Deskripsi: Driver OLE DB untuk SQL Server mendukung mode pembaruan langsung pada objek penyimpanan. Perubahan yang dilakukan pada data dalam objek aliran berurutan segera dikirimkan ke SQL Server. Modifikasi dilakukan berdasarkan mode transaksi set baris. |
| DBPROP_HIDDENCOLUMNS | R/W: Baca-saja Default: VARIANT_FALSE Deskripsi: Jumlah Kolom Tersembunyi Jika DBPROP_UNIQUEROWS VARIANT_TRUE, properti DBPROP_HIDDENCOLUMNS mengembalikan jumlah kolom "tersembunyi" tambahan yang ditambahkan oleh penyedia untuk mengidentifikasi baris secara unik dalam set baris. Kolom-kolom ini dikembalikan oleh IColumnsInfo::GetColumnInfo dan IColumnsRowset::GetColumnsRowset. Namun, mereka tidak disertakan dalam jumlah baris yang dikembalikan oleh argumen pcColumns yang dikembalikan oleh IColumnsInfo::GetColumnInfo. Untuk menentukan jumlah total kolom yang diwakili dalam struktur prgInfo yang dikembalikan oleh IColumnsInfo::GetColumnInfo, termasuk kolom tersembunyi, konsumen menambahkan nilai DBPROP_HIDDENCOLUMNS ke hitungan kolom yang dikembalikan dari IColumnsInfo::GetColumnInfo di pcColumns. Jika DBPROP_UNIQUEROWS VARIANT_FALSE, DBPROP_HIDDENCOLUMNS adalah nol. |
| DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo | R/W: Baca-saja Default: VARIANT_TRUE Deskripsi: Driver OLE DB untuk SQL Server mendukung antarmuka ini pada semua set baris. |
| DBPROP_IColumnsRowset | R/W: Baca/tulis Default: VARIANT_TRUE Deskripsi: Driver OLE DB untuk SQL Server mendukung antarmuka IColumnsRowset. |
| DBPROP_IConnectionPointContainer | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: IConnectionPointContainer. Jika VARIANT_TRUE, set baris mendukung antarmuka yang ditentukan. Jika VARIANT_FALSE, set baris tidak mendukung antarmuka yang ditentukan. Penyedia yang mendukung antarmuka harus mendukung properti yang terkait dengan antarmuka tersebut dengan nilai VARIANT_TRUE. Properti ini terutama digunakan untuk meminta antarmuka melalui ICommandProperties::SetProperties. |
| DBPROP_IMultipleResults | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Driver OLE DB untuk SQL Server mendukung antarmuka IMultipleResults. |
| DBPROP_IRowsetChange DBPROP_IRowsetUpdate | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Driver OLE DB untuk SQL Server mendukung antarmuka IRowsetChange dan IRowsetUpdate. Set baris yang dibuat dengan menggunakan DBPROP_IRowsetChange sama dengan VARIANT_TRUE menunjukkan perilaku mode pembaruan langsung. Saat DBPROP_IRowsetUpdate VARIANT_TRUE, DBPROP_IRowsetChange juga VARIANT_TRUE. Kumpulan baris menunjukkan perilaku mode pembaruan yang tertunda. Driver OLE DB untuk SQL Server menggunakan kursor SQL Server untuk mendukung kumpulan baris yang mengekspos IRowsetChange atau IRowsetUpdate. Untuk informasi selengkapnya, lihat Kumpulan Baris dan Kursor SQL Server. |
| DBPROP_IRowsetIdentity | R/W: Baca/tulis Default: VARIANT_TRUE Deskripsi: Driver OLE DB untuk SQL Server mendukung antarmuka IRowsetIdentity. Jika kumpulan baris mendukung antarmuka ini, dua handel baris yang mewakili baris yang mendasar yang sama akan selalu mencerminkan data dan status yang sama. Konsumen dapat memanggil metode IRowsetIdentity:: IsSameRow untuk membandingkan dua handel baris untuk melihat apakah mereka merujuk ke instans baris yang sama. |
| DBPROP_IRowsetLocate DBPROP_IRowsetScroll | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Driver OLE DB untuk SQL Server dapat mengekspos antarmuka IRowsetLocate dan IRowsetScroll. Ketika DBPROP_IRowsetLocate VARIANT_TRUE, DBPROP_CANFETCHBACKWARDS dan DBPROP_CANSCROLLBACKWARDS juga VARIANT_TRUE. Saat DBPROP_IRowsetScroll VARIANT_TRUE, DBPROP_IRowsetLocate juga VARIANT_TRUE, dan kedua antarmuka tersedia di set baris. Marka buku diperlukan untuk salah satu antarmuka. Driver OLE DB untuk SQL Server mengatur DBPROP_BOOKMARKS dan DBPROP_LITERALBOOKMARKS ke VARIANT_TRUE ketika konsumen meminta salah satu antarmuka. Driver OLE DB untuk SQL Server menggunakan kursor SQL Server untuk mendukung IRowsetLocate dan IRowsetScroll. Untuk informasi selengkapnya, lihat Kumpulan Baris dan Kursor SQL Server. Mengatur properti ini bertentangan dengan Driver OLE DB lainnya untuk properti penentuan kursor SQL Server menyebabkan kesalahan. Misalnya, mengatur DBPROP_IRowsetScroll ke VARIANT_TRUE saat DBPROP_OTHERINSERT juga VARIANT_TRUE menghasilkan kesalahan saat konsumen mencoba membuka set baris. |
| DBPROP_IRowsetResynch | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Driver OLE DB untuk SQL Server mengekspos antarmuka IRowsetResynch sesuai permintaan. Driver OLE DB untuk SQL Server dapat mengekspos antarmuka pada set baris apa pun. |
| DBPROP_ISupportErrorInfo | R/W: Baca/tulis Default: VARIANT_TRUE Deskripsi: Driver OLE DB untuk SQL Server mengekspos antarmuka ISupportErrorInfo pada set baris. |
| DBPROP_ILockBytes | Antarmuka ini tidak diimplementasikan oleh Driver OLE DB untuk SQL Server. Mencoba membaca atau menulis properti menghasilkan kesalahan. |
| DBPROP_ISequentialStream | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Driver OLE DB untuk SQL Server mengekspos antarmuka ISequentialStream untuk mendukung data panjang dan panjang variabel yang disimpan dalam SQL Server. |
| DBPROP_IStorage | Antarmuka ini tidak diimplementasikan oleh Driver OLE DB untuk SQL Server. Mencoba membaca atau menulis properti menghasilkan kesalahan. |
| DBPROP_IStream | Antarmuka ini tidak diimplementasikan oleh Driver OLE DB untuk SQL Server. Mencoba membaca atau menulis properti menghasilkan kesalahan. |
| DBPROP_IMMOBILEROWS | R/W: Baca/tulis Default: VARIANT_TRUE Deskripsi: Properti hanya VARIANT_TRUE untuk kursor set kunci SQL Server; properti ini VARIANT_FALSE untuk semua kursor lainnya. VARIANT_TRUE: Kumpulan baris tidak akan menyusun ulang baris yang disisipkan atau diperbarui. Untuk IRowsetChange::InsertRow, baris akan muncul di akhir set baris. Untuk IRowsetChange::SetData, jika kumpulan baris tidak diurutkan, posisi baris yang diperbarui tidak diubah. Jika kumpulan baris diurutkan dan IRowsetChange::SetData mengubah kolom yang digunakan untuk mengurutkan set baris, baris tidak dipindahkan. Jika kumpulan baris dibangun di atas sekumpulan kolom kunci (biasanya kumpulan baris yang DBPROP_OTHERUPDATEDELETE nya VARIANT_TRUE tetapi DBPROP_OTHERINSERT VARIANT_FALSE), mengubah nilai kolom kunci umumnya setara dengan menghapus baris saat ini dan menyisipkan yang baru. Oleh karena itu, baris mungkin tampak bergerak atau bahkan menghilang dari kumpulan baris, jika DBPROP_OWNINSERT VARIANT_FALSE, meskipun properti DBPROP_IMMOBILEROWS VARIANT_TRUE. VARIANT_FALSE: Jika kumpulan baris diurutkan, baris yang disisipkan muncul dalam urutan set baris yang benar. Jika kumpulan baris tidak diurutkan, baris yang disisipkan akan muncul di akhir. Jika IRowsetChange::SetData mengubah kolom yang digunakan untuk mengurutkan set baris, baris akan dipindahkan. Jika kumpulan baris tidak diurutkan, posisi baris tidak diubah. |
| DBPROP_LITERALIDENTITY | R/W: Baca-saja Default: VARIANT_TRUE Deskripsi: Properti ini selalu VARIANT_TRUE. |
| DBPROP_LOCKMODE | R/W: Baca/tulis Default: DBPROPVAL_LM_NONE Deskripsi: Tingkat penguncian yang dilakukan oleh set baris (DBPROPVAL_LM_NONE, DBPROPVAL_LM_SINGLEROW). Catatan: Saat menggunakan isolasi rekam jepret dalam transaksi, jika set baris dibuka dengan menggunakan set kunci atau kursor server dinamis dan mode kunci diatur ke DBPROPVAL_LM_SINGLEROW, kesalahan akan terjadi saat mengambil baris jika orang lain telah memperbarui baris tersebut sejak transaksi dimulai. Untuk jenis kursor dan mode kunci lainnya, jika orang lain telah memperbarui baris sejak transaksi dimulai, kesalahan tidak terjadi sampai pengguna mencoba memperbarui baris. Dalam kedua kasus, kesalahan ini dihasilkan oleh server. |
| DBPROP_MAXOPENROWS | R/W: Baca-saja Default: 0 Deskripsi: Driver OLE DB untuk SQL Server tidak membatasi jumlah baris yang dapat aktif dalam set baris. |
| DBPROP_MAXPENDINGROWS | R/W: Baca-saja Default: 0 Deskripsi: Driver OLE DB untuk SQL Server tidak membatasi jumlah baris set baris dengan perubahan tertunda. |
| DBPROP_MAXROWS | R/W: Baca/tulis Default: 0 Deskripsi: Secara default, Driver OLE DB untuk SQL Server tidak membatasi jumlah baris dalam set baris. Saat konsumen menetapkan DBPROP_MAXROWS, Driver OLE DB untuk SQL Server menggunakan pernyataan SET ROWCOUNT untuk membatasi jumlah baris dalam set baris. SET ROWCOUNT dapat menyebabkan konsekuensi yang tidak diinginkan dalam eksekusi pernyataan SQL Server. Untuk informasi selengkapnya, lihat MENGATUR ROWCOUNT. |
| DBPROP_MAYWRITECOLUMN | Properti set baris ini tidak diimplementasikan oleh Driver OLE DB untuk SQL Server. Mencoba membaca atau menulis nilai properti menghasilkan kesalahan. |
| DBPROP_MEMORYUSAGE | Properti set baris ini tidak diimplementasikan oleh Driver OLE DB untuk SQL Server. Mencoba membaca atau menulis nilai properti menghasilkan kesalahan. |
| DBPROP_NOTIFICATIONGRANULARITY | Properti set baris ini tidak diimplementasikan oleh Driver OLE DB untuk SQL Server. Mencoba membaca atau menulis nilai properti menghasilkan kesalahan. |
| DBPROP_NOTIFICATIONPHASES | R/W: Baca-saja Default: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT Deskripsi: Driver OLE DB untuk SQL Server mendukung semua fase pemberitahuan. |
| DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE | R/W: Baca-saja Default: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO Deskripsi: Driver OLE DB untuk fase pemberitahuan SQL Server dapat dibatalkan sebelum upaya untuk melakukan modifikasi set baris yang ditunjukkan. Driver OLE DB untuk SQL Server tidak mendukung pembatalan fase setelah upaya selesai. |
| DBPROP_ORDEREDBOOKMARKS | Properti set baris ini tidak diimplementasikan oleh Driver OLE DB untuk SQL Server. Mencoba membaca atau menulis nilai properti menghasilkan kesalahan. |
| DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Mengatur properti visibilitas perubahan menyebabkan Driver OLE DB untuk SQL Server menggunakan kursor SQL Server untuk mendukung set baris. Untuk informasi selengkapnya, lihat Kumpulan Baris dan kursor SQL Server. |
| DBPROP_QUICKRESTART | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Saat diatur ke VARIANT_TRUE, Driver OLE DB untuk SQL Server mencoba menggunakan kursor server untuk set baris. |
| DBPROP_REENTRANTEVENTS | R/W: Baca-saja Default: VARIANT_TRUE Deskripsi: Driver OLE DB untuk kumpulan baris SQL Server bersifat entrant ulang dan dapat mengembalikan DB_E_NOTREENTRANT jika konsumen mencoba mengakses metode himpunan baris non-entrant dari panggilan balik pemberitahuan. |
| DBPROP_REMOVEDELETED | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Driver OLE DB untuk SQL Server mengubah nilai properti berdasarkan visibilitas perubahan pada data SQL Server yang diekspos oleh set baris. VARIANT_TRUE: Baris yang dihapus oleh konsumen atau pengguna SQL Server lainnya dihapus dari set baris saat set baris di-refresh. DBPROP_OTHERINSERT is VARIANT_TRUE. VARIANT_FALSE: Baris yang dihapus oleh konsumen atau pengguna SQL Server lainnya tidak dihapus dari set baris saat set baris di-refresh. Nilai status baris untuk baris SQL Server yang dihapus dalam set baris DBROWSTATUS_E_DELETED. DBPROP_OTHERINSERT is VARIANT_TRUE. Properti ini hanya memiliki nilai untuk set baris yang didukung oleh kursor SQL Server. Untuk informasi selengkapnya, lihat Kumpulan Baris dan kursor SQL Server. Ketika properti DBPROP_REMOVEDELETED diimplementasikan pada set baris kursor set kunci, baris yang dihapus dihapus pada waktu pengambilan dan dimungkinkan untuk metode pengambilan baris, seperti GetNextRows dan GetRowsAt, untuk mengembalikan baris S_OK dan lebih sedikit dari yang diminta. Perhatikan bahwa perilaku ini tidak menandakan kondisi DB_S_ENDOFROWSET dan bahwa jumlah baris yang dikembalikan tidak akan pernah nol jika ada baris yang tersisa. |
| DBPROP_REPORTMULTIPLECHANGES | Properti set baris ini tidak diimplementasikan oleh Driver OLE DB untuk SQL Server. Mencoba membaca atau menulis nilai properti menghasilkan kesalahan. |
| DBPROP_RETURNPENDINGINSERTS | R/W: Baca-saja Default: VARIANT_FALSE Deskripsi: Ketika metode yang mengambil baris dipanggil, Driver OLE DB untuk SQL Server tidak mengembalikan baris sisipan yang tertunda. |
| DBPROP_ROWRESTRICT | R/W: Baca-saja Default: VARIANT_TRUE Deskripsi: Driver OLE DB untuk kumpulan baris SQL Server tidak mendukung hak akses berdasarkan baris. Jika antarmuka IRowsetChange diekspos pada set baris, metode SetData dapat dipanggil oleh konsumen. |
| DBPROP_ROWSET_ASYNCH | R/W: Baca/tulis Default: 0 Deskripsi: Menyediakan pemrosesan set baris asinkron. Properti ini berada dalam grup properti Rowset dan kumpulan properti DBPROPSET_ROWSET. Jenisnya VT_14. Satu-satunya nilai dalam bitmask yang didukung oleh Driver OLE DB untuk SQL Server adalah DBPROPVAL_ASYNCH_INITIALIZE. |
| DBPROP_ROWTHREADMODEL | R/W: Baca-saja Default: DBPROPVAL_RT_FREETHREAD Deskripsi: Driver OLE DB untuk SQL Server mendukung akses ke objeknya dari beberapa utas eksekusi satu konsumen. |
| DBPROP_SERVERCURSOR | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Saat diatur, kursor SQL Server digunakan untuk mendukung set baris. Untuk informasi selengkapnya, lihat Kumpulan Baris dan kursor SQL Server. |
| DBPROP_SERVERDATAONINSERT | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Data server saat disisipkan. VARIANT_TRUE: Pada saat sisipan dikirimkan ke server, penyedia mengambil data dari server untuk memperbarui cache baris lokal. VARIANT_FALSE: Penyedia tidak mengambil nilai server untuk baris yang baru disisipkan. |
| DBPROP_STRONGIDENTITY | R/W: Baca-saja Default: VARIANT_TRUE Deskripsi: Identitas baris yang kuat. Jika sisipan diizinkan pada set baris ( IRowsetChange atau IRowsetUpdate adalah benar), dan DBPROP_UPDATABILITY diatur untuk mendukung InsertRows, nilai DBPROP_STRONGIDENTITY bergantung pada properti DBPROP_CHANGEINSERTEDROWS (akan VARIANT_FALSE jika nilai properti DBPROP_CHANGEINSERTEDROWS VARIANT_FALSE). |
| DBPROP_TRANSACTEDOBJECT | R/W: Baca-saja Default: VARIANT_FALSE Deskripsi: Driver OLE DB untuk SQL Server hanya mendukung objek yang ditransaksikan. Untuk mengetahui informasi selengkapnya, lihat Transformasi. |
| DBPROP_UNIQUEROWS | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Baris unik. VARIANT_TRUE: Setiap baris diidentifikasi secara unik oleh nilai kolomnya. Kumpulan kolom yang secara unik mengidentifikasi baris memiliki DBCOLUMNFLAGS_KEYCOLUMN yang diatur dalam struktur DBCOLUMNINFO yang dikembalikan dari metode GetColumnInfo . VARIANT_FALSE: Baris mungkin atau mungkin tidak diidentifikasi secara unik oleh nilai kolomnya. Kolom kunci mungkin atau mungkin tidak ditandai dengan DBCOLUMNFLAGS_KEYCOLUMN. |
| DBPROP_UPDATABILITY | R/W: Baca/tulis Default: 0 Deskripsi: Driver OLE DB untuk SQL Server mendukung semua nilai DBPROP_UPDATABILITY. Pengaturan DBPROP_UPDATABILITY tidak membuat set baris yang dapat dimodifikasi. Untuk membuat set baris dapat dimodifikasi, atur DBPROP_IRowsetChange atau DBPROP_IRowsetUpdate. |
Driver OLE DB untuk SQL Server menentukan properti khusus penyedia yang diatur DBPROPSET_SQLSERVERROWSET seperti yang ditunjukkan dalam tabel ini.
| ID Properti | Deskripsi |
|---|---|
| SSPROP_COLUMN_ID | Kolom: ColumnID R/W: Baca-saja Jenis: VT_U12 | VT_ARRAY Default: VT_EMPTY Deskripsi: Array nilai bilangan bulat yang mewakili posisi ordinal (berbasis 1) dari kolom hasil klausa COMPUTE dalam pernyataan T-SQL SELECT saat ini. Ini adalah Driver OLE DB untuk SQL Server setara dengan atribut SQL_CA_SS_COLUMN_ID ODBC. |
| SSPROP_DEFERPREPARE | Kolom: Tidak R/W: Baca/tulis Jenis: VT_BOOL Default: VARIANT_TRUE Deskripsi: VARIANT_TRUE: Dalam eksekusi yang disiapkan, persiapan perintah ditangguhkan hingga ICommand::Execute dipanggil atau operasi metaproperti dilakukan. Jika properti diatur ke VARIANT_FALSE: Pernyataan disiapkan ketika ICommandPrepare::P repare dijalankan. |
| SSPROP_IRowsetFastLoad | Kolom: Tidak R/W: Baca/tulis Jenis: VT_BOOL Default: VARIANT_FALSE Deskripsi: Atur properti ini ke VARIANT_TRUE untuk membuka kumpulan baris beban cepat melalui IOpenRowset::OpenRowset. Anda tidak dapat mengatur properti ini di ICommandProperties::SetProperties. |
| SSPROP_ISSAsynchStatus | Kolom: Tidak. R/W: Baca/tulis Jenis: VT_BOOL Default: VARIANT_FALSE Deskripsi: Atur properti ini ke VARIANT_TRUE untuk mengaktifkan operasi asinkron menggunakan antarmuka ISSAsynchStatus . |
| SSPROP_ISSDataClassification | R/W: Baca/tulis Jenis: VT_BOOL Default: VARIANT_TRUE Deskripsi: Driver OLE DB untuk SQL Server mendukung pengambilan informasi klasifikasi sensitivitas menggunakan antarmuka ISSDataClassification. |
| SSPROP_MAXBLOBLENGTH | Kolom: Tidak R/W: Baca/tulis Jenis: VT_I4 Default: Penyedia tidak membatasi ukuran teks yang dikembalikan oleh server dan nilai properti diatur ke maksimumnya. Misalnya, 2147483647. Deskripsi: Driver OLE DB untuk SQL Server menjalankan pernyataan SET TEXTSIZE untuk membatasi panjang data objek besar biner (BLOB) yang dikembalikan dalam pernyataan SELECT. |
| SSPROP_NOCOUNT_STATUS | Kolom: NoCount R/W: Baca-saja Jenis: VT_BOOL Default: VARIANT_FALSE Deskripsi: Nilai boolean yang mewakili status SET NOCOUNT ON/OFF di SQL Server: VARIANT_TRUE: saat MENGATUR NOCOUNT ON VARIANT_FALSE: saat MENGATUR NOCOUNT NONAKTIF |
| SSPROP_QP_NOTIFICATION_MSGTEXT | Kolom: Tidak R/W: Baca/tulis Jenis: VT_BSTR (1-2000 karakter diperbolehkan) Default: String kosong Deskripsi: Teks pesan pemberitahuan kueri. Ini ditentukan pengguna, dan tidak memiliki format yang ditentukan. |
| SSPROP_QP_NOTIFICATION_OPTIONS | Kolom: Tidak R/W: Baca/tulis Jenis: VT_BSTR Default: String kosong Deskripsi: Opsi pemberitahuan kueri. Ini ditentukan dalam string dengan name=value. Pengguna bertanggung jawab untuk membuat layanan dan membaca pemberitahuan dari antrean. Sintaksis string opsi pemberitahuan kueri adalah:service=<service-name>[;(local database=<database>|broker instance=<broker instance>)]Contohnya: service=mySSBService;local database=mydb |
| SSPROP_QP_NOTIFICATION_TIMEOUT | Kolom: Tidak R/W: Baca/tulis Jenis: VT_UI4 Default: 432000 detik (5 hari) Minimum: 1 detik Maksimum: 2^31-1 detik Deskripsi: Jumlah detik pemberitahuan kueri tetap aktif. |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk