Dukungan Jenis Parameter Bernilai Tabel OLE DB di Klien Asli SQL Server (Properti)

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

Topik ini menyediakan informasi tentang properti OLE DB dan kumpulan properti yang terkait dengan objek kumpulan baris parameter bernilai tabel.

Properti

Berikut ini adalah daftar properti yang diekspos melalui metode IRowsetInfo::GetProperties pada objek set baris parameter bernilai tabel. Perhatikan bahwa semua properti kumpulan baris parameter bernilai tabel bernilai baca-saja. Oleh karena itu, mencoba mengatur salah satu properti melalui IOpenRowset::OpenRowset atau ITableDefinitionWithConstraints::CreateTableWithConstraints metode ke nilai non-defaultnya akan mengakibatkan kesalahan, dan tidak ada objek yang akan dibuat.

Properti yang tidak diimplementasikan dalam objek himpunan baris parameter bernilai tabel tidak tercantum di sini. Untuk daftar lengkap properti, lihat dokumentasi OLE DB di Komponen Akses Data Windows.

ID Properti	Nilai
DBPROP_ABORTPRESERVE	VARIANT_TRUE
DBPROP_ACCESSORDER	DBPROPVAL_AO_RANDOM
DBPROP_BLOCKINGSTORAGEOBJECTS	VARIANT_TRUE
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS	R/W: Baca-saja Default: VARIANT_FALSE Deskripsi: Marka buku tidak diperbolehkan pada objek set baris parameter bernilai tabel.
DBPROP_BOOKMARKSKIPPED	VARIANT_FALSE
DBPROP_BOOKMARKTYPE	DBPROPVAL_BMK_NUMERIC
DBPROP_CANHOLDROWS	VARIANT_FALSE
DBPROP_CHANGEINSERTEDROWS	VARIANT_TRUE
DBPROP_COLUMNRESTRICT	VARIANT_FALSE
DBPROP_COMMANDTIMEOUT	0
DBPROP_COMMITPRESERVE	VARIANT_TRUE
DBPROP_DEFERRED	VARIANT_FALSE
DBPROP_DELAYSTORAGEOBJECTS	VARIANT_FALSE
DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo, DBPROP_IColumnsRowset	VARIANT_TRUE
DBPROP_IConnectionPointContainer DBPROP_IMultipleResults DBPROP_IRowsetUpdate DBPROP_IRowsetIdentity DBPROP_IRowsetLocate DBPROP_IRowsetScroll DBPROP_IRowsetResynch	VARIANT_FALSE
DBPROP_IRowsetChange	VARIANT_TRUE Catatan: Objek set baris parameter bernilai tabel mendukung antarmuka IRowsetChange. Set baris yang dibuat dengan menggunakan DBPROP_IRowsetChange sama dengan VARIANT_TRUE menunjukkan perilaku mode pembaruan langsung. Namun, jika kolom BLOB terikat sebagai objek ISequentialStream, konsumen diharapkan menyimpannya selama masa pakai objek set baris parameter bernilai tabel.
DBPROP_ISupportErrorInfo	VARIANT_TRUE
DBPROP_ISequentialStream	VARIANT_TRUE
DBPROP_IMMOBILEROWS	VARIANT_TRUE
DBPROP_LITERALIDENTITY	VARIANT_TRUE
DBPROP_LOCKMODE	DBPROPVAL_LM_NONE
DBPROP_MAXOPENROWS	0
DBPROP_MAXPENDINGROWS	0
DBPROP_MAXROWS	0
DBPROP_NOTIFICATIONPHASES	0
DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE	0
DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE	VARIANT_FALSE
DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE	VARIANT_TRUE
DBPROP_QUICKRESTART	VARIANT_TRUE
DBPROP_REENTRANTEVENTS	VARIANT_FALSE
DBPROP_REMOVEDELETED	VARIANT_TRUE
DBPROP_RETURNPENDINGINSERTS	VARIANT_TRUE
DBPROP_ROWRESTRICT	VARIANT_FALSE
DBPROP_ROWTHREADMODEL	DBPROPVAL_RT_FREETHREAD
DBPROP_SERVERCURSOR	VARIANT_FALSE
DBPROP_SERVERDATAONINSERT	VARIANT_FALSE
DBPROP_STRONGIDENTITY	VARIANT_TRUE
DBPROP_TRANSACTEDOBJECT	VARIANT_FALSE
DBPROP_UNIQUEROWS	VARIANT_FALSE
DBPROP_UPDATABILITY	DBPROPVAL_UP_CHANGE | DBPROPVAL_UP_DELETE | DBPROPVAL_UP_INSERT

Kumpulan Properti

Kumpulan properti berikut mendukung parameter bernilai tabel.

DBPROPSET_SQLSERVERCOLUMN

Properti ini digunakan oleh konsumen dalam proses pembuatan objek set baris parameter bernilai tabel dengan menggunakan ITableDefinitionWithConstraints::CreateTableWithConstraints untuk setiap kolom melalui struktur DBCOLUMNDESC, jika diperlukan.

ID Properti	Nilai Properti
SSPROP_COL_COMPUTED	R/W: Baca/Tulis Default: VARIANT_FALSE Jenis: VT_BOOL Deskripsi: Saat diatur ke VARIANT_TRUE, menunjukkan bahwa kolom adalah kolom komputasi. VARIANT_FALSE menunjukkan bahwa kolom tersebut bukan kolom komputasi.

DBPROPSET_SQLSERVERPARAMETER

Properti ini dibaca oleh konsumen saat menemukan informasi jenis parameter bernilai tabel dalam panggilan ke ISSCommandWithParameters::GetParameterProperties dan diatur oleh konsumen sambil mengatur properti tertentu tentang parameter bernilai tabel melalui ISSCommandWithParameters::SetParameterProperties.

Tabel berikut ini menyediakan deskripsi terperinci tentang properti ini.

ID Properti	Nilai Properti
SSPROP_PARAM_TYPE_TYPENAME	R/W: Baca/Tulis Default: VT_EMPTY Jenis: VT_BSTR Deskripsi: Konsumen menggunakan properti ini untuk mendapatkan atau mengatur nama jenis parameter bernilai tabel. Properti ini juga dapat digunakan dengan jenis yang ditentukan pengguna CLR. Properti ini secara opsional dapat ditentukan untuk memberikan nama jenis tabel untuk parameter bernilai tabel (dalam kasus perintah sintaks panggilan ODBC). Properti ini diperlukan untuk kueri SQL berparameter ad hoc.
SSPROP_PARAM_TYPE_SCHEMANAME	R/W: Baca/Tulis Default: VT_EMPTY Jenis: VT_BSTR Deskripsi: Konsumen menggunakan properti ini untuk mendapatkan atau mengatur nama skema jenis parameter bernilai tabel. Properti ini juga dapat digunakan dengan jenis yang ditentukan pengguna CLR.
SSPROP_PARAM_TYPE_CATALOGNAME	R/W: Baca saja Default: VT_EMPTY Jenis: VT_BSTR Deskripsi: Konsumen menggunakan properti ini untuk mendapatkan nama katalog dari jenis parameter bernilai tabel. Properti ini juga dapat digunakan dengan jenis yang ditentukan pengguna CLR. Ini adalah kesalahan untuk mengatur properti ini; jenis tabel yang ditentukan pengguna harus berada dalam database yang sama dengan parameter bernilai tabel yang menggunakannya.
SSPROP_PARAM_TABLE_DEFAULT_COLUMNS	R/W: Baca/Tulis Default: VT_EMPTY Jenis: VT_UI2 | VT_ARRAY Deskripsi: Konsumen menggunakan properti ini untuk menentukan kumpulan kolom mana dalam kumpulan baris yang akan diperlakukan sebagai default. Tidak ada nilai yang akan dikirim untuk kolom tersebut. Saat mengambil data dari objek kumpulan baris konsumen, penyedia tidak memerlukan pengikatan untuk kolom tersebut. Setiap elemen array harus merupakan ordinal kolom dalam objek set baris. Ordinal yang tidak valid akan mengakibatkan kesalahan pada waktu eksekusi perintah.
SSPROP_PARAM_TABLE_COLUMN_ORDER	R/W: Baca/Tulis Default: VT_EMPTY Jenis: VT_UI2 | VT_ARRAY Deskripsi: Properti ini digunakan oleh konsumen untuk memberikan petunjuk ke server untuk menunjukkan urutan pengurutan data kolom. Penyedia tidak melakukan validasi apa pun dan mengasumsikan bahwa konsumen sesuai dengan spesifikasi yang disediakan. Server menggunakan properti ini untuk melakukan pengoptimalan. Informasi urutan kolom untuk setiap kolom diwakili oleh sepasang elemen dalam array. Elemen pertama dalam pasangan adalah jumlah kolom. Elemen kedua dalam pasangan akan menjadi 1 untuk urutan naik atau 2 untuk urutan turun.

Lihat Juga

Dukungan Jenis Parameter Bernilai Tabel OLE DB
Menggunakan Parameter Bernilai Tabel (OLE DB)