Delen via

sp_columns_ex (Transact-SQL)

Van toepassing op:SQL Server

Geeft de kolominformatie, één rij per kolom, terug voor de gespecificeerde gekoppelde servertabellen. sp_columns_ex Geeft kolominformatie terug voor alleen de specifieke kolom als @column_name is gespecificeerd.

Transact-SQL syntaxis-conventies

Syntaxis

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'

De naam van de gekoppelde server waarvoor kolominformatie moet worden teruggegeven. @table_server is een systeemnaam, zonder standaard.

[ @table_name = ] N'table_name'

De naam van de tabel waarvoor kolominformatie moet worden teruggegeven. @table_name is een systeemnaam, met als standaard .NULL

[ @table_schema = ] N'table_schema'

De schemanaam van de tabel waarvoor kolominformatie moet worden teruggegeven. @table_schema is sysname, met als standaard .NULL

[ @table_catalog = ] N'table_catalog'

De catalogusnaam van de tabel waarvoor kolominformatie moet worden teruggegeven. @table_catalog is sysname, met als standaard .NULL

[ @column_name = ] N'column_name'

De naam van de databasekolom waarvoor informatie moet worden verstrekt. @column_name is systeemnaam, met als standaard NULL.

[ @ODBCVer = ] ODBCVer

De versie van ODBC die wordt gebruikt. @ODBCVer is int, met een standaard van 2. Dit duidt op ODBC Versie 2. Geldige waarden zijn 2 of 3. Voor informatie over de gedragsverschillen tussen versies 2 en 3, zie de ODBC-specificatie SQLColumns .

Codewaarden retourneren

Geen.

Resultaatset

Kolomnaam Gegevenstype Description
TABLE_CAT sysname Tabel of bekijk naam van de kwalificatie. Verschillende DBMS-producten ondersteunen drieledige naamgeving voor tabellen (<qualifier>.<owner>.<name>). In SQL Server vertegenwoordigt deze kolom de databasenaam. In sommige producten vertegenwoordigt het de servernaam van de databaseomgeving van de tabel. Dit veld kan zijn NULL.
TABLE_SCHEM sysname Naam van de eigenaar in de tabel of weergave. In SQL Server vertegenwoordigt deze kolom de naam van de databasegebruiker die de tabel heeft aangemaakt. Dit veld geeft altijd een waarde terug.
TABLE_NAME sysname Naam van de tabel of weergave. Dit veld geeft altijd een waarde terug.
COLUMN_NAME sysname Kolomnaam, voor elke kolom van de teruggestuurde kolom TABLE_NAME . Dit veld geeft altijd een waarde terug.
DATA_TYPE smallint Een int-waarde die overeenkomt met ODBC-type indicatoren. Als dit een datatype is dat niet aan een ODBC-type kan worden toegewezen, is NULLdeze waarde . De naam van het native datatype wordt in de TYPE_NAME kolom teruggegeven.
TYPE_NAME Varchar(13) String die een datatype vertegenwoordigt. Het onderliggende DBMS presenteert deze naam van het datatype.
COLUMN_SIZE int Aantal significante cijfers. De retourwaarde voor de PRECISION kolom staat in basis 10.
BUFFER_LENGTH int Overdrachtsgrootte van de data.1
DECIMAL_DIGITS smallint Aantal cijfers rechts van het decimale punt.
NUM_PREC_RADIX smallint De basis voor numerieke datatypes.
NULLABLE smallint Specificeert nullability.

1 = NULL is mogelijk.
0 = NOT NULL.
REMARKS Varchar(254) Dit veld geeft altijd .NULL
COLUMN_DEF Varchar(254) Standaardwaarde van de kolom.
SQL_DATA_TYPE smallint Waarde van het SQL-datatype zoals het verschijnt in het TYPE veld van de descriptor. Deze kolom is hetzelfde als de DATA_TYPE kolom, behalve voor de datatypes datetime en SQL-92 intervalgegevens . Deze kolom geeft altijd een waarde terug.
SQL_DATETIME_SUB smallint Subtypecode voor datetime- en SQL-92-intervaldatatypes. Voor andere datatypen geeft deze kolom .NULL
CHAR_OCTET_LENGTH int Maximale lengte in bytes van een kolom voor een teken of geheel getal datatype. Voor alle andere datatypen geeft deze kolom .NULL
ORDINAL_POSITION int Ordinaalpositie van de kolom in de tabel. De eerste kolom in de tabel is 1. Deze kolom geeft altijd een waarde terug.
IS_NULLABLE Varchar(254) Nulbaarheid van de kolom in de tabel. ISO-regels worden gevolgd om de nulliteit te bepalen. Een ISO-SQL-conforme DBMS kan geen lege string teruggeven.

YES= De kolom kan .NULL
NO = Kolom kan niet bevatten NULL.

Deze kolom geeft een string van nul lengte terug als de nullability onbekend is.

De waarde die voor deze kolom wordt geretourneerd verschilt van de waarde die voor de NULLABLE kolom wordt geretourneerd.
SS_DATA_TYPE tinyint SQL Server-datatype, gebruikt door uitgebreide opgeslagen procedures.

Voor meer informatie, zie ODBC Overzicht.

Opmerkingen

  • sp_columns_ex wordt uitgevoerd door de COLUMNS rijset van de IDBSchemaRowset interface van de OLE DB-provider die overeenkomt met @table_server te bevragen. De parameters @table_name, @table_schema, @table_catalog en @column_name worden aan deze interface doorgegeven om het aantal teruggegeven rijen te beperken.

  • sp_columns_ex geeft een lege resultaatset terug als de OLE DB-provider van de gespecificeerde gekoppelde server de COLUMNS rowset van de IDBSchemaRowset interface niet ondersteunt.

  • sp_columns_ex volgt de vereisten voor afgebakende identificaties. Zie Database-id's voor meer informatie.

Permissions

Vereist SELECT toestemming voor het schema.

Voorbeelden

Het volgende voorbeeld geeft het datatype terug van de JobTitle kolom van de HumanResources.Employee tabel in de AdventureWorks2025 database op de gekoppelde server Seattle1.

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

Verwante inhoud

  • Last updated on