sp_helpfilegroup (Transact-SQL)
Gilt für: 
SQL Server
Gibt die Namen und Attribute von Dateigruppen zurück, die der aktuellen Datenbank zugeordnet sind.
Transact-SQL-Syntaxkonventionen
Syntax
sp_helpfilegroup [ [ @filegroupname = ] N'filegroupname' ]
[ ; ]
Argumente
[ @filegroupname = ] N'filegroupname'
@filegroupname ist "sysname" mit einem Standardwert von NULL.
Der logische Name einer beliebigen Dateigruppe in der aktuellen Datenbank. @filegroupname ist "sysname" mit einem Standardwert von NULL. Wenn @filegroupname nicht angegeben ist, werden alle Dateigruppen in der aktuellen Datenbank aufgelistet, und nur das erste Resultset, das im Abschnitt "Resultsets" angezeigt wird.
Rückgabecodewerte
0 (erfolgreich) oder 1 Fehler.
Resultset
| Spaltenname | Datentyp | Beschreibung |
|---|---|---|
groupname |
sysname | Name der Dateigruppe. |
groupid |
smallint | Numerischer Dateigruppenbezeichner. |
filecount |
int | Die Anzahl von Dateien in der Dateigruppe. |
Wenn @filegroupname 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 physische 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. Ein Wert UNLIMITED in diesem Feld gibt an, dass die Datei wächst, bis der Datenträger voll ist. |
growth |
nvarchar(15) | Vergrößerungsinkrement der Datei. Dieser Wert gibt an, wie viel Speicherplatz der Datei hinzugefügt wird, wenn neuer Speicherplatz erforderlich ist.0 = Datei ist eine feste Größe und wächst nicht. |
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 AdventureWorks2022 -Beispieldatenbank zurückgegeben.
USE AdventureWorks2022;
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 AdventureWorks2022 -Beispieldatenbank zurückgegeben.
USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO