Bidang Deskriptor untuk Kolom Konstituen Parameter Table-Valued

  • Artikel

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

Bidang deskriptor parameter bernilai tabel yang dijelaskan di bagian ini dimanipulasi dengan menggunakan SQLSetDescField dan SQLSetDescField dengan handel untuk deskriptor parameter implementasi (IPD).

Keterangan

SQL_DESC_AUTO_UNIQUE_VALUE digunakan untuk parameter bernilai tabel serta fitur lainnya.

Nama atribut Jenis Deskripsi
SQL_DESC_AUTO_UNIQUE_VALUE SQLINTEGER SQL_TRUE menunjukkan bahwa kolom ini adalah kolom identitas.

SQL Server dapat menggunakan informasi ini untuk mengoptimalkan performa, tetapi aplikasi tidak diperlukan untuk mengaturnya untuk kolom identitas.

Atribut berikut ditambahkan ke semua jenis parameter dalam deskriptor parameter aplikasi (APD) dan deskriptor parameter implementasi (IPD):

Nama atribut Jenis Deskripsi
SQL_CA_SS_COLUMN_COMPUTED SQLSMALLINT SQL_TRUE menunjukkan bahwa kolom ini dihitung.

SQL Server dapat menggunakan informasi ini untuk mengoptimalkan performa, tetapi aplikasi tidak diperlukan untuk mengaturnya untuk kolom komputasi.

Atribut ini diabaikan untuk pengikatan yang bukan kolom parameter bernilai tabel.
SQL_CA_SS_COLUMN_IN_UNIQUE_KEY SQLSMALLINT SQL_TRUE menunjukkan bahwa kolom parameter bernilai tabel berpartisipasi dalam kunci unik. Ini dapat menghasilkan performa kueri yang lebih baik. Atribut ini diabaikan untuk pengikatan yang bukan kolom parameter bernilai tabel.
SQL_CA_SS_COLUMN_SORT_ORDER SQLSMALLINT Menunjukkan susunan urutan kolom parameter bernilai tabel. Ini dapat menghasilkan performa kueri yang lebih baik. Atribut ini diabaikan untuk pengikatan yang bukan kolom parameter bernilai tabel. Nilai yang mungkin adalah sebagai berikut:
SQL_SS_ASCENDING_ORDER
SQL_SS_DESCENDING_ORDER
SQL_SS_ORDER_UNSPECIFIED

Nilai selain SQL_SS_ASCENDING_ORDER dan SQL_SS_DESCENDING_ORDER menghasilkan kesalahan dengan SQLSTATE HY024 dan pesan 'Nilai atribut tidak valid' dan diperlakukan sebagai SQL_SS_ORDER_UNSPECIFIED, yang merupakan nilai default untuk atribut ini.
SQL_CA_SS_COLUMN_SORT_ORDINAL SQLSMALLINT Menunjukkan ordinal kolom parameter bernilai tabel dalam kumpulan kolom yang menentukan urutan keseluruhan untuk parameter bernilai tabel. Ini dapat menghasilkan performa kueri yang lebih baik. Atribut ini diabaikan untuk pengikatan yang bukan kolom parameter bernilai tabel. Urutkan ordinal dimulai dari 1. Nilai 0, default, menunjukkan bahwa kolom parameter bernilai tabel tidak memiliki urutan kolom.
SQL_CA_SS_COLUMN_HAS_DEFAULT_VALUE SQLSMALLINT Menunjukkan apakah semua baris dalam parameter bernilai tabel akan memiliki nilai default untuk kolom ini. Untuk parameter bernilai tabel, tidak dimungkinkan untuk memilih nilai default berdasarkan baris demi baris. Nilai SQL_FALSE menunjukkan bahwa baris akan memiliki nilai non-default. Ini adalah default. Nilai SQL_TRUE menunjukkan bahwa kolom ini akan memiliki nilai default untuk semua baris.

Jika diatur ke SQL_TRUE, tidak ada data yang akan dikirim ke server.

Bidang ini juga dapat digunakan dengan identitas atau kolom komputasi jika nilai kolom tidak diperlukan untuk pemrosesan server.

Atribut ini hanya valid untuk kolom parameter bernilai tabel. Mereka diabaikan untuk parameter lain.

Jika SQL_CA_SS_COL_HAS_DEFAULT_VALUE diatur untuk kolom parameter bernilai tabel, SQL_DESC_DATA_PTR untuk kolom tersebut harus berupa penunjuk null. Jika tidak, SQLExecute atau SQLExecDirect akan mengembalikan SQL_ERROR. Rekaman diagnostik akan dihasilkan dengan SQLSTATE=07S01 dan pesan "Penggunaan parameter default tidak valid untuk parameter <p>, kolom <c>", di mana <p> adalah parameter ordinal dan <c> adalah ordinal kolom.

Lihat juga

Parameter Bernilai Tabel (ODBC)