DATABASEPROPERTYEX (Transact-SQL)

Aktualisiert: 17. Juli 2006

Gibt die aktuelle Einstellung der angegebenen Datenbankoption oder -eigenschaft für die angegebene Datenbank zurück.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

DATABASEPROPERTYEX ( database , property )

Argumente

  • database
    Ein Ausdruck, der zum Namen der Datenbank ausgewertet wird, für die Informationen über die benannte Eigenschaft zurückgegeben werden sollen. database ist vom Datentyp nvarchar(128).
  • property
    Ein Ausdruck, der für den Namen der Datenbankeigenschaft steht, die zurückgegeben werden soll. property ist vom Datentyp varchar(128) und kann einen der folgenden Werte annehmen. Der Rückgabetyp ist sql_variant. In der folgenden Tabelle wird der Basisdatentyp für den jeweiligen Eigenschaftswert aufgeführt.

    ms186823.note(de-de,SQL.90).gifHinweis:
    Wenn die Datenbank nicht gestartet wird, geben die Eigenschaften, die Microsoft SQL Server 2005-Datenbankmodul durch direkten Zugriff auf die Datenbank anstatt durch Abrufen des Wertes aus den Metadaten abruft, NULL zurück. Das heißt, sofern für die Datenbank AUTO_CLOSE auf ON festgelegt wurde oder die Datenbank offline ist.

    Eigenschaft

Rückgabetypen

sql_variant

Ausnahmen

Gibt NULL bei einem Fehler zurück oder wenn ein Aufrufer nicht über Berechtigungen zum Anzeigen des Objekts verfügt.

In SQL Server 2005 kann ein Benutzer nur die Metadaten sicherungsfähiger Elemente anzeigen, bei denen der Benutzer entweder der Besitzer ist oder für die dem Benutzer eine Berechtigung erteilt wurde. Dies bedeutet, dass Metadaten ausgebende integrierte Funktionen, z. B. OBJECT_ID, möglicherweise NULL zurückgeben, wenn dem Benutzer für das Objekt keine Berechtigung erteilt wurde. Weitere Informationen finden Sie unter Konfigurieren der Sichtbarkeit von Metadaten und unter Behandlung von Problemen bei der Sichtbarkeit von Metadaten.

Hinweise

DATABASEPROPERTYEX gibt jeweils nur eine Eigenschaftseinstellung zurück. Verwenden Sie die sys.databases-Katalogsicht, um mehrere Eigenschaftseinstellungen anzuzeigen.

Beispiele

A. Abrufen des Status der Datenbankoption AUTO_SHRINK

Das folgende Beispiel gibt den Status der AUTO_SHRINK-Datenbankoption für die AdventureWorks-Datenbank zurück.

SELECT DATABASEPROPERTYEX('AdventureWorks', 'IsAutoShrink');

Dies ist das Resultset. Dies gibt an, dass AUTO_SHRINK auf OFF festgelegt ist.

------------------
0

B. Abrufen der Standardsortierung für eine Datenbank

Das folgende Beispiel gibt den Namen der Standardsortierung für die AdventureWorks-Datenbank zurück.

SELECT DATABASEPROPERTYEX('AdventureWorks', 'Collation');

Dies ist das Resultset.

------------------------------
SQL_Latin1_General_CP1_CI_AI

Siehe auch

Verweis

ALTER DATABASE (Transact-SQL)
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)

Andere Ressourcen

Datenbankstatus
Festlegen von Datenbankoptionen
Verwenden von sql_variant-Daten

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf

Version Verlauf

17. Juli 2006

Neuer Inhalt:
  • Der Abschnitt "Ausnahmen" wurde hinzugefügt.

14. April 2006

Geänderter Inhalt:
  • Die Beschreibungen von ComparisonStyle und LCID wurden korrigiert und erweitert.