sp_helpfilegroup (Transact-SQL)

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

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

sp_helpfilegroup [ [ @filegroupname = ] 'name' ]

Arguments

  • [@filegroupname = ] 'name'
    Nom logique des groupes de fichiers de la base de données active. name est de type sysname, et sa valeur par défaut est NULL. Si name n'est pas spécifié, tous les groupes de fichiers de la base de données active sont répertoriés, et seul s'affiche le premier ensemble de résultats présenté dans la section Ensembles de résultats.

Valeurs des codes renvoyés

0 (succès) ou 1 (échec)

Jeux de résultats

Nom de 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 name est spécifié, une ligne pour chaque fichier du groupe est retournée.

Nom de 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. La valeur UNLIMITED indique que le fichier peut augmenter jusqu'à ce que le disque soit plein.

growth

nvarchar(15)

Incrément de croissance du fichier. Quantité d'espace ajoutée au fichier chaque fois que de l'espace supplémentaire est nécessaire.

0 = La taille du fichier est fixe et n'augmente pas.

Autorisations

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

Exemples

A. Renvoi de tous les groupes de fichiers d'une base de données

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

USE AdventureWorks2008R2;
GO
EXEC sp_helpfilegroup;
GO

B. Renvoi de 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 AdventureWorks2008R2.

USE AdventureWorks2008R2;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO