sp_data_source_table_columns (Transact-SQL)

  • Artikel

Gilt für: SQL Server 2019 (15.x)

Gibt die Liste der Spalten in der externen Datenquellen-Tabelle zurück.

Hinweis

Dieses Verfahren wird in SQL 2019 CU5 eingeführt.

Transact-SQL-Syntaxkonventionen

Syntax

sp_data_source_table_columns
         [ @data_source = ] 'data_source'
       , [ @table_location = ] 'table_location'
[ ; ]

Argumente

[ @data_source = ] 'data_source'

Der Name der externen Datenquelle, aus der die Metadaten abgerufen werden sollen. Typ ist sysname.

[ @table_location = ] 'table_location'

Die Tabellen-Speicherortzeichenkette, die die Tabelle identifiziert. table_location Typ ist nvarchar(max).

Resultset

Die gespeicherte Prozedur gibt die folgenden Informationen zurück:

Spaltenname Datentyp Beschreibung
name nvarchar(max) Der Name der Spalte.
type nvarchar(200) Name des SQL Server-Typs.
length int Länge der Spalte.
precision int Genauigkeit der Spalte.
scale int Skalierung der Spalte.
collation nvarchar(200) SQL Serversortierung der Spalte.
is_nullable bit 1 = Nullwerte zulassend, 0 = Keine Nullwerte zulassend.
source_type_name nvarchar(max) Back-End-spezifischer Typ-Name. Wird hauptsächlich für das Debuggen verwendet. Für ODBC-Quellen entspricht source_type_name der Ergebnisspalte TYPE_NAME für SQLColumns().
remarks nvarchar(max) Allgemeine Kommentare oder Beschreibung der Spalte. Aktuell immer NULL.

Berechtigungen

Erfordert die ALTER ANY EXTERNAL DATA SOURCE-Berechtigung.

Hinweise

Auf der SQL Server-Instanz muss die PolyBase-Funktion installiert sein.

Diese gespeicherte Prozedur unterstützt Connectors für:

  • SQL Server
  • Oracle
  • Teradata
  • MongoDB
  • Azure Cosmos DB

Die gespeicherte Prozedur unterstützt keine generische ODBC-Datenquelle oder Hadoop-Connectors.

Der Begriff „leer“ (statt „nicht leer“) bezieht sich auf das Verhalten des ODBC-Treibers und der Funktion SQLTables. Nicht leer gibt an, dass ein Objekt Tabellen und keine Zeilen enthält. Beispielsweise enthält ein leeres Schema keine Tabellen in SQL Server. Eine leere Datenbank enthält keine Tabellen innerhalb von Teradata. Die Ergebnisse sind eine SQL Server-Darstellung des Back-End-Schemas, die vom PolyBase-Konnektor für das Back-End interpretiert wird. Der Unterschied besteht darin, dass die Ergebnisse des ODBC-Aufrufs an das Back-End nicht nur übergeben werden, sondern auf dem Ergebnis des PolyBase-Typ-Zuordnungs-Codes basieren.

Verwenden Sie sp_data_source_objects und sp_data_source_table_columns, um externe Objekte zu ermitteln. Diese vom System gespeicherten Prozeduren geben das Schema von Tabellen zurück, die zur Virtualisierung verfügbar stehen. Azure Data Studio verwendet diese beiden gespeicherten Prozeduren zur Unterstützung der Datenvirtualisierung. Verwenden Sie sp_data_source_table_columns, um externe Tabellen-Schemas zu ermitteln, die in SQL Server-Datentypen dargestellt sind.

Aufgrund von Unterschieden zwischen Sortierungen in Hadoop-Quelldaten und unterstützten Sortierungen in SQL Server 2019 (15.x) sind die empfohlenen Datentyp-Längen für Spalten vom Datentyp varchar in externen Tabellen möglicherweise viel größer als erwartet. Es handelt sich hierbei um ein beabsichtigtes Verhalten.

Oracle-Synonyme werden für die Verwendung mit PolyBase nicht unterstützt.

Beispiele

Im folgenden Beispiel werden die Tabellenspalten für eine externe Tabelle in einem SQL Server-Namen server zurückgegeben, der zu einem Schema namens schema gehört.

DECLARE @data_source SYSNAME = N'ExternalDataSourceName';
DECLARE @table_location NVARCHAR(400) = N'[database].[schema].[table]';

EXEC sp_data_source_table_columns
    @data_source,
    @table_location;

Zugehöriger Inhalt