Bagikan melalui

sp_sproc_columns (T-SQL)

  • Artikel

Berlaku untuk: Titik akhir analitik SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Platform System (PDW) SQL di Microsoft Fabric Warehouse di Microsoft Fabric

Mengembalikan informasi kolom untuk satu prosedur tersimpan atau fungsi yang ditentukan pengguna di lingkungan saat ini.

Konvensi sintaks transact-SQL

Sintaks

sp_sproc_columns
    [ [ @procedure_name = ] N'procedure_name' ]
    [ , [ @procedure_owner = ] N'procedure_owner' ]
    [ , [ @procedure_qualifier = ] N'procedure_qualifier' ]
    [ , [ @column_name = ] N'column_name' ]
    [ , [ @ODBCVer = ] ODBCVer ]
    [ , [ @fUsePattern = ] fUsePattern ]
[ ; ]

Argumen

[ @procedure_name = ] N'procedure_name'

Nama prosedur yang digunakan untuk mengembalikan informasi katalog. @procedure_name adalah nvarchar(390), dengan default %, yang berarti semua tabel dalam database saat ini. Pencocokan pola kartubebas didukung.

[ @procedure_owner = ] N'procedure_owner'

Nama pemilik prosedur. @procedure_owner adalah nvarchar(384), dengan default NULL. Pencocokan pola kartubebas didukung. Jika @procedure_owner tidak ditentukan, aturan visibilitas prosedur default dari sistem manajemen database (DBMS) yang mendasar berlaku.

Jika pengguna saat ini memiliki prosedur dengan nama yang ditentukan, informasi tentang prosedur tersebut dikembalikan. Jika @procedure_owner tidak ditentukan dan pengguna saat ini tidak memiliki prosedur dengan nama yang ditentukan, sp_sproc_columns cari prosedur dengan nama yang ditentukan yang dimiliki oleh pemilik database. Jika prosedur ada, informasi tentang kolomnya dikembalikan.

[ @procedure_qualifier = ] N'procedure_qualifier'

Nama kualifikasi prosedur. @procedure_qualifier adalah sysname, dengan default NULL. Berbagai produk DBMS mendukung penamaan tiga bagian untuk tabel (<qualifier>.<owner>.<name>). Di SQL Server, parameter ini mewakili nama database. Dalam beberapa produk, ini mewakili nama server lingkungan database tabel.

[ @column_name = ] N'column_name'

Satu kolom dan digunakan saat hanya satu kolom informasi katalog yang diinginkan. @column_name adalah nvarchar(384), dengan default NULL. Jika @column_name dihilangkan, semua kolom dikembalikan. Pencocokan pola kartubebas didukung. Untuk interoperabilitas maksimum, klien gateway harus mengasumsikan hanya pencocokan pola standar ISO (karakter % dan _ kartubebas).

[ @ODBCVer = ] ODBCVer

Versi ODBC yang digunakan. @ODBCVer int, dengan default 2, yang menunjukkan ODBC versi 2.0. Untuk informasi selengkapnya tentang perbedaan antara ODBC versi 2.0 dan ODBC versi 3.0, lihat spesifikasi ODBC SQLProcedureColumns untuk ODBC versi 3.0.

[ @fUsePattern = ] fUsePattern

Menentukan apakah karakter garis bawah (_), persen (%), dan tanda kurung ([ dan ]) ditafsirkan sebagai karakter kartubebas. @fUsePattern adalah bit, dengan default .1 Nilai yang valid adalah 0 (pencocokan pola nonaktif) dan 1 (pencocokan pola aktif).

Mengembalikan nilai kode

Tidak ada.

Tataan hasil

Nama kolom Jenis data Deskripsi
PROCEDURE_QUALIFIER nama sysname Nama kualifikasi prosedur. Kolom ini bisa berupa NULL.
PROCEDURE_OWNER nama sysname Nama pemilik prosedur. Kolom ini selalu mengembalikan nilai.
PROCEDURE_NAME nvarchar(134) Nama prosedur. Kolom ini selalu mengembalikan nilai.
COLUMN_NAME nama sysname Nama kolom untuk setiap kolom yang TABLE_NAME dikembalikan. Kolom ini selalu mengembalikan nilai.
COLUMN_TYPE smallint Bidang ini selalu mengembalikan nilai:

0 = SQL_PARAM_TYPE_UNKNOWN
1 = SQL_PARAM_TYPE_INPUT
2 = SQL_PARAM_TYPE_OUTPUT
3 = SQL_RESULT_COL
4 = SQL_PARAM_OUTPUT
5 = SQL_RETURN_VALUE
DATA_TYPE smallint Kode bilangan bulat untuk jenis data ODBC. Jika jenis data ini tidak dapat dipetakan ke jenis ISO, nilainya adalah NULL. Nama jenis data asli dikembalikan dalam TYPE_NAME kolom .
TYPE_NAME nama sysname Representasi string dari jenis data. Nilai ini adalah nama jenis data seperti yang disajikan oleh DBMS yang mendasar.
PRECISION int Jumlah digit signifikan. Nilai yang dikembalikan untuk PRECISION kolom berada di basis 10.
LENGTH int Ukuran transfer data.
SCALE smallint Jumlah digit di sebelah kanan titik desimal.
RADIX smallint Basis untuk jenis numerik.
NULLABLE smallint Menentukan nullability:

1 = Jenis data dapat dibuat yang memungkinkan nilai null.
0 = Nilai null tidak diperbolehkan.
REMARKS varchar(254) Deskripsi kolom prosedur. SQL Server tidak mengembalikan nilai untuk kolom ini.
COLUMN_DEF nvarchar(4000) Nilai default kolom.
SQL_DATA_TYPE smallint Nilai jenis data SQL seperti yang TYPE muncul di bidang deskriptor. Kolom ini sama DATA_TYPE dengan kolom, kecuali untuk jenis data interval datetime dan ISO. Kolom ini selalu mengembalikan nilai.
SQL_DATETIME_SUB smallint Subkode interval ISO tanggalwaktu jika nilai SQL_DATA_TYPE adalah SQL_DATETIME atau SQL_INTERVAL. Untuk jenis data selain interval datetime dan ISO, bidang ini adalah NULL.
CHAR_OCTET_LENGTH int Panjang maksimum dalam byte karakter atau kolom tipe data biner . Untuk semua jenis data lainnya, kolom ini mengembalikan NULL.
ORDINAL_POSITION int Posisi ordinal kolom dalam tabel. Kolom pertama dalam tabel adalah 1. Kolom ini selalu mengembalikan nilai.
IS_NULLABLE varchar(254) Nullability kolom dalam tabel. Aturan ISO diikuti untuk menentukan nullability. DBMS yang mematuhi ISO tidak dapat mengembalikan string kosong.

YES Menampilkan jika kolom dapat menyertakan null, dan NO jika kolom tidak dapat menyertakan null.

Kolom ini mengembalikan string panjang nol jika nullability tidak diketahui.

Nilai yang dikembalikan untuk kolom ini berbeda dari nilai yang dikembalikan untuk NULLABLE kolom.
SS_DATA_TYPE kecil Jenis data SQL Server yang digunakan oleh prosedur tersimpan yang diperluas. Untuk informasi selengkapnya, lihat Jenis data (Transact-SQL).

Keterangan

sp_sproc_columns setara dengan SQLProcedureColumns di ODBC. Hasil yang dikembalikan diurutkan oleh PROCEDURE_QUALIFIER, PROCEDURE_OWNER, PROCEDURE_NAME, dan urutan parameter muncul dalam definisi prosedur.

Izin

SELECT Memerlukan izin pada skema.

Konten terkait