sp_helpfilegroup (Transact-SQL)

Gäller för:SQL Server

Returnerar namn och attribut för filgrupper kopplade till den aktuella databasen.

Transact-SQL syntaxkonventioner

Syntax

sp_helpfilegroup [ [ @filegroupname = ] N'filegroupname' ]
[ ; ]

Arguments

[ @filegroupname = ] N'filgruppnamn'

@filegroupname är sysname, med standardvärdet .NULL

Det logiska namnet på en filgrupp i den aktuella databasen. @filegroupname är sysname, med standardvärdet .NULL Om @filegroupname inte anges listas alla filgrupper i den aktuella databasen och endast den första resultatuppsättningen som visas i avsnittet Resultatuppsättningar visas.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

Kolumnnamn Datatyp Description
groupname sysname Namnet på filgruppen.
groupid smallint Numerisk filgruppsidentifierare.
filecount int Antal filer i filgruppen.

Om @filegroupname anges returneras en rad för varje fil i filgruppen.

Kolumnnamn Datatyp Description
file_in_group sysname Logiskt namn på filen i filgruppen.
fileid smallint Numerisk filidentifierare.
filename NCar(260) Filens fysiska namn inklusive katalogvägen.
size nvarchar(15) Filstorlek i kilobyte.
maxsize nvarchar(15) Maximal filstorlek.

Detta är den maximala storlek som filen kan växa till. Ett värde på UNLIMITED i detta fält indikerar att filen växer tills disken är full.
growth nvarchar(15) Tillväxtökning av filen. Detta värde anger mängden utrymme som läggs till filen varje gång nytt utrymme behövs.

0 = Filen har en fast storlek och växer inte.

Permissions

Kräver medlemskap i offentlig roll.

Examples

A. Returnera alla filgrupper i en databas

Följande exempel ger information om filgrupperna i exempeldatabasen AdventureWorks2025 .

USE AdventureWorks2022;
GO

EXECUTE sp_helpfilegroup;
GO

B. Returnera alla filer i en filgrupp

Följande exempel returnerar information för alla filer i PRIMARY filgruppen i exempeldatabasen AdventureWorks2025 .

USE AdventureWorks2022;
GO

EXECUTE sp_helpfilegroup 'PRIMARY';
GO