Megosztás a következőn keresztül:


sp_columns_ex (Transact-SQL)

A következőkre vonatkozik:SQL Server

Visszaadja az oszlopinformációt, egy sort oszloponként, a megadott összekapcsolt szervertáblákhoz. sp_columns_ex csak az adott oszlop oszlopinformációját adja vissza, ha @column_name meg van jelölve.

Transact-SQL szintaxis konvenciók

Szemantika

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'

A linkelt szerver neve, amelyhez oszlopinformációt kell visszaadni. @table_servera sysname, alapértelmezett nélkül.

[ @table_name = ] N'table_name'

A táblázat neve, amelyhez az oszlop információit kell visszaadni. @table_name a sysname, alapértelmezettként NULL.

[ @table_schema = ] N'table_schema'

Az oszlopinformáció visszaküldésére szolgáló tábla séma neve. @table_schema a sysname, alapértelmezett értékével NULL.

[ @table_catalog = ] N'table_catalog'

Az a táblázat katalógusneve, amelyhez oszlopinformációt kell visszaadni. @table_catalog a sysname, alapértelmezetként NULL.

[ @column_name = ] N'column_name'

Az adatbázis oszlop neve, amelyhez információt kell adni. @column_name a sysname, alapértelmezettként NULL.

[ @ODBCVer = ] ODBCVer

Az ODBC verzió, amit használnak. @ODBCVerint, alapértelmezés 2. Ez az ODBC 2-es verzióját jelzi. Az érvényes értékek 2 vagy 3. A 2. és 3. verzió közötti viselkedésbeli különbségekről információért lásd az ODBC SQLColumns specifikációját.

Kódértékek visszaadása

Nincs.

Eredményhalmaz

Oszlop név Adattípus Description
TABLE_CAT sysname Táblázat vagy megtekintés minősítő név. Különböző adatbázis-alapú termékek háromrészes elnevezést támogatnak a táblákhoz (<qualifier>.<owner>.<name>). Az SQL Serverben ez az oszlop az adatbázis nevét képviseli. Egyes termékekben ez a tábla adatbázis környezetének szervernevét képviseli. Ez a mező lehet NULL.
TABLE_SCHEM sysname Tábla vagy tulajdonos név megtekintése. Az SQL Serverben ez az oszlop az adatbázis-felhasználó nevét jelöli, aki létrehozta a táblát. Ez a mező mindig értéket ad vissza.
TABLE_NAME sysname Táblázat vagy név megtekintése. Ez a mező mindig értéket ad vissza.
COLUMN_NAME sysname Oszlop neve, minden visszatért TABLE_NAME oszlophoz. Ez a mező mindig értéket ad vissza.
DATA_TYPE smallint Egy int érték, amely megfelel az ODBC típusú indikátoroknak. Ha ez egy olyan adattípus, amely nem leképezhető egy ODBC típusra, akkor ez az NULLérték . A natív adattípus név megjelenik az TYPE_NAME oszlopban.
TYPE_NAME Varchar(13) A karakterlánc, amely egy adattípust képvisel. Az alap DBMS ezt az adattípus nevet mutatja be.
COLUMN_SIZE int Jelentős számjegyek száma. Az oszlop visszatérési értéke PRECISION a 10-es alapban van.
BUFFER_LENGTH int Az adatok átviteli mérete.1
DECIMAL_DIGITS smallint A tizedespont jobb oldalán lévő számjegyek száma.
NUM_PREC_RADIX smallint A numerikus adattípusok alapja.
NULLABLE smallint Meghatározza a nullitást.

1 = NULL lehetséges.
0 = NOT NULL.
REMARKS Varchar(254) Ez a mező mindig visszaadja NULL.
COLUMN_DEF Varchar(254) Az oszlop alapértelmezett értéke.
SQL_DATA_TYPE smallint Az SQL adattípus értéke, ahogy az megjelenik a TYPE leíró mezőben. Ez az oszlop ugyanaz, mint az oszlop DATA_TYPE , kivéve a datetime és SQL-92 intervallum adattípusokat. Ez az oszlop mindig értéket ad vissza.
SQL_DATETIME_SUB smallint Altípuskód datetime és SQL-92 intervallum adattípusokhoz. Más adattípusok esetén ez az oszlop a -t adja.NULL
CHAR_OCTET_LENGTH int Egy karakter vagy egész szám adattípus oszlop maximális hossza bájtokban. Minden más adattípus esetén ez az oszlop a NULL.
ORDINAL_POSITION int Az oszlop sorrendi pozíciója a táblázatban. A táblázat első oszlopa 1. Ez az oszlop mindig értéket ad vissza.
IS_NULLABLE Varchar(254) Az oszlop nullabilitása a táblázatban. Az ISO szabályait betartják a nullibilitás meghatározására. Egy ISO SQL-kompatibilis adatbázis nem tud üres stringet visszaadni.

YES = Az oszlop tartalmazhatja NULL.
NO = Az oszlop nem tartalmazhat NULL.

Ez az oszlop nulla hosszúságú stringet ad vissza, ha nullitás ismeretlen.

Az adott oszlop által visszaadott érték eltér az oszlop által visszaadott NULLABLE értéktől.
SS_DATA_TYPE tinyint SQL Server adattípus, amelyet kiterjesztett tárolt eljárások használnak.

További információért lásd az ODBC áttekintését.

Megjegyzések

  • sp_columns_exúgy hajtják végre, hogy lekérdezik az COLUMNS OLE DB szolgáltató @table_server-nak megfelelő IDBSchemaRowset felületének sorhalmazát. Az @table_name, @table_schema, @table_catalog és @column_name paramétereket erre az interfészre továbbítják, hogy korlátozzák a visszatérő sorokat.

  • sp_columns_ex üres eredményhalmazt ad vissza, ha a megadott összekapcsolt szerver OLE DB szolgáltatója nem támogatja az COLUMNS interfeszt IDBSchemaRowset sorhalmazát.

  • sp_columns_ex követi a definiált azonosítók követelményeit. További információ: Adatbázis-azonosítók.

Permissions

Engedély SELECT szükséges a sémához.

Példák

A következő példa adja vissza a táblázat oszlopának HumanResources.Employee adattípusát JobTitle az AdventureWorks2025 adatbázisban a kapcsolt szerverenSeattle1.

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