sp_helpdb (Transact-SQL)

Gilt für:SQL Server

Gibt Informationen zu einer angegebenen Datenbank oder zu allen Datenbanken zurück.

Transact-SQL-Syntaxkonventionen

Syntax

  
sp_helpdb [ [ @dbname= ] 'name' ]  

Argumente

[ @dbname = ] 'name' Der Name der Datenbank, für die Informationen gemeldet werden. name ist sysname, ohne Standardwert. Wenn kein Name angegeben ist, sp_helpdb Berichte zu allen Datenbanken in der sys.databases-Katalogsicht .

Rückgabecodewerte

„0“ (erfolgreich) oder „1“ (fehlerhaft)

Resultsets

Spaltenname Datentyp BESCHREIBUNG
name sysname Datenbankname.
db_size nvarchar(13) Gesamtgröße der Datenbank.
owner sysname Datenbankbesitzer, z. B. sa.
dbid smallint Datenbank-ID
created nvarchar(11) Erstellungsdatum der Datenbank.
status nvarchar(600) Eine durch Trennzeichen getrennte Liste mit Werten von Datenbankoptionen, die zurzeit für die Datenbank festgelegt sind.

Optionen mit booleschen Werten werden nur aufgelistet, wenn sie aktiviert sind. Nicht boolesche Optionen werden mit ihren entsprechenden Werten in Form vonoption_name-Wert= aufgelistet.

Weitere Informationen finden Sie unter ALTER DATABASE (Transact-SQL).
compatibility_level tinyint Datenbank-Kompatibilitätsgrad: 60, 65, 70, 80 oder 90.

Wenn name angegeben ist, gibt es ein zusätzliches Resultset, das die Dateizuordnung für die angegebene Datenbank anzeigt.

Spaltenname Datentyp BESCHREIBUNG
name nchar(128) Logischer Dateiname der Datei.
fileid smallint Die Datei-ID
filename nchar(260) Betriebssystem-Dateiname (physischer Dateiname).
filegroup nvarchar(128) Dateigruppe, zu der die Datei gehört.

NULL = Datei ist eine Protokolldatei. Sie gehört nie zu einer Dateigruppe.
size nvarchar(18) Dateigröße in MB.
Maxsize nvarchar(18) Maximale Größe, auf die die Datei vergrößert werden kann. Mit UNLIMITED in diesem Feld kann die Datei so lange vergrößert werden, bis der Datenträger voll ist.
growth nvarchar(18) Vergrößerungsinkrement der Datei. Dies gibt an, wie viel Speicherplatz der Datei bei jedem neuen Speicherplatz hinzugefügt wird.
Verwendung varchar(9) Verwendung der Datei. Für eine Datendatei ist der Wert "nur Daten" und für die Protokolldatei der Wert "nur Protokoll".

Bemerkungen

Die spalte status im Resultset meldet, welche Optionen in der Datenbank auf ON festgelegt wurden. Von der Spalte status werden nicht alle Datenbankoptionen gemeldet. Um eine vollständige Liste der aktuellen Datenbankoptionseinstellungen anzuzeigen, verwenden Sie die sys.databases-Katalogsicht .

Berechtigungen

Wenn eine Einzeldatenbank angegeben wird, ist die Mitgliedschaft in der öffentlichen Rolle in der Datenbank erforderlich. Wenn keine Datenbank angegeben ist, ist die Mitgliedschaft in der öffentlichen Rolle in der master-Datenbank erforderlich.

Wenn auf eine Datenbank nicht zugegriffen werden kann, zeigt sp_helpdb die Fehlermeldung 15622 und so viele Informationen wie möglich zur Datenbank an.

Beispiele

A. Zurückgeben von Informationen für eine einzelne Datenbank

Im folgenden Beispiel werden Informationen zur AdventureWorks2022-Datenbank angezeigt.

EXEC sp_helpdb N'AdventureWorks2022';  

B. Zurückgeben von Informationen für alle Datenbanken

Im folgenden Beispiel werden Informationen zu allen Datenbanken auf dem Server angezeigt, auf dem SQL Server ausgeführt wird.

EXEC sp_helpdb;  
GO  

Weitere Informationen

Gespeicherte Prozeduren für die Datenbank-Engine (Transact-SQL)
ALTER DATABASE (Transact-SQL)
CREATE DATABASE (SQL Server Transact-SQL)
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)
sys.filegroups (Transact-SQL)
sys.master_files (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)