sp_columns_ex (Transact-SQL)
Gilt für:SQL Server
Gibt die Spalteninformationen (eine Zeile pro Spalte) für die angegebenen Verbindungsservertabellen zurück. sp_columns_ex gibt Spalteninformationen nur für die bestimmte Spalte zurück, wenn spalte angegeben ist.
Transact-SQL-Syntaxkonventionen
Syntax
sp_columns_ex [ @table_server = ] 'table_server'
[ , [ @table_name = ] 'table_name' ]
[ , [ @table_schema = ] 'table_schema' ]
[ , [ @table_catalog = ] 'table_catalog' ]
[ , [ @column_name = ] 'column' ]
[ , [ @ODBCVer = ] 'ODBCVer' ]
Argumente
[ @table_server = ] 'table_server'
Der Name des Verbindungsservers, für den Spalteninformationen zurückgegeben werden sollen. table_server ist "sysname" ohne Standardwert.
[ @table_name = ] 'table_name'
Der Name der Tabelle, für die Spalteninformationen zurückgegeben werden sollen. table_name ist sysname mit dem Standardwert NULL.
[ @table_schema = ] 'table_schema'
Der Schemaname der Tabelle, für die Spalteninformationen zurückgegeben werden sollen. table_schema ist sysname mit dem Standardwert NULL.
[ @table_catalog = ] 'table_catalog'
Der Katalogname der Tabelle, für die Spalteninformationen zurückgegeben werden sollen. table_catalog ist sysname mit dem Standardwert NULL.
[ @column_name = ] 'column'
Der Name der Datenbankspalte, für die Informationen bereitgestellt werden sollen. column ist sysname mit dem Standardwert NULL.
[ @ODBCVer = ] 'ODBCVer'
Die verwendete ODBC-Version. ODBCVer ist int mit dem Standardwert 2. Dieser gibt ODBC, Version 2, an. Gültige Werte sind 2 oder 3. Informationen zu den Verhaltensunterschieden zwischen den Versionen 2 und 3 finden Sie in der SQLColumns-Spezifikation von ODBC.
Rückgabecodewerte
Keine
Resultsets
Spaltenname | Datentyp | BESCHREIBUNG |
---|---|---|
TABLE_CAT | sysname | Der Name des Qualifizierers für die Tabelle oder Sicht. Verschiedene DBMS-Produkte unterstützen die dreiteilige Benennung von Tabellen (Qualifizierer.besitzer.Name). In SQL Server stellt diese Spalte den Datenbanknamen dar. Bei anderen Produkten stellt sie den Servernamen der Datenbankumgebung für die Tabelle dar. Dieses Feld kann den Wert NULL annehmen. |
TABLE_SCHEM | sysname | Der Name des Besitzers der Tabelle oder Sicht. In SQL Server stellt diese Spalte den Namen des Datenbankbenutzers dar, der die Tabelle erstellt hat. Dieses Feld gibt immer einen Wert zurück. |
TABLE_NAME | sysname | Der Name der Tabelle oder Sicht. Dieses Feld gibt immer einen Wert zurück. |
COLUMN_NAME | sysname | Spaltenname für jede Spalte der zurückgegebenen TABLE_NAME . Dieses Feld gibt immer einen Wert zurück. |
DATA_TYPE | smallint | Ein Wert für eine ganze Zahl, der den ODBC-Datentypbezeichnern entspricht. Bei einem Datentyp, der keinem ODBC-Datentyp zugeordnet werden kann, wird der Wert NULL zurückgegeben. Der name des nativen Datentyps wird in der Spalte TYPE_NAME zurückgegeben. |
TYPE_NAME | varchar(13) | Die Zeichenfolge, die den Datentyp darstellt. Den Datentypnamen stellt das zugrunde liegende DBMS bereit. |
COLUMN_SIZE | int | Die Anzahl von signifikanten Stellen. Der Rückgabewert für die Spalte PRECISION befindet sich in Basis 10. |
BUFFER_LENGTH | int | Die Übertragungsgröße der Daten.1 |
DECIMAL_DIGITS | smallint | Die Anzahl der Ziffern rechts vom Dezimalzeichen |
NUM_PREC_RADIX | smallint | Die Basis für numerische Datentypen. |
NULLABLE | smallint | Gibt die NULL-Zulässigkeit an. 1 = NULL ist möglich 0 = NOT NULL |
HINWEISE | varchar(254) | Dieses Feld gibt immer NULL zurück. |
COLUMN_DEF | varchar(254) | Standardwert der Spalte |
SQL_DATA_TYPE | smallint | Der Wert des SQL-Datentyps, wie er im TYPE-Feld des Deskriptors angezeigt wird. Diese Spalte entspricht der spalte DATA_TYPE, mit Ausnahme der datetime- und SQL-92-Intervalldatentypen. Diese Spalte gibt immer einen Wert zurück. |
SQL_DATETIME_SUB | smallint | Untertypcode für datetime- und SQL-92-Intervalldatentypen. Bei allen anderen Datentypen gibt diese Spalte NULL zurück. |
CHAR_OCTET_LENGTH | int | Die maximale Länge (in Byte) einer Spalte eines Zeichendatentyps oder eines ganzzahligen Datentyps. Für alle anderen Datentypen gibt diese Spalte NULL zurück. |
ORDINAL_POSITION | int | Die Position einer Spalte innerhalb der Tabelle. Die erste Spalte in der Tabelle ist "1". Diese Spalte gibt immer einen Wert zurück. |
IS_NULLABLE | varchar(254) | Nullability der Spalte in der Tabelle. Die NULL-Zulässigkeit wird gemäß den ISO-Regeln bestimmt. Ein DBMS nach ISO SQL kann keine leere Zeichenfolge zurückgeben. YES = Spalte kann NULL-Werte enthalten. NO = Spalte kann keine NULL-Werte enthalten. Die Spalte gibt eine leere Zeichenfolge zurück, wenn die NULL-Zulässigkeit unbekannt ist. Der für diese Spalte zurückgegebene Wert unterscheidet sich von dem Wert, der für die NULLABLE-Spalte zurückgegeben wird. |
SS_DATA_TYPE | tinyint | SQL Server Datentyp, der von erweiterten gespeicherten Prozeduren verwendet wird. |
Weitere Informationen finden Sie in der Microsoft ODBC-Dokumentation.
Bemerkungen
sp_columns_ex wird ausgeführt, indem das COLUMNS-Rowset der IDBSchemaRowset-Schnittstelle des OLE DB-Anbieters entsprechend table_server. Die Parameter table_name, table_schema, table_catalog und Spalten werden an diese Schnittstelle übergeben, um die zurückgegebenen Zeilen einzuschränken.
sp_columns_ex gibt ein leeres Resultset zurück, wenn der OLE DB-Anbieter des angegebenen Verbindungsservers das COLUMNS-Rowset der IDBSchemaRowset-Schnittstelle nicht unterstützt.
sp_columns_ex folgt den Anforderungen für durch Trennzeichen getrennte Bezeichner. Weitere Informationen finden Sie unter Datenbankbezeichner.
Berechtigungen
Erfordert SELECT-Berechtigung für das Schema.
Beispiele
Im folgenden Beispiel wird der Datentyp der JobTitle
-Spalte der HumanResources.Employee
-Tabelle in der AdventureWorks2022
-Datenbank auf dem Seattle1
-Verbindungsserver zurückgegeben.
EXEC sp_columns_ex 'Seattle1',
'Employee',
'HumanResources',
'AdventureWorks2022',
'JobTitle';
Weitere Informationen
sp_catalogs (Transact-SQL)
sp_foreignkeys (Transact-SQL)
sp_indexes (Transact-SQL)
sp_linkedservers (Transact-SQL)
sp_primarykeys (Transact-SQL)
sp_tables_ex (Transact-SQL)
sp_table_privileges (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für