Dela via

sp_columns_ex (Transact-SQL)

Gäller för:SQL Server

Returnerar kolumninformationen, en rad per kolumn, för de specificerade länkade servertabellerna. sp_columns_ex returnerar kolumninformation endast för den specifika kolumnen om @column_name är specificerad.

Transact-SQL syntaxkonventioner

Syntax

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'

Namnet på den länkade servern för vilken kolumninformation ska returneras. @table_server är sysname, utan standard.

[ @table_name = ] N'table_name'

Namnet på tabellen för vilken kolumninformation ska returneras. @table_name är sysname, med standardvärdet .NULL

[ @table_schema = ] N'table_schema'

Schemanamnet på tabellen för vilken kolumninformation ska returneras. @table_schema är sysname, med standardvärdet .NULL

[ @table_catalog = ] N'table_catalog'

Katalognamnet på tabellen för att returnera kolumninformation. @table_catalog är sysname, med standardvärdet .NULL

[ @column_name = ] N'column_name'

Namnet på databaskolumnen för vilken information ska tillhandahållas. @column_name är sysname, med standardvärdet .NULL

[ @ODBCVer = ] ODBCVer

Den version av ODBC som används. @ODBCVer är int, med standardvärdet .2 Detta indikerar ODBC version 2. Giltiga värden är 2 eller 3. För information om beteendeskillnaderna mellan version 2 och 3, se ODBC-specifikationen SQLColumns .

Returnera kodvärden

Ingen.

Resultatuppsättning

Kolumnnamn Datatyp Description
TABLE_CAT sysname Tabell eller visa kvalificeringsnamn. Olika DBMS-produkter stödjer tredelad namngivning för tabeller (<qualifier>.<owner>.<name>). I SQL Server representerar denna kolumn databasens namn. I vissa produkter representerar den servernamnet på tabellens databasmiljö. Detta fält kan vara NULL.
TABLE_SCHEM sysname Tabell- eller vyägarnamn. I SQL Server representerar denna kolumn namnet på databasanvändaren som skapade tabellen. Detta fält returnerar alltid ett värde.
TABLE_NAME sysname Tabell- eller vynamn. Detta fält returnerar alltid ett värde.
COLUMN_NAME sysname Kolumnnamn, för varje kolumn i den TABLE_NAME returnerade. Detta fält returnerar alltid ett värde.
DATA_TYPE smallint Ett int-värde som motsvarar ODBC-typindikatorer. Om detta är en datatyp som inte kan mappas till en ODBC-typ, är NULLdetta värde . Det ursprungliga datatypnamnet returneras i kolumnen TYPE_NAME .
TYPE_NAME Varchar(13) Sträng som representerar en datatyp. Det underliggande DBMS presenterar detta datatypnamn.
COLUMN_SIZE int Antal signifikanta siffror. Returvärdet för kolumnen PRECISION är i bas 10.
BUFFER_LENGTH int Överföringsstorleken på datan.1
DECIMAL_DIGITS smallint Antal siffror till höger om decimalpunkten.
NUM_PREC_RADIX smallint Basen för numeriska datatyper.
NULLABLE smallint Specificerar nullbarhet.

1 = NULL är möjligt.
0 = NOT NULL.
REMARKS Varchar(254) Detta fält returnerar NULLalltid .
COLUMN_DEF Varchar(254) Standardvärdet för kolumnen.
SQL_DATA_TYPE smallint Värdet på SQL-datatypen som den visas i TYPE fältet för beskrivaren. Denna kolumn är densamma som kolumnenDATA_TYPE, förutom datatyperna datetime och SQL-92-intervalldatatyperna. Denna kolumn returnerar alltid ett värde.
SQL_DATETIME_SUB smallint Subtypkod för datetime- och SQL-92-intervalldatatyper. För andra datatyper returnerar NULLdenna kolumn .
CHAR_OCTET_LENGTH int Maximal längd i byte av en kolumn för tecken eller heltalsdatatyp. För alla andra datatyper returnerar NULLdenna kolumn .
ORDINAL_POSITION int Ordningsposition för kolumnen i tabellen. Den första kolumnen i tabellen är 1. Denna kolumn returnerar alltid ett värde.
IS_NULLABLE Varchar(254) Nullbarhet för kolumnen i tabellen. ISO-regler följs för att avgöra nullbarhet. Ett ISO SQL-kompatibelt DBMS kan inte returnera en tom sträng.

YES = Kolumnen kan inkludera NULL.
NO = Kolumnen kan inte inkludera NULL.

Denna kolumn returnerar en sträng av nolllängd om nullbarhet är okänd.

Värdet som returneras för denna kolumn skiljer sig från värdet som returneras för kolumnen NULLABLE .
SS_DATA_TYPE tinyint SQL Server-datatyp, används av utökade lagrade procedurer.

För mer information, se ODBC Översikt.

Anmärkningar

  • sp_columns_ex exekveras genom att fråga radmängden COLUMNS i gränssnittet IDBSchemaRowset hos OLE DB-leverantören som motsvarar @table_server. Parametrarna @table_name, @table_schema, @table_catalog och @column_name skickas till detta gränssnitt för att begränsa raderna som returneras.

  • sp_columns_exreturnerar en tom resultatmängd om OLE DB-leverantören för den specificerade länkade servern inte stödjer gränssnittets IDBSchemaRowset raduppsättning.COLUMNS

  • sp_columns_ex följer kraven för avgränsade identifierare. Mer information finns i Databasidentifierare.

Permissions

Kräver SELECT tillstånd på schemat.

Examples

Följande exempel returnerar datatypen för kolumnen JobTitle i HumanResources.Employee tabellen i AdventureWorks2025 databasen på den länkade servern Seattle1.

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

Relaterat innehåll

  • Last updated on