DATABASEPROPERTYEX (Transact-SQL)

Gilt für:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL-Datenbank in Microsoft Fabric

Bei einer angegebenen Datenbank in SQL Server gibt die DATABASEPROPERTYEX Funktion die aktuelle Einstellung der angegebenen Datenbankoption oder -eigenschaft zurück.

Transact-SQL-Syntaxkonventionen

Syntax

DATABASEPROPERTYEX ( database , property )

Argumente

Datenbank

Ein Ausdruck, der den Namen der Datenbank angibt, DATABASEPROPERTYEX für die die benannten Eigenschafteninformationen zurückgegeben werden. database hat den Datentyp nvarchar(128) .

Für SQL-Datenbank erfordert DATABASEPROPERTYEX den Namen der aktuellen Datenbank. Es wird für alle Eigenschaften zurückgegeben NULL , wenn ein anderer Datenbankname angegeben ist.

Eigentum

Ein Ausdruck, der den Namen der zurückzugebenden Datenbankeigenschaft angibt. property hat den Datentyp varchar(128) und unterstützt einen der Werte in dieser Tabelle:

Rückgabetypen

sql_variant

Ausnahmen

Gibt NULL den Fehler zurück oder wenn ein Aufrufer nicht über die Berechtigung zum Anzeigen des Objekts verfügt.

In SQL Server 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. Diese Regel bedeutet, dass metadatenmittierende, integrierte Funktionen wie OBJECT_ID z. B. zurückgegeben werden NULL können, wenn der Benutzer keine Berechtigungen für das Objekt besitzt. Weitere Informationen finden Sie in der Konfiguration der Metadatensichtbarkeit.

Bemerkungen

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

Beispiele

Die Codebeispiele in diesem Artikel verwenden die AdventureWorks2025- oder AdventureWorksDW2022 Beispieldatenbank, die Sie von der Microsoft SQL Server Samples and Community Projects Homepage herunterladen können.

Ein. Abrufen des Status der AUTO_SHRINK-Datenbankoption

In diesem Beispiel wird der Status der AUTO_SHRINK Datenbankoption für die AdventureWorks Datenbank zurückgegeben.

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

Hier sehen Sie das Ergebnis. Dies weist darauf hin, dass dies AUTO_SHRINK deaktiviert ist.

0

B. Abrufen der Standardsortierung für eine Datenbank

In diesem Beispiel werden mehrere Attribute der AdventureWorks-Datenbank zurückgegeben.

SELECT DATABASEPROPERTYEX('AdventureWorks2022', 'Collation') AS Collation,
       DATABASEPROPERTYEX('AdventureWorks2022', 'Edition') AS Edition,
       DATABASEPROPERTYEX('AdventureWorks2022', 'ServiceObjective') AS ServiceObjective,
       DATABASEPROPERTYEX('AdventureWorks2022', 'MaxSizeInBytes') AS MaxSizeInBytes;

Hier sehen Sie das Ergebnis.

Collation                     Edition        ServiceObjective  MaxSizeInBytes
----------------------------  -------------  ----------------  --------------
SQL_Latin1_General_CP1_CI_AS  DataWarehouse  DW1000            5368709120

C. Verwenden von DATABASEPROPERTYEX zum Überprüfen der Verbindung mit dem Replikat

Wenn Sie die Azure SQL-Datenbankskalierungsfunktion verwenden, können Sie überprüfen, ob Sie mit einem schreibgeschützten Replikat verbunden sind oder nicht, indem Sie die folgende Abfrage im Kontext Ihrer Datenbank ausführen. Es wird zurückgegeben READ_ONLY , wenn Sie mit einem schreibgeschützten Replikat verbunden sind. Auf diese Weise können Sie auch identifizieren, ob eine Abfrage auf einem schreibgeschützten Replikat ausgeführt wird.

SELECT DATABASEPROPERTYEX(DB_NAME(), 'Updateability');

Verwandte Inhalte

• ALTER-DATENBANK (Transact-SQL)
• Datenbankstatus
• sys.databases (Transact-SQL)
• sys.database_files (Transact-SQL)
• SERVEREIGENSCHAFT (Transact-SQL)