Aracılığıyla paylaş


sp_columns_ex (Transact-SQL)

Şunlar için geçerlidir: SQL Server

Belirlenen bağlı sunucu tabloları için sütun bilgisini, her sütun başına bir satır döner. sp_columns_ex eğer belirtilmişse, yalnızca belirli bir sütun için sütun bilgisi döner@column_name .

Transact-SQL söz dizimi kuralları

Sözdizimi

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 ]
[ ; ]

Arguments

[ @table_server = ] N'table_server'

Sütun bilgisinin döndürüleceği bağlı sunucunun adı. @table_serversysname'dir, varsayılan yoktur.

[ @table_name = ] N'table_name'

Sütun bilgisi döndürüleceği tablonun adı. @table_namesysname'dir ve varsayılan olarak .NULL

[ @table_schema = ] N'table_schema'

Sütun bilgisini döndürmek için tablonun şema adı. @table_schemasysname'dir ve varsayılan olarak .NULL

[ @table_catalog = ] N'table_catalog'

Sütun bilgisini döndürmek için tablonun katalog adı. @table_catalogsysname'dir ve varsayılan olarak .NULL

[ @column_name = ] N'column_name'

Bilgi sağlayacağınız veritabanı sütununun adı. @column_namesysname'dir ve varsayılan olarak .NULL

[ @ODBCVer = ] ODBCVer

Kullanılan ODBC versiyonu. @ODBCVerint, varsayılan olarak .2 Bu, ODBC Sürüm 2'yi gösteriyor. Geçerli değerler 2 veya 3. Sürüm 2 ve 3 arasındaki davranış farklılıkları hakkında bilgi için ODBC SQLColumns spesifikasyonuna bakınız.

Dönüş kodu değerleri

Yok.

Sonuç kümesi

Sütun adı Veri türü Description
TABLE_CAT sysname Tablo veya görünüm niteleyici adı. Çeşitli DBMS ürünleri, tablolar için üç bölümlü adlandırmayı destekler (<qualifier>.<owner>.<name>). SQL Server'da bu sütun, veritabanı adını temsil eder. Bazı ürünlerde, tablonun veritabanı ortamının sunucu adını temsil eder. Bu alan olabilir NULL.
TABLE_SCHEM sysname Tablo veya kullanıcı adını görüntüleyin. SQL Server'da bu sütun, tabloyu oluşturan veritabanı kullanıcısının adını temsil eder. Bu alan her zaman bir değer döndürür.
TABLE_NAME sysname Tablo veya isim görüntü. Bu alan her zaman bir değer döndürür.
COLUMN_NAME sysname Dönen her sütun TABLE_NAME için sütun adı. Bu alan her zaman bir değer döndürür.
DATA_TYPE smallint ODBC tip göstergelerine karşılık gelen bir int değeri. Eğer bu, ODBC tipine eşlenemeyen bir veri türüyse, bu değer .NULL Yerel veri tipi adı sütunda TYPE_NAME döner.
TYPE_NAME varchar(13) Bir veri türünü temsil eden bir dizimiz. Altta yatan DBMS bu veri tipi adını sunar.
COLUMN_SIZE int Önemli rakam sayısı. Sütunun geri dönüş değeri PRECISION taban 10'da.
BUFFER_LENGTH int Veri aktarım boyutu.1
DECIMAL_DIGITS smallint Ondalık noktanın sağındaki rakam sayısı.
NUM_PREC_RADIX smallint Sayısal veri türleri için temel.
NULLABLE smallint Nullability'yi belirtir.

1 = NULL mümkün.
0 = NOT NULL.
REMARKS varchar(254) Bu alan her zaman döner NULL.
COLUMN_DEF varchar(254) Sütunun varsayılan değeri.
SQL_DATA_TYPE smallint SQL veri türünün tanımlayıcı alanında göründüğü TYPE değeri. Bu sütun, DATA_TYPE ve SQL-92 aralığı veri türleri dışında sütunla aynıdır. Bu sütun her zaman bir değer döndürür.
SQL_DATETIME_SUB smallint Datetime ve SQL-92 aralıklı veri tipleri için alt tip kodu. Diğer veri türleri için ise bu sütun NULLdöndürür.
CHAR_OCTET_LENGTH int Bir karakter veya tam sayı veri tipi sütununun bayt cinsinden maksimum uzunluk. Diğer tüm veri türleri için bu sütun NULLdöndürür.
ORDINAL_POSITION int Tablodaki sütunun sırasal konumu. Tablodaki ilk sütun 1'dir. Bu sütun her zaman bir değer döndürür.
IS_NULLABLE varchar(254) Tablodaki sütunun sıfırlanabilirliği. ISO kuralları sıfırlanabilirliği belirlemek için uygulanır. ISO SQL uyumlu bir DBMS boş bir diziyi döndüremez.

YES = Sütun NULLiçinde bulunabilir.
NO = Sütun NULL.

Bu sütun, nullability bilinmiyorsa sıfır uzunlukta bir dizi döndürür.

Bu sütun için döndürülen değer, sütun NULLABLE için verilen değerden farklıdır.
SS_DATA_TYPE tinyint SQL Server veri türü, genişletilmiş depolanmış prosedürler tarafından kullanılır.

Daha fazla bilgi için ODBC Genel Bakışına bakınız.

Açıklamalar

  • sp_columns_exOLE DB sağlayıcısının arayüzünün @table_server'ye karşılık gelen satır IDBSchemaRowset kümesi sorgulanarak COLUMNS yürütülür. @table_name, @table_schema, @table_catalog ve @column_name parametreleri bu arayüze iletilerek geri dönen satırları kısıtlar.

  • sp_columns_exeğer belirtilen bağlantılı sunucunun OLE DB sağlayıcısı arayüzün IDBSchemaRowset sıra kümesini desteklemiyorsaCOLUMNS, boş bir sonuç kümesi döndürür.

  • sp_columns_ex sınırlandırılmış tanımlayıcılar için gereksinimleri takip eder. Daha fazla bilgi için bkz . Veritabanı tanımlayıcıları.

Permissions

Şema için izin gerekiyor SELECT .

Örnekler

Aşağıdaki örnek, bağlı sunucudaki Seattle1veritabanındaki tablonun AdventureWorks2025HumanResources.Employee sütununun veri tipini JobTitle döndürür.

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