sp_helpfilegroup (Transact-SQL)
Gibt die Namen und Attribute von Dateigruppen zurück, die der aktuellen Datenbank zugeordnet sind.
Transact-SQL-Syntaxkonventionen
Syntax
sp_helpfilegroup [ [ @filegroupname = ] 'name' ]
Argumente
- [ @filegroupname = ] 'name'
Der logische Name einer Dateigruppe in der aktuellen Datenbank. name ist ein Wert vom Datentyp sysname, der Standardwert ist NULL. Wenn name nicht angegeben ist, werden alle Dateigruppen in der aktuellen Datenbank aufgelistet, und nur das erste Resultset im Resultsetabschnitt wird angezeigt.
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
Resultsets
Spaltenname | Datentyp | Beschreibung |
---|---|---|
groupname |
sysname |
Name der Dateigruppe. |
groupid |
smallint |
Numerischer Dateigruppenbezeichner. |
filecount |
int |
Die Anzahl von Dateien in der Dateigruppe. |
Wenn name angegeben ist, wird eine Zeile für jede Datei in der Dateigruppe zurückgegeben.
Spaltenname | Datentyp | Beschreibung |
---|---|---|
file_in_group |
sysname |
Der logische Name der Datei in der Dateigruppe. |
fileid |
smallint |
Numerischer Dateibezeichner. |
filename |
nchar(260) |
Der physikalische Name der Datei, einschließlich des Verzeichnispfades. |
size |
nvarchar(15) |
Die Dateigröße in KB. |
maxsize |
nvarchar(15) |
Die maximale Größe der Datei. Dies ist die 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(15) |
Vergrößerungsinkrement der Datei. Dies zeigt den Speicherplatz an, der jedes Mal der Datei hinzugefügt wird, wenn neuer Speicherplatz benötigt wird. 0 = Die Datei weist eine feste Größe auf und wird nicht vergrößert. |
Berechtigungen
Erfordert die Mitgliedschaft in der public-Rolle.
Beispiele
A. Zurückgeben aller Dateigruppen in einer Datenbank
Im folgenden Beispiel werden Informationen zu den Dateigruppen in der AdventureWorks
-Beispieldatenbank zurückgegeben.
USE AdventureWorks;
GO
EXEC sp_helpfilegroup;
GO
B. Zurückgeben aller Dateien in einer Dateigruppe
Im folgenden Beispiel werden Informationen zu allen Dateien in der PRIMARY
-Dateigruppe der AdventureWorks
-Beispieldatenbank zurückgegeben.
USE AdventureWorks;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO
Siehe auch
Verweis
Gespeicherte Prozeduren für das Datenbankmodul (Transact-SQL)
sp_helpfile (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)
sys.filegroups (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)
Andere Ressourcen
Grundlegendes zu Dateien und Dateigruppen