Metadatenfunktionen (Transact-SQL)

Gilt für:SQL ServerAzure SQL Managed Instance

In diesem Artikel werden skalare Funktionen beschrieben, die Informationen zu Datenbank- und Datenbankobjekten zurückgeben.

Alle Metadatenfunktionen sind nicht deterministisch. Sie geben nicht immer dieselben Ergebnisse jedes Mal zurück, wenn sie aufgerufen werden, auch mit demselben Satz von Eingabewerten.

Server-, Datenbank-, Sitzungs- und Prinzipalkontextmetadaten

Erfahren Sie, wo Sie ausgeführt werden (Instanz und Datenbank) und wer Sie als oder über (Clientanwendung, Datenbankprinzipal) ausführen. Verwenden Sie diese Informationen für umgebungsfähige Skripts und Diagnosen.

Funktion	Description
SERVERPROPERTY	Gibt Eigenschaften der SQL Server-Instanz zurück, z. B. Edition, Sortierung oder Produktebene.
DB_ID	Gibt die ID einer Datenbank zurück.
DB_NAME	Gibt den Namen einer Datenbank mit der ID zurück.
DATABASEPROPERTYEX	Gibt Eigenschaftswerte auf Datenbankebene zurück, z. B. Sortierung und Status.
ORIGINAL_DB_NAME	Gibt den ursprünglichen Datenbanknamen vor einer Wiederherstellungssequenz zurück.
APP_NAME	Gibt den Anwendungsnamen für die aktuelle Sitzung zurück.
DATABASE_PRINCIPAL_ID	Gibt die Prinzipal-ID für einen Datenbanksicherheitsprinzipal zurück.
VERSION	Gibt die Versionszeichenfolge für Azure Synapse Analytics and Analytics Platform System (PDW) zurück.

¹Gilt nur für: Nur Azure Synapse Analytics and Analytics Platform System (PDW)

Objektidentifikation und Namensauflösung

Auflösen von IDs in Namen über Objekte und Schemas hinweg und Analysieren von mehrteiligen Bezeichnern. Diese Funktionen bieten Kernunterstützung für die Introspection und dynamische SQL.

Funktion	Description
OBJECT_ID	Gibt die ID für ein Schemabereichsobjekt zurück.
OBJECT_NAME	Gibt den Objektnamen für eine Objekt-ID zurück.
OBJECT_SCHEMA_NAME	Gibt den Schemanamen eines Objekts zurück.
SCHEMA_ID	Gibt die ID eines Schemas zurück.
SCHEMA_NAME	Gibt den Namen eines Schemas nach ID zurück.
PARSENAME	Gibt einen Teil eines mehrteiligen Objektnamens zurück (Server, Datenbank, Schema, Objekt).
@@PROCID	Gibt die ID der aktuell ausgeführten gespeicherten Prozedur zurück.

Objektfunktionen und Programmierbarkeitsmetadaten

Überprüfen Sie, was ein Objekt ist, wie es sich verhält und wie es implementiert wird. Diese Überprüfung umfasst die Definition und Eigenschaften sowie CLR-Assemblymetadaten.

Funktion	Description
OBJECT_DEFINITION	Gibt die Definition (Quelltext) von programmierbaren Objekten zurück.
OBJECTPROPERTY	Gibt eine Eigenschaft für ein Objekt zurück (z. B. ob es sich um eine Ansicht, Tabelle usw.) handelt.
OBJECTPROPERTYEX	Gibt Informationen zur erweiterten Objekteigenschaft zurück.
ASSEMBLYPROPERTY	Gibt einen angegebenen Eigenschaftswert einer SQL CLR-Assembly zurück.

Datenmodellmetadaten (Typen und Spalten)

Grundlegendes zu Typidentität und Eigenschaften sowie Spaltenidentität und -eigenschaften. Verwenden Sie diese Metadaten für Schemaüberprüfung, Codegenerierung, ETL und Kompatibilitätsprüfungen.

Funktion	Description
TYPE_ID	Gibt die ID eines Datentyps zurück.
TYPE_NAME	Gibt einen Datentypnamen nach ID zurück.
TYPEPROPERTY	Gibt eine Eigenschaft eines Datentyps zurück, z. B. Genauigkeit oder Nullwerte.
COL_NAME	Gibt den Spaltennamen für eine bestimmte Spalten-ID zurück.
COL_LENGTH	Gibt die Länge einer Spalte in Bytes zurück.
COLUMNPROPERTY	Gibt eine Eigenschaft einer Spalte zurück, z. B. ob es sich um eine Identität oder berechnete Spalte handelt.

Access-Pfadmetadaten (Indizes und Statistiken)

Überprüfen Sie die Indizierungsstrukturen und die Aktualität der Statistik. Verwenden Sie diese Metadaten in optimierungsworkflows und metadatengesteuerte Wartung.

Funktion	Description
INDEX_COL	Gibt den Namen einer indizierten Spalte zurück.
INDEXKEY_PROPERTY	Gibt eine Eigenschaft eines Indexschlüssels zurück.
INDEXPROPERTY	Gibt eine Eigenschaft eines Indexes zurück, z. B. gruppiert oder deaktiviert.
STATS_DATE	Gibt die Datumsstatistiken zurück, die zuletzt für eine Tabelle oder einen Index aktualisiert wurden.

Physische Speicher- und Volltextmetadaten

Überprüfen Sie das physische Layout (Dateien und Dateigruppen) und Volltextkomponenten. Verwenden Sie diese Informationen für die Speicherverwaltung, Problembehandlung und Konfigurationsüberwachung.

Funktion	Description
FILE_ID	Gibt die Datei-ID zurück.
FILE_IDEX	Gibt die Datei-ID basierend auf dem Dateinamen zurück.
FILE_NAME	Gibt den Dateinamen für eine Datei-ID zurück.
FILEGROUP_ID	Gibt die ID einer Dateigruppe zurück.
FILEGROUP_NAME	Gibt den Namen einer Dateigruppe zurück.
FILEGROUPPROPERTY	Gibt eine Eigenschaft einer Dateigruppe zurück.
FILEPROPERTY	Gibt eine Dateieigenschaft zurück, z. B. Größe oder Status.
FULLTEXTCATALOGPROPERTY	Gibt eine Eigenschaft eines Volltextkatalogs zurück.
FULLTEXTSERVICEPROPERTY	Gibt Volltextdiensteigenschaften zurück, z. B. den Ladestatus.

Laufzeitkoordination und Generierte Wertmetadaten

Koordinieren Sie die Arbeit über Sitzungen hinweg, indem Sie Anwendungssperren verwenden. Rufen Sie generierte numerische Werte für Identitäts- und Sequenzobjekte ab.

Funktion	Description
APPLOCK_MODE	Gibt den Sperrmodus zurück, der von der aktuellen Sitzung gehalten wird.
APPLOCK_TEST	Testet, ob eine Sperre erworben werden kann, ohne sie tatsächlich zu erwerben.
SCOPE_IDENTITY	Gibt den letzten Identitätswert zurück, der im aktuellen Bereich generiert wurde.
NEXT VALUE FOR	Gibt den nächsten Wert in einem Sequenzobjekt zurück.