sp_helpfilegroup (Transact-SQL)

Artikel
05/11/2023

Gibt die Namen und Attribute von Dateigruppen zurück, die der aktuellen Datenbank zugeordnet sind.

Syntax

  
sp_helpfilegroup [ [ @filegroupname = ] 'name' ]

Argumente

[ @filegroupname = ] 'name' Der logische Name einer beliebigen Dateigruppe in der aktuellen Datenbank. name ist vom Datentyp sysnameund hat den Standardwert 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“ (erfolgreich) oder „1“ (fehlerhaft)

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 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. 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 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

Weitere Informationen

Gespeicherte Prozeduren für die Datenbank-Engine (Transact-SQL)
sp_helpfile (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)
sys.filegroups (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)
Datenbankdateien und Dateigruppen