Bagikan melalui


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.

Lihat Juga

Fungsi SQLProcedureColumns
Detail Implementasi ODBC API