Bagikan melalui


SQLSetDescRec

Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Topik ini membahas fungsionalitas SQLSetDescRec yang khusus untuk SQL Server Native Client.

Parameter SQLSetDescRec dan Table-Valued

SQLSetDescRec dapat digunakan untuk mengatur bidang deskriptor untuk parameter bernilai tabel dan kolom parameter bernilai tabel. Kolom parameter bernilai tabel hanya tersedia saat bidang header deskriptor SQL_SOPT_SS_PARAM_FOCUS diatur ke ordinal rekaman yang memiliki SQL_DESC_TYPE diatur ke SQL_SS_TABLE. Untuk informasi selengkapnya tentang SQL_SOPT_SS_PARAM_FOCUS, lihat SQLSetStmtAttr.

Tabel berikut ini menjelaskan pemetaan antara parameter dan bidang deskriptor.

Parameter Atribut terkait untuk jenis parameter bernilai non-tabel, termasuk kolom parameter bernilai tabel Atribut terkait untuk parameter bernilai tabel
Jenis SQL_DESC_TYPE SQL_SS_TABLE
SubType Diabaikan Untuk rekaman tipe SQL_DATETIME atau SQL_INTERVAL, atur ini ke SQL_DESC_DATETIME_INTERVAL_CODE.
Panjang SQL_DESC_OCTET_LENGTH Panjang nama jenis parameter bernilai tabel. Ini dapat SQL_NTS jika nama jenis dihentikan null, atau nol jika nama jenis parameter bernilai tabel tidak diperlukan.
Presisi SQL_DESC_PRECISION SQL_DESC_ARRAY_SIZE
Sisik SQL_DESC_SCALE Tidak digunakan. Parameter ini harus nol.
DataPtr SQL_DESC_DATA_PTR dalam APD SQL_CA_SS_TYPE_NAME

Parameter ini bersifat opsional untuk panggilan prosedur tersimpan, dan NULL dapat ditentukan jika tidak diperlukan. Parameter ini harus ditentukan untuk pernyataan SQL yang bukan panggilan prosedur.

DataPtr juga berfungsi sebagai nilai unik yang dapat digunakan aplikasi untuk mengidentifikasi parameter bernilai tabel ini saat pengikatan baris variabel digunakan.
StringLengthPtr SQL_DESC_OCTET_LENGTH_PTR SQL_DESC_OCTET_LENGTH_PTR

Untuk parameter bernilai tabel, ini adalah jumlah baris yang akan ditransfer atau SQL_DATA_AT_EXEC. Ini adalah penunjuk ke nilai yang menyimpan jumlah baris untuk ditransfer dengan SQLExecDirect.
IndicatorPtr SQL_DESC_INDICATOR_PTR SQL_DESC_INDICATOR_PTR

Untuk informasi selengkapnya tentang parameter bernilai tabel, lihat Parameter Bernilai Tabel (ODBC).

Dukungan SQLSetDescRec untuk Fitur Tanggal dan Waktu yang Ditingkatkan

Nilai yang diizinkan untuk jenis tanggal/waktu adalah sebagai berikut:

Atribut Jenis SubType Panjang Presisi Sisik
datetime SQL_DATETIME SQL_CODE_TIMESTAMP 4 3 3
smalldatetime SQL_SQL_DATETIME SQL_CODE_TIMESTAMP 8 0 0
date SQL_DATETIME SQL_CODE_DATE 6 0 0
waktu SQL_SS_TIME2 0 10 0..7 0..7
tanggalwaktu2 SQL_DATETIME SQL_CODE_TIMESTAMP 16 0..7 0..7
tanggalwaktulewat SQL_SS_TIMESTAMPOFFSET 0 20 0..7 0..7

Untuk informasi selengkapnya, lihat Peningkatan Tanggal dan Waktu (ODBC).

Dukungan SQLSetDescRec untuk UDT CLR Besar

SQLSetDescRec mendukung jenis yang ditentukan pengguna (UDT) CLR besar. Untuk informasi selengkapnya, lihat Jenis Yang Ditentukan Pengguna (ODBC) CLR Besar.

Lihat Juga

SQLSetDescRec
Detail Implementasi ODBC API