SQLProcedureColumns

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

SQLProcedureColumns mengembalikan satu baris yang melaporkan atribut nilai pengembalian dari semua prosedur tersimpan SQL Server.

SQLProcedureColumns mengembalikan SQL_SUCCESS apakah ada nilai untuk parameter CatalogName, SchemaName, ProcName, atau ColumnName atau tidak. SQLFetch mengembalikan SQL_NO_DATA ketika nilai yang tidak valid digunakan dalam parameter ini.

SQLProcedureColumns dapat dijalankan pada kursor server statis. Upaya untuk menjalankan SQLProcedureColumns pada kursor yang dapat diperbarui (dinamis atau set kunci) akan mengembalikan SQL_SUCCESS_WITH_INFO menunjukkan bahwa jenis kursor telah diubah.

Tabel berikut mencantumkan kolom yang dikembalikan oleh kumpulan hasil dan bagaimana kolom tersebut telah diperluas untuk menangani jenis data udt dan xml melalui driver ODBC Klien Asli SQL Server:

Nama kolom	Deskripsi
SS_UDT_CATALOG_NAME	Mengembalikan nama katalog yang berisi UDT (jenis yang ditentukan pengguna).
SS_UDT_SCHEMA_NAME	Mengembalikan nama skema yang berisi UDT.
SS_UDT_ASSEMBLY_TYPE_NAME	Mengembalikan nama UDT yang memenuhi syarat rakitan.
SS_XML_SCHEMACOLLECTION_CATALOG_NAME	Mengembalikan nama katalog tempat nama kumpulan skema XML ditentukan. Jika nama katalog tidak dapat ditemukan, maka variabel ini berisi string kosong.
SS_XML_SCHEMACOLLECTION_SCHEMA_NAME	Mengembalikan nama skema tempat nama kumpulan skema XML ditentukan. Jika nama skema tidak dapat ditemukan, maka variabel ini berisi string kosong.
SS_XML_SCHEMACOLLECTION_NAME	Mengembalikan nama kumpulan skema XML. Jika nama tidak dapat ditemukan, maka variabel ini berisi string kosong.

Parameter SQLProcedureColumns dan Table-Valued

SQLProcedureColumns menangani parameter bernilai tabel dengan cara yang mirip dengan jenis yang ditentukan pengguna CLR. Dalam baris yang dikembalikan untuk parameter bernilai tabel, kolom memiliki nilai berikut:

Nama kolom	Deskripsi/nilai
DATA_TYPE	SQL_SS_TABLE
TYPE_NAME	Nama jenis tabel untuk parameter bernilai tabel.
COLUMN_SIZE	NULL
BUFFER_LENGTH	0
DECIMAL_DIGITS	Jumlah kolom dalam parameter bernilai tabel.
NUM_PREC_RADIX	NULL
NULLABLE	SQL_NULLABLE
REMARKS	NULL
COLUMN_DEF	NULL. Tipe tabel mungkin tidak memiliki nilai default.
SQL_DATA_TYPE	SQL_SS_TABLE
SQL_DATEIME_SUB	NULL
CHAR_OCTET_LENGTH	NULL
IS_NULLABLE	"YA"
SS_TYPE_CATALOG_NAME	Mengembalikan nama katalog yang berisi tabel atau tipe yang ditentukan pengguna CLR.
SS_TYPE_SCHEMA_NAME	Mengembalikan nama skema yang berisi tabel atau jenis yang ditentukan pengguna CLR.

Kolom SS_TYPE_CATALOG_NAME dan SS_TYPE_SCHEMA_NAME tersedia di SQL Server 2008 (10.0.x) dan versi yang lebih baru untuk mengembalikan katalog dan skema, masing-masing, untuk parameter bernilai tabel. Kolom ini diisi untuk parameter bernilai tabel, dan juga untuk parameter jenis yang ditentukan pengguna CLR. (Kolom skema dan katalog yang ada untuk parameter jenis yang ditentukan pengguna CLR tidak terpengaruh oleh fungsionalitas tambahan ini. Mereka juga diisi untuk menjaga kompatibilitas mundur).

Sesuai dengan spesifikasi ODBC, SS_TYPE_CATALOG_NAME dan SS_TYPE_SCHEMA_NAME muncul sebelum semua kolom khusus driver ditambahkan di versi SQL Server sebelumnya, dan setelah semua kolom yang diamanatkan oleh ODBC itu sendiri.

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

Dukungan SQLProcedureColumns untuk Fitur Tanggal dan Waktu yang Ditingkatkan

Untuk nilai yang dikembalikan untuk jenis tanggal/waktu, lihat Metadata Katalog.

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

Dukungan SQLProcedureColumns untuk UDT CLR Besar

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

Lihat Juga

Fungsi SQLProcedureColumns
Detail Implementasi ODBC API