sp_tables_ex (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server

Gibt Tabelleninformationen zu den Tabellen auf dem angegebenen Verbindungsserver zurück.

Syntax

sp_tables_ex
    [ @table_server = ] N'table_server'
    [ , [ @table_name = ] N'table_name' ]
    [ , [ @table_schema = ] N'table_schema' ]
    [ , [ @table_catalog = ] N'table_catalog' ]
    [ , [ @table_type = ] N'table_type' ]
    [ , [ @fUsePattern = ] fUsePattern ]
[ ; ]

Argumente

[ @table_server = ] N'table_server'

Der Name des verknüpften Servers, für den Tabelleninformationen zurückgegeben werden sollen. @table_server ist "sysname" ohne Standard.

[ @table_name = ] N'table_name'

Der Name der Tabelle, für die Datentypinformationen zurückgegeben werden sollen. @table_name ist "sysname" mit einem Standardwert von NULL.

[ @table_schema = ] N'table_schema'

Das Tabellenschema. @table_schema ist "sysname" mit der Standardeinstellung "NULL.

[ @table_catalog = ] N'table_catalog'

Der Name der Datenbank, in der sich die angegebene table_name befindet. @table_catalog ist "sysname" mit einem Standardwert von NULL.

[ @table_type = ] N'table_type'

Der Typ der zurückzugebenden Tabelle. @table_type ist "sysname" und kann einen der folgenden Werte aufweisen.

Wert	Beschreibung
`ALIAS`	Der Name eines Alias
`GLOBAL TEMPORARY`	Der Name einer systemweit verfügbaren temporären Tabelle
`LOCAL TEMPORARY`	Der Name einer nur für den aktuellen Auftrag verfügbaren temporären Tabelle
`SYNONYM`	Der Name eines Synonyms
`SYSTEM TABLE`	Der Name einer Systemtabelle
`SYSTEM VIEW`	Der Name einer Systemsicht
`TABLE`	Der Name einer Benutzertabelle
`VIEW`	Der Name einer Sicht

[ @fUsePattern = ] fUsePattern

Bestimmt, ob die Zeichen _, %, [und ] als Platzhalterzeichen interpretiert werden. Gültige Werte sind 0 (Mustervergleich ist deaktiviert) und 1 (Mustervergleich ist aktiviert). @fUsePattern ist bit, mit einem Standardwert von 1.

Rückgabecodewerte

Keine.

Resultset

Spaltenname	Datentyp	Beschreibung
`TABLE_CAT`	sysname	Der Name des Tabellenqualifizierers. Verschiedene DBMS-Produkte unterstützen die dreiteilige Benennung für Tabellen (`<qualifier>.<owner>.<name>`). In SQL Server stellt diese Spalte den Datenbanknamen dar. In einigen anderen Produkten stellt sie den Servernamen der Datenbankumgebung der Tabelle dar. Dieses Feld kann sein `NULL`.
`TABLE_SCHEM`	sysname	Der Name des Tabellenbesitzers. In SQL Server stellt diese Spalte den Namen des Datenbankbenutzers bzw. der Datenbankbenutzerin dar, der/die die Tabelle erstellt hat. Dieses Feld gibt immer einen Wert zurück.
`TABLE_NAME`	sysname	Tabellenname. Dieses Feld gibt immer einen Wert zurück.
`TABLE_TYPE`	varchar(32)	Tabelle, Systemtabelle oder Sicht.
`REMARKS`	varchar(254)	SQL Server gibt keinen Wert für diese Spalte zurück.

Hinweise

sp_tables_exwird durch Abfragen des TABLES-Rowset der IDBSchemaRowset Schnittstelle des OLE DB-Anbieters ausgeführt, der table_server entspricht. Die Parameter table_name, table_schema, table_catalog und Spalten werden an diese Schnittstelle übergeben, um die zurückgegebenen Zeilen einzuschränken.

sp_tables_ex gibt einen leeren Resultset zurück, wenn der OLE DB-Anbieter des angegebenen verknüpften Servers das TABLES Rowset der IDBSchemaRowset Schnittstelle nicht unterstützt.

Berechtigungen

Erfordert die SELECT-Berechtigung im Schema.

Beispiele

Im folgenden Beispiel werden Informationen zu den Tabellen zurückgegeben, die sich im HumanResources-Schema in der AdventureWorks2022-Datenbank auf dem verknüpften Server LONDON2 befinden.

EXEC sp_tables_ex @table_server = 'LONDON2',
@table_catalog = 'AdventureWorks2022',
@table_schema = 'HumanResources',
@table_type = 'TABLE';

Freigeben über