Bagikan melalui

sp_columns_ex (T-SQL)

  • Artikel

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 @column_name ditentukan.

Konvensi sintaks transact-SQL

Sintaks

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

Argumen

[ @table_server = ] N'table_server'

Nama server tertaut untuk mengembalikan informasi kolom. @table_server adalah sysname, tanpa default.

[ @table_name = ] N'table_name'

Nama tabel untuk mengembalikan informasi kolom. @table_name adalah sysname, dengan default NULL.

[ @table_schema = ] N'table_schema'

Nama skema tabel untuk mengembalikan informasi kolom. @table_schema adalah sysname, dengan default NULL.

[ @table_catalog = ] N'table_catalog'

Nama katalog tabel untuk mengembalikan informasi kolom. @table_catalog adalah sysname, dengan default NULL.

[ @column_name = ] N'column_name'

Nama kolom database untuk memberikan informasi. @column_name adalah sysname, dengan default NULL.

[ @ODBCVer = ] ODBCVer

Versi ODBC yang sedang digunakan. @ODBCVer 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 (<qualifier>.<owner>.<name>). Di SQL Server, kolom ini mewakili nama database. Dalam beberapa produk, ini mewakili nama server lingkungan database tabel. Bidang ini bisa berupa 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 yang TABLE_NAME dikembalikan. Bidang ini selalu mengembalikan nilai.
DATA_TYPE smallint Nilai int yang sesuai dengan indikator jenis ODBC. Jika ini adalah jenis data yang tidak dapat dipetakan ke jenis ODBC, nilai ini adalah NULL. Nama jenis data asli dikembalikan dalam TYPE_NAME kolom .
TYPE_NAME varchar(13) String yang mewakili jenis data. DBMS yang mendasar menyajikan nama jenis data ini.
COLUMN_SIZE int Jumlah digit signifikan. Nilai yang dikembalikan untuk PRECISION kolom 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 Basis untuk jenis data numerik.
NULLABLE smallint Menentukan nullability.

1 = NULL dimungkinkan.
0 = NOT NULL.
REMARKS varchar(254) Bidang ini selalu mengembalikan NULL.
COLUMN_DEF varchar(254) 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 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.

YES = Kolom dapat menyertakan NULL.
NO = 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, digunakan oleh prosedur tersimpan yang diperluas.

Untuk informasi selengkapnya, lihat Gambaran Umum ODBC.

Keterangan

  • sp_columns_ex dijalankan dengan mengkueri COLUMNS IDBSchemaRowset kumpulan baris antarmuka penyedia OLE DB yang sesuai dengan @table_server. Parameter @table_name, @table_schema, @table_catalog, dan @column_name 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 COLUMNS kumpulan baris IDBSchemaRowset antarmuka.

  • sp_columns_ex mengikuti persyaratan untuk pengidentifikasi yang dibatasi. Untuk informasi selengkapnya, lihat Pengidentifikasi database.

Izin

SELECT Memerlukan izin 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';

Konten terkait