sp_columns_ex (T-SQL)

Artikel
08/21/2023

Berlaku untuk:SQL Server

Mengembalikan informasi kolom, satu baris per kolom, untuk tabel server tertaut yang ditentukan. sp_columns_ex mengembalikan informasi kolom hanya untuk kolom tertentu jika kolom ditentukan.

Konvensi sintaks transact-SQL

Sintaks

  
sp_columns_ex [ @table_server = ] 'table_server'   
     [ , [ @table_name = ] 'table_name' ]   
     [ , [ @table_schema = ] 'table_schema' ]   
     [ , [ @table_catalog = ] 'table_catalog' ]   
     [ , [ @column_name = ] 'column' ]   
     [ , [ @ODBCVer = ] 'ODBCVer' ]

Argumen

[ @table_server = ] 'table_server' Adalah nama server tertaut untuk mengembalikan informasi kolom. table_server adalah sysname, tanpa default.

[ @table_name = ] 'table_name' Adalah nama tabel untuk mengembalikan informasi kolom. table_name adalah sysname, dengan default NULL.

[ @table_schema = ] 'table_schema' Adalah nama skema tabel untuk mengembalikan informasi kolom. table_schema adalah sysname, dengan default NULL.

[ @table_catalog = ] 'table_catalog' Adalah nama katalog tabel untuk mengembalikan informasi kolom. table_catalog adalah sysname, dengan default NULL.

[ @column_name = ] 'column' Adalah nama kolom database untuk memberikan informasi. kolom adalah sysname, dengan default NULL.

[ @ODBCVer = ] 'ODBCVer' Adalah versi ODBC yang sedang digunakan. ODBCVer adalah int, dengan default 2. Ini menunjukkan ODBC Versi 2. Nilai yang valid adalah 2 atau 3. Untuk informasi tentang perbedaan perilaku antara versi 2 dan 3, lihat spesifikasi ODBC SQLColumns.

Mengembalikan Nilai Kode

Tidak ada

Tataan Hasil

Nama kolom	Jenis data	Deskripsi
TABLE_CAT	nama sysname	Nama kualifikasi tabel atau tampilan. Berbagai produk DBMS mendukung penamaan tiga bagian untuk tabel (kualifikasi.pemilik.nama). Di SQL Server, kolom ini mewakili nama database. Dalam beberapa produk, ini mewakili nama server lingkungan database tabel. Bidang ini bisa NULL.
TABLE_SCHEM	nama sysname	Nama pemilik tabel atau tampilan. Di SQL Server, kolom ini mewakili nama pengguna database yang membuat tabel. Bidang ini selalu mengembalikan nilai.
TABLE_NAME	nama sysname	Nama tabel atau tampilan. Bidang ini selalu mengembalikan nilai.
COLUMN_NAME	nama sysname	Nama kolom, untuk setiap kolom TABLE_NAME dikembalikan. Bidang ini selalu mengembalikan nilai.
DATA_TYPE	smallint	Nilai bilangan bulat yang sesuai dengan indikator jenis ODBC. Jika ini adalah tipe data yang tidak dapat dipetakan ke tipe ODBC, nilai ini adalah NULL. Nama jenis data asli dikembalikan di kolom TYPE_NAME .
TYPE_NAME	varchar(13)	String yang mewakili jenis data. DBMS yang mendasar menyajikan nama jenis data ini.
COLUMN_SIZE	int	Jumlah digit signifikan. Nilai pengembalian untuk kolom PRECISION berada di basis 10.
BUFFER_LENGTH	int	Ukuran transfer data.1
DECIMAL_DIGITS	smallint	Jumlah digit di sebelah kanan titik desimal.
NUM_PREC_RADIX	smallint	Adalah basis untuk jenis data numerik.
NULLABLE	smallint	Menentukan nullability. 1 = NULL dimungkinkan. 0 = BUKAN NULL.
KOMENTAR	varchar(254)	Bidang ini selalu mengembalikan NULL.
COLUMN_DEF	varchar(254)	Nilai default kolom.
SQL_DATA_TYPE	smallint	Nilai jenis data SQL seperti yang muncul di bidang TYPE deskriptor. Kolom ini sama dengan kolom DATA_TYPE, kecuali untuk jenis data interval tanggalwaktu dan SQL-92. Kolom ini selalu mengembalikan nilai.
SQL_DATETIME_SUB	smallint	Kode subjenis untuk jenis data interval datetime dan SQL-92. Untuk jenis data lainnya, kolom ini mengembalikan NULL.
CHAR_OCTET_LENGTH	int	Panjang maksimum dalam byte kolom tipe data karakter atau bilangan bulat. 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 SQL tidak dapat mengembalikan string kosong. YA = Kolom dapat menyertakan NULLS. NO = Kolom tidak dapat menyertakan NULLS. Kolom ini mengembalikan string panjang nol jika nullability tidak diketahui. Nilai yang dikembalikan untuk kolom ini berbeda dari nilai yang dikembalikan untuk kolom NULLABLE .
SS_DATA_TYPE	kecil	Jenis data SQL Server, digunakan oleh prosedur tersimpan yang diperluas.

Untuk informasi selengkapnya, lihat dokumentasi Microsoft ODBC.

Keterangan

sp_columns_ex dijalankan dengan mengkueri kumpulan baris COLUMNS antarmuka IDBSchemaRowset penyedia OLE DB yang sesuai dengan table_server. Parameter table_name, table_schema, table_catalog, dan kolom diteruskan ke antarmuka ini untuk membatasi baris yang dikembalikan.
sp_columns_ex mengembalikan tataan hasil kosong jika penyedia OLE DB dari server tertaut yang ditentukan tidak mendukung kumpulan baris KOLOM antarmuka IDBSchemaRowset.
sp_columns_ex mengikuti persyaratan untuk pengidentifikasi yang dibatasi. Untuk informasi selengkapnya, lihat Pengidentifikasi Database.

Izin

Memerlukan izin SELECT pada skema.

Contoh

Contoh berikut mengembalikan tipe JobTitle data kolom HumanResources.Employee tabel dalam AdventureWorks2022 database di server Seattle1tertaut .

EXEC sp_columns_ex 'Seattle1',   
   'Employee',   
   'HumanResources',   
   'AdventureWorks2022',   
   'JobTitle';

Lihat Juga

sp_catalogs (T-SQL)
sp_foreignkeys (T-SQL)
sp_indexes (T-SQL)
sp_linkedservers (T-SQL)
sp_primarykeys (T-SQL)
sp_tables_ex (T-SQL)
sp_table_privileges (T-SQL)
Prosedur Tersimpan Sistem (Transact-SQL)

Bagikan melalui