SQLProcedureColumns
Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform 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.