Teilen über


DATABASEPROPERTYEX (Transact-SQL)

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Für eine angegebene Datenbank in SQL Server gibt diese Funktion die aktuelle Einstellung der angegebenen Datenbankoption oder -eigenschaft zurück.

Transact-SQL-Syntaxkonventionen

Syntax

DATABASEPROPERTYEX ( database , property )  

Argumente

database
Ein Ausdruck, der den Namen der Datenbank angibt, für die DATABASEPROPERTYEX Informationen über die angegebene Eigenschaft zurückgibt. database hat den Datentyp nvarchar(128) .

Für SQL-Datenbank erfordert DATABASEPROPERTYEX den Namen der aktuellen Datenbank. Die Funktion gibt NULL für alle Eigenschaften zurück, wenn ein anderer Datenbankname angegeben wird.

property
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:

Hinweis

Wenn die Datenbank noch nicht gestartet wurde, wird für Aufrufe von DATABASEPROPERTYEX NULL zurückgegeben, wenn DATABASEPROPERTYEX diese Werte durch direkten Datenbankzugriff abruft, statt sie aus den Metadaten abzurufen. Eine Datenbank, für die AUTO_CLOSE auf ON festgelegt ist, ist als „nicht gestartet“ definiert.

Eigenschaft BESCHREIBUNG Zurückgegebener Wert
Sortierung Standardsortierungsname der Datenbank Sortierungsname

NULL: Datenbank wird nicht gestartet.

Basisdatentyp: nvarchar(128)
ComparisonStyle Die Windows-Vergleichsart der Sortierung. Verwenden Sie die folgenden Stilwerte, um eine Bitmap für den schlussendlichen ComparisonStyle-Wert zu erstellen:

Groß-/Kleinschreibung ignorieren: 1
Akzente ignorieren: 2
Kana ignorieren: 65536
Breite ignorieren: 131072

Der Standardwert 196609 ist beispielsweise das Ergebnis der Kombination der Optionen, mit denen die Groß-/Kleinschreibung, Kana und die Breite ignoriert wird.
Gibt die Vergleichsart zurück.

Gibt für alle binären Sortierungen 0 zurück.

Basisdatentyp: int
Edition Die Edition oder Dienstebene der Datenbank. Gilt für: Azure SQL-Datenbank, Azure Synapse Analytics.



Universell

Unternehmenskritisch

Basic

Standard

Premium

System (für die master-Datenbank)

NULL: Datenbank wird nicht gestartet.

Basisdatentyp: nvarchar(64)
IsAnsiNullDefault Die Datenbank befolgt ISO-Regeln für das Zulassen von NULL-Werten. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsAnsiNullsEnabled Alle Vergleiche mit einem NULL-Wert werden zu einem unbekannten Wert ausgewertet. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsAnsiPaddingEnabled Zeichenfolgen werden vor dem Vergleich oder Einfügen auf dieselbe Länge aufgefüllt. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsAnsiWarningsEnabled SQL Server gibt Fehler- oder Warnmeldungen aus, wenn Standardfehlerbedingungen auftreten. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsArithmeticAbortEnabled Abfragen werden beendet, wenn während der Abfrageausführung ein Überlauffehler oder ein Fehler aufgrund einer Division durch Null auftritt. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsAutoClose Die Datenbank wird ordnungsgemäß heruntergefahren, und Ressourcen werden freigegeben, nachdem der letzte Benutzer die Anwendung beendet hat. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsAutoCreateStatistics Der Abfrageoptimierer erstellt Statistiken für einzelne Spalten nach Bedarf, um die Abfrageleistung zu verbessern. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsAutoCreateStatisticsIncremental Automatisch erstellte Statistiken für einzelne Spalten sind inkrementell, falls möglich. Gilt für: SQL Server 2014 (12.x) und höher.

1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsAutoShrink Datenbankdateien sind Kandidaten für das automatische periodische Verkleinern. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsAutoUpdateStatistics Wenn in einer Abfrage vorhandene Statistiken verwendet werden, die möglicherweise veraltet sind, aktualisiert der Abfrageoptimierer diese Statistiken. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsClone Die Datenbank ist nur eine Kopie der Schemas und Statistiken einer Benutzerdatenbank, die mit DBCC CLONEDATABASE erstellt wurde. Weitere Informationen finden Sie in diesem Microsoft Support-Artikel. Gilt für: SQL Server 2014 (12.x) SP2 und höher.

1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsCloseCursorsOnCommitEnabled Wenn für eine Transaktion ein Commit ausgeführt wird, werden alle geöffneten Cursor geschlossen. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsDatabaseSuspendedForSnapshotBackup Die Datenbank wird gesperrt. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsFulltextEnabled Die Datenbank ist für die Volltext- und semantische Indizierung aktiviert. Gilt für: SQL Server 2008 (10.0.x) und höher.



1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int

Hinweis: Der Wert dieser Eigenschaft hat jetzt keine Auswirkungen. In Benutzerdatenbanken ist die Volltextsuche standardmäßig aktiviert. In einer zukünftigen Version von SQL Server wird diese Eigenschaft entfernt. Verwenden Sie diese Eigenschaft nicht beim Entwickeln neuer Anwendungen, und ändern Sie Anwendungen, in denen diese Eigenschaft zurzeit verwendet wird, so bald wie möglich.
IsInStandBy Die Datenbank ist im Schreibschutzmodus online. Die Wiederherstellung des Protokolls ist zulässig. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsLocalCursorsDefault Cursordeklarationen werden standardmäßig auf LOCAL festgelegt. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsMemoryOptimizedElevateToSnapshotEnabled Auf speicheroptimierte Tabellen wird mit der SNAPSHOT-Isolation zugegriffen, wenn die Sitzungseinstellung TRANSACTION ISOLATION LEVEL auf READ COMMITTED, READ UNCOMMITTED oder eine niedrigere Isolationsstufe festgelegt ist. Gilt für: SQL Server 2014 (12.x) und höher.



1: TRUE

0: FALSE

Basisdatentyp: int
IsMergePublished SQL Server unterstützt Datenbanktabellenveröffentlichung für Mergereplikation, wenn die Replikation installiert ist. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsNullConcat Der Operand für die NULL-Verkettung ergibt NULL. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsNumericRoundAbortEnabled Fehler werden generiert, wenn ein Genauigkeitsverlust in Ausdrücken auftritt. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsParameterizationForced Die SET-Option PARAMETERIZATION wurde für die Datenbank auf FORCED festgelegt. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe
IsQuotedIdentifiersEnabled Für Bezeichner sind doppelte Anführungszeichen zulässig. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsPublished Wenn Replikation installiert ist, unterstützt SQL Server Datenbanktabellenveröffentlichung für Momentaufnahme- oder Transaktionsreplikation. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsRecursiveTriggersEnabled Das rekursive Auslösen von Triggern ist aktiviert. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsSubscribed Die Datenbank wurde für eine Veröffentlichung abonniert. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsSyncWithBackup Die Datenbank ist entweder eine veröffentlichte oder eine Verteilungsdatenbank, und für sie wird ein Wiederherstellen unterstützt, bei dem Transaktionsreplikation nicht unterbrochen wird. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsTornPageDetectionEnabled SQL Server-Datenbank-Engine erkennt unvollständige E/A-Vorgänge, die durch Stromausfälle oder andere Systemunterbrechungen verursacht wurden. 1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsVerifiedClone Die Datenbank ist nur eine Kopie der Schemas und Statistiken einer Benutzerdatenbank, die mit der DBBC CLONEDATABASE-Option WITH VERIFY_CLONEDB erstellt wurde. Weitere Informationen finden Sie im folgenden Microsoft Support-Artikel. Gilt für: Ab SQL Server 2016 (13.x) SP2.



1: TRUE

0: FALSE

NULL: Ungültige Eingabe

Basisdatentyp: int
IsXTPSupported Gibt an, ob die Datenbank das In-Memory-OLTP unterstützt. Beispiele hierfür sind die Erstellung und Verwendung speicheroptimierter Tabellen und nativ kompilierter Module.

Spezifisch für SQL Server:

IsXTPSupported ist unabhängig von der Existenz von MEMORY_OPTIMIZED_DATA-Dateigruppen, die für die Erstellung von In-Memory-OLTP-Objekten benötigt werden.
Gilt für: SQL Server (SQL Server 2016 (13.x) und höher) und Azure SQL-Datenbank.

1: TRUE

0: FALSE

NULL: Ungültige Eingabe, ein Fehler oder nicht anwendbar

Basisdatentyp: int
LastGoodCheckDbTime Datum und Uhrzeit der letzten erfolgreichen Ausführung von „DBCC CHECKDB“ in der angegebenen Datenbank. 1 Wenn „DBCC CHECKDB“ in einer Datenbank noch nicht ausgeführt wurde, wird „1900-01-01 00:00:00.000“ zurückgegeben. Gilt für: SQL Server 2016 (13.x) beginnend mit SP2.
SQL Server 2017 (14.x) beginnend mit CU9.
SQL Server 2019 (15.x) oder höher.
Azure SQL-Datenbank.

Ein datetime-Wert

NULL: Ungültige Eingabe

Basisdatentyp: datetime
LCID Der zur Sortierung verwendete Windows-Gebietsschemabezeichner (LCID, Locale Identifier). LCID-Wert (im Dezimalformat).

Basisdatentyp: int
MaxSizeInBytes Maximale Datenbankgröße in Bytes. Gilt für: Azure SQL-Datenbank, Azure Synapse Analytics.

Azure SQL-Datenbank und Azure Synapse Analytics: Der Wert basiert auf SLO, sofern kein zusätzlicher Speicher erworben wurde.

vCore: Der Wert wird in Inkrementen von 1 GB bis zur Maximalgröße erhöht.

NULL: Datenbank wird nicht gestartet.

Basisdatentyp: bigint
Wiederherstellung Datenbank-Wiederherstellungsmodell FULL: Vollständiges Wiederherstellungsmodell

BULK_LOGGED: Massenprotokolliertes Modell

SIMPLE: Einfaches Wiederherstellungsmodell

Basisdatentyp: nvarchar(128)
ServiceObjective Beschreibt die Leistungsstufe der Datenbank in SQL-Datenbank oder Azure Synapse Analytics. Einer der folgenden Werte:

NULL = Die Datenbank wurde nicht gestartet.

Freigegeben (für Web/Business-Editionen)

Basic

S0

S1

S2

S3

P1

P2

P3

ElasticPool

System (für die master-Datenbank)

Basisdatentyp: nvarchar(32)
ServiceObjectiveId Dies ist die ID des Dienstziels in SQL-Datenbank. uniqueidentifier, die das Dienstziel identifiziert.
SQLSortOrder Die ID der SQL Server-Sortierreihenfolge, die in früheren Versionen von SQL Server unterstützt wurde. 0: In der Datenbank wird Windows-Sortierung verwendet.

>0: ID der SQL Server-Sortierreihenfolge

NULL: Ungültige Eingabe, oder die Datenbank wurde nicht gestartet.

Basisdatentyp: tinyint
Status Der Status der Datenbank. ONLINE: Die Datenbank ist für Abfragen verfügbar.

Hinweis: Die Funktion gibt möglicherweise den ONLINE-Status zurück, während die Datenbank geöffnet wird und noch nicht wiederhergestellt wurde. Fragen Sie die Collation-Eigenschaft von DATABASEPROPERTYEX ab, um zu ermitteln, ob eine ONLINE-Datenbank Verbindungen akzeptieren kann. Die ONLINE-Datenbank kann Verbindungen akzeptieren, wenn die Datenbanksortierung einen Wert ungleich NULL zurückgibt. Fragen Sie bei Always On-Datenbanken die „database_state“- oder die „database_state_desc“-Spalte von sys.dm_hadr_database_replica_states ab.

OFFLINE: Die Datenbank wurde explizit offline geschaltet.

RESTORING: Die Wiederherstellung der Datenbank wurde gestartet.

RECOVERING: Die Wiederherstellung der Datenbank wurde gestartet, aber die Datenbank ist noch nicht für Abfragen bereit.

SUSPECT: Die Datenbank wurde nicht wiederhergestellt.

EMERGENCY: Die Datenbank befindet sich im schreibgeschützten Notfallmodus. Der Zugriff ist auf sysadmin-Mitglieder beschränkt.

Basisdatentyp: nvarchar(128)
Updateability Zeigt an, ob Daten geändert werden können. READ_ONLY: Für die Datenbank werden Datenlese- aber keine Datenänderungsvorgänge unterstützt.

READ_WRITE: Für die Datenbank werden Datenlese- und Datenänderungsvorgänge unterstützt.

Basisdatentyp: nvarchar(128)
UserAccess Zeigt an, welche Benutzer auf die Datenbank zugreifen können. SINGLE_USER: Immer nur jeweils ein „db_owner“-, „dbcreator“- oder „sysadmin“-Benutzer

RESTRICTED_USER: Nur Mitglieder aus einer der Rollen „db_owner“, „dbcreator“ oder „sysadmin“

MULTI_USER: Alle Benutzer

Basisdatentyp: nvarchar(128)
Version Die interne Versionsnummer des SQL Server -Codes, mit dem die Datenbank erstellt wurde. Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt. Versionsnummer: Die Datenbank ist geöffnet.

NULL: Die Datenbank wurde nicht gestartet.

Basisdatentyp: int
ReplicaID Die Replikat-ID einer verbundenen Hyperskalendatenbank/eines Replikats. Gilt für: Azure SQL-Datenbank.

Sie gibt nur die Replikat-ID einer verbundenen Hyperscale-Datenbank/eines Replikats zurück. Weitere Informationen zu Replikattypen finden Sie unter Hyperscale-sekundäre Replikate .

NULL: Es handelt sich nicht um eine Hyperskalendatenbank, oder die Datenbank wird nicht gestartet.

Basisdatentyp: nvarchar(128)

Hinweis

1 Für Datenbanken, die Teil einer Verfügbarkeitsgruppe sind, gibt LastGoodCheckDbTime das Datum und die Uhrzeit der letzten erfolgreichen Ausführung von DBCC CHECKDB auf dem primären Replikat zurück, egal von welchem Replikat Sie den Befehl ausführen.

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 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 Metadaten ausgebende, integrierte Funktionen (z. B. OBJECT_ID) möglicherweise NULL zurückgeben, wenn die Benutzer*innen über keine Berechtigungen für das Objekt verfügen. Weitere Informationen finden Sie unter Konfigurieren der Sichtbarkeit von Metadaten.

Bemerkungen

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

Beispiele

A. Abrufen des Status der Datenbankoption AUTO_SHRINK

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

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

Hier ist das Resultset. Dies gibt an, dass AUTO_SHRINK auf OFF festgelegt 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 ist das Resultset.

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 das Feature für horizontale Skalierung von Azure SQL-Datenbank verwenden, können Sie überprüfen, ob Sie mit einem schreibgeschützten Replikat verbunden sind, indem Sie die folgende Abfrage im Kontext Ihrer Datenbank ausführen. Bei Verbindung mit einem schreibgeschützten Replikat wird READ_ONLY zurückgegeben. Auf diese Weise können Sie auch identifizieren, ob eine Abfrage auf einem schreibgeschützten Replikat ausgeführt wird.

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

Weitere Informationen

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