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