Share via

sp_helpfilegroup (Transact-SQL)

  • Article

S’applique à :SQL Server

Renvoie le nom et les attributs des groupes de fichiers associés à la base de données active.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @filegroupname = ] N’filegroupname'

@filegroupname est sysname, avec la valeur par défaut NULL.

Nom logique d’un groupe de fichiers dans la base de données active. @filegroupname est sysname, avec la valeur par défaut NULL. Si @filegroupname n’est pas spécifié, tous les groupes de fichiers de la base de données active sont répertoriés et seul le premier jeu de résultats affiché dans la section Jeux de résultats est affiché.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Jeu de résultats

Nom de la colonne Type de données Description
groupname sysname Nom du groupe de fichiers
groupid smallint Identificateur numérique du groupe de fichiers.
filecount int Nombre de fichiers appartenant au groupe de fichiers.

Si @filegroupname est spécifié, une ligne pour chaque fichier du groupe de fichiers est retournée.

Nom de la colonne Type de données Description
file_in_group sysname Nom logique du fichier dans le groupe de fichiers.
fileid smallint Identificateur numérique du fichier.
filename nchar(260) Nom physique du fichier, y compris le chemin d'accès du répertoire.
size nvarchar(15) Taille du fichier en kilo-octets.
maxsize nvarchar(15) Taille maximale du fichier.

Taille maximale que peut atteindre le fichier. Une valeur de UNLIMITED ce champ indique que le fichier augmente jusqu’à ce que le disque soit plein.
growth nvarchar(15) Incrément de croissance du fichier. Cette valeur indique la quantité d’espace ajoutée au fichier chaque fois que de nouveaux espaces sont nécessaires.

0 = Le fichier est une taille fixe et ne croît pas.

Autorisations

Nécessite l'appartenance au rôle public .

Exemples

R. Retourner tous les groupes de fichiers dans une base de données

L'exemple suivant renvoie des informations sur les groupes de fichiers dans la base de données exemple AdventureWorks2022.

USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup;
GO

B. Retourner tous les fichiers d’un groupe de fichiers

L'exemple suivant renvoie des informations sur tous les fichiers du groupe de fichiers PRIMARY dans la base de données exemple AdventureWorks2022.

USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO

Contenu connexe