DB_EXTENDED_PROPERTY-Funktion [System]

DB_EXTENDED_PROPERTY( 
{ property-id | property-name }
[, property-specific-argument
[, database-id | database-name ] ]
)

property-id Die abzufragende Kennung der Datenbankeigenschaft.
Eigenschaftsname Der abzufragende Name der Datenbankeigenschaft
Eine vollständige Liste der Datenbankeigenschaften finden Sie unter Liste der Datenbankeigenschaften.

Eigenschaftsspezifisches_Argument Mit den folgenden Datenbankeigenschaften können Sie zusätzliche, im Folgenden beschriebene Argumente angeben, um spezifische Informationen zur Eigenschaft zurückzugeben.

CharSet-Eigenschaft Gibt den Namen eines Standardwerts an, um das Standard-CHAR-Zeichensatzlabel für den Standardwert zu erhalten. Mögliche Werte sind: ASE, IANA, MIME, JAVA, WINDOWS, UTR22, IBM und ICU. Wenn kein Standard angegeben ist, wird standardmäßig IANA verwendet, außer die Datenbankverbindung wurde durch TDS hergestellt. In diesem Fall ist ASE der Standardwert.

Eigenschaften CatalogCollation, Collation und NcharCollation Bei der Abfrage dieser Eigenschaften können Sie die folgenden Werte als Eigenschaftsspezifisches_Argument angeben, um spezifische Informationen für die Kollation zurückzugeben:

AccentSensitive Geben Sie AccentSensitive an, um die Einstellung der Akzentberücksichtigung für die Kollation abzurufen. Beispiel: Die folgende Anweisung gibt die Akzentberücksichtigung bei der NCHAR-Kollation zurück:

SELECT DB_EXTENDED_PROPERTY( 'NcharCollation', 'AccentSensitive');

Mögliche Rückgabewerte sind: Ignore, Respect und French. Weitere Hinweise finden Sie unter Optionen der Kollationsanpassung.

CaseSensitivity Geben Sie CaseSensitivity an, um die Berücksichtigung der Groß-/Kleinschreibung für die Kollation abzurufen. Mögliche Rückgabewerte sind: Ignore, Respect, UpperFirst und LowerFirst. Weitere Hinweise finden Sie unter Optionen der Kollationsanpassung.
PunctuationSensitivity Geben Sie PunctuationSensitivity an, um die Berücksichtigung der Satzzeichen für die Kollation abzurufen. Mögliche Rückgabewerte sind: Ignore, Primary und Quaternary. Weitere Hinweise finden Sie unter Optionen der Kollationsanpassung.
Eigenschaften Geben Sie Properties an, um eine Zeichenfolge zu erhalten, die alle für die Kollation angegebenen Optionen der Kollationsanpassung enthält. Eine Beschreibung der Schlüsselwörter und der Werte in der zurückgegebenen Zeichenfolge finden Sie unter Optionen der Kollationsanpassung.
Spezifikation Geben Sie Specification an, um eine Zeichenfolge mit der vollständigen Spezifikation zu erhalten, die für die Kollation verwendet wird. Eine Beschreibung der Schlüsselwörter und der Werte in der zurückgegebenen Zeichenfolge finden Sie unter Optionen der Kollationsanpassung.

DriveType-Eigenschaft Geben Sie den Namen eines DBSpaces oder die Datei-ID für den DBSpace an, um seinen Speichermediumtyp zu erhalten. Der zurückgegebene Wert ist einer der folgenden: CD, FIXED, RAMDISK, REMOTE, REMOVABLE oder UNKNOWN. Wenn keine Angabe gemacht wird, wird der Typ des Speichermediums des System-DBSpaces zurückgegeben. Wenn der angegebene DBSpace nicht existiert, gibt die Eigenschaftsfunktion NULL zurück. Wenn der Name des DBSpaces angegeben ist und die ID einer Datenbank, die nicht die Datenbank der aktuellen Verbindung ist, auch angegeben ist, gibt die Funktion ebenfalls NULL zurück.
File-Eigenschaft Geben Sie einen DBSpace-Namen an, um den Dateinamen der Datenbank-Stammdatei einschließlich des Pfads zu erhalten. Wenn keine Angabe gemacht wird, werden Informationen für den System-DBSpace zurückgegeben. Wenn die angegebene Datei nicht existiert, gibt die Funktion NULL zurück.
FileSize-Eigenschaft Geben Sie den Namen eines DBSpaces oder die Datei-ID für den DBSpace an, um die Größe der angegebenen Datei in Seiten zu erhalten. Sie können auch "temporary" angeben, um die Größe des temporären DBSpace zurückzugeben, oder "translog", um die Größe der Logdatei zurückzugeben. Wenn keine Angabe gemacht wird, wird die Größe des System-DBSpaces zurückgegeben. Wenn die angegebene Datei nicht existiert, gibt die Funktion NULL zurück.
FreePages-Eigenschaft Geben Sie den Namen eines DBSpaces oder die Datei-ID für den DBSpace an, um die Anzahl der freien Seiten zu erhalten. Sie können auch "temporary" angeben, um die Anzahl der freien Seiten im temporären DBSpace zurückzugeben, oder "translog", um die Anzahl der freien Seiten in der Logdatei zurückzugeben. Wenn keine Angabe gemacht wird, wird die Anzahl der freien Seiten im System-DBSpace zurückgegeben. Wenn die angegebene Datei nicht existiert, gibt die Funktion NULL zurück.
IOParallelism-Eigenschaft Geben Sie den Namen eines DBSpaces an, um die geschätzte Anzahl der simultanen vom DBSpace unterstützten I/O-Vorgänge zu erhalten. Wenn kein DBSpace angegeben ist, wird der aktuelle System-DBSpace verwendet.
MirrorServerState-Eigenschaft Geben Sie einen Servernamen an, um den Verbindungsstatus des Spiegelservers zu ermitteln. Gibt "connected", "disconnected", "incoming only", "outgoing only" oder NULL zurück.
MirrorState-Eigenschaft Geben Sie einen Servernamen an, um den Synchronisationsstatus des Spiegelservers zu ermitteln. Gibt "synchronizing", "synchronized" oder NULL zurück.
NextScheduleTime-Eigenschaft Geben Sie einen Ereignisnamen an, um seine nächste geplante Ausführungszeit zu erhalten.

Datenbank-ID Die Datenbank-ID-Nummer, wie von der DB_ID-Funktion zurückgegeben. Üblicherweise wird der Datenbankname verwendet.
Datenbankname Der Name der Datenbank, wie von der DB_NAME-Funktion zurückgegeben

VARCHAR

Die DB_EXTENDED_PROPERTY-Funktion ist ähnlich der DB_PROPERTY-Funktion, mit dem Unterschied, dass hier ein optionaler Zeichenfolgenparameter Eigenschaftsspezifisches_Argument angegeben werden kann. Die Interpretation von Eigenschaftsspezifisches_Argument hängt von der Eigenschafts-ID bzw. dem im ersten Argument angegebenen Namen ab.

Wenn das dritte Argument weggelassen wurde, wird die aktuelle Datenbank verwendet.

Beim Vergleichen von Katalogzeichenfolgen, wie z.B. Tabellen- und Prozedurnamen, verwendet der Datenbankserver die CHAR-Kollation. Bei UCA-Kollationen ist die Katalogkollation zwar mit der CHAR-Kollation identisch, aber die Anpassung ist so geändert, dass die Groß- und Kleinschreibung sowie Akzente nicht berücksichtigt und Satzzeichen auf der ersten Ebene sortiert werden. Bei Sortierkollationen ist die Katalogkollation zwar mit der CHAR-Kollation identisch, aber die Anpassung ist so geändert, dass die Groß- und Kleinschreibung nicht berücksichtigt wird. Sie können die für Katalogkollationen verwendeten Anpassung zwar nicht explizit festlegen, haben aber die Möglichkeit, die Specification-Eigenschaft abzufragen, um die vollständige Kollationsspezifikation zu erhalten, die vom Datenbankserver für den Vergleich von Katalogzeichenfolgen verwendet wird. Das Abfragen der Specification-Eigenschaft kann nützlich sein, wenn Sie die Differenz zwischen der CHAR- und der Katalogkollation nutzen müssen. Beispiel: Sie haben eine CHAR-Kollation, bei der keine Satzzeichen berücksichtigt werden, und möchten ein Upgrade-Skript ausführen, das eine Prozedur mit dem Namen my_procedure definiert und versucht, eine alte Version mit dem Namen myprocedure zu löschen. Die folgenden Anweisungen können die gewünschten Ergebnisse nicht erzielen, da my_procedure bei Verwendung der CHAR-Kollation mit myprocedure gleichwertig ist:

CREATE PROCEDURE my_procedure( ) ...; 
IF EXISTS ( SELECT * FROM SYS.SYSPROCEDURE WHERE proc_name = 'myprocedure' ) 
THEN DROP PROCEDURE myprocedure 
END IF;

Stattdessen können Sie folgende Anweisungen ausführen, um die gewünschten Ergebnisse zu erzielen:

CREATE PROCEDURE my_procedure( ) ...; 
IF EXISTS ( SELECT * FROM SYS.SYSPROCEDURE 
   WHERE COMPARE( proc_name, 'myprocedure', DB_EXTENDED_PROPERTY( 'CatalogCollation', 'Specification' ) ) = 0 ) 
THEN DROP PROCEDURE myprocedure 
END IF;

Cloud-Hinweis: Aufgrund von Isolationsregeln für Tenant-Datenbanken gibt diese Funktion bei einem Aufruf in der Cloud nur Informationen über die aktuelle Tenant-Datenbank zurück.

Keine Privilegien sind erforderlich, um diese Funktion für die aktuelle Datenbank auszuführen. Um diese Funktion für andere Datenbanken ausführen zu können, benötigen Sie das SERVER OPERATOR-Systemprivileg oder das MONITOR-Systemprivileg.

NULL wird zurückgegeben, wenn Sie einen ungültigen Parameterwert angeben oder eines der erforderlichen Systemprivilegien nicht haben.

SQL/2008 Erweiterung des Herstellers.

Die folgende Anweisung gibt den Speicherort der aktuellen Datenbank zurück:

SELECT DB_EXTENDED_PROPERTY( 'File' );

Die folgende Anweisung gibt die Dateigröße des System-DBSpace in Seiten zurück:

SELECT DB_EXTENDED_PROPERTY( 'FileSize' );

Die folgende Anweisung gibt die Dateigröße des Transaktionslogs in Seiten zurück:

SELECT DB_EXTENDED_PROPERTY( 'FileSize', 'translog' );

Die folgende Anweisung gibt die Einstellung in Bezug auf die Berücksichtigung der Groß-/Kleinschreibung bei der NCHAR-Kollation zurück:

SELECT DB_EXTENDED_PROPERTY( 'NcharCollation',' CaseSensitivity' );

Die folgende Anweisung gibt die Optionen zurück, die für die CHAR-Kollation der Datenbank festgelegt wurden:

SELECT DB_EXTENDED_PROPERTY ( 'Collation', 'Properties' );

Die folgende Anweisung gibt die vollständige Kollationsspezifikation zurück, die für die NCHAR-Kollation der Datenbank festgelegt wurde:

SELECT DB_EXTENDED_PROPERTY( 'NcharCollation', 'Specification' );

Die folgende Anweisung liefert den Verbindungsstatus des Spiegelservers "Test":

SELECT DB_EXTENDED_PROPERTY( 'MirrorServerState', 'Test' );

Die folgende Anweisung liefert den Synchronisationsstatus der Spiegelservers "Test":

SELECT DB_EXTENDED_PROPERTY( 'MirrorState', 'Test' );

DB_EXTENDED_PROPERTY-Funktion [System]

Syntax

Parameter

Rückgabe

Bemerkungen

Privilegien

Siehe auch

Standards und Kompatibilität

Beispiel