Freigeben über


sp_helpfilegroup (Transact-SQL)

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

Themenlink (Symbol)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