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 = ] 'name' ]

Arguments

[ @filegroupname = ] 'name' Nom logique d’un groupe de fichiers dans la base de données active. name est sysname, avec une valeur par défaut NULL. Si le nom 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 s’affiche.

Codet de retour

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

Jeux 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 le nom 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. 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

R. 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 AdventureWorks2022.

USE AdventureWorks2022;  
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 AdventureWorks2022.

USE AdventureWorks2022;  
GO  
EXEC sp_helpfilegroup 'PRIMARY';  
GO

Voir aussi

Procédures stockées du moteur de base de données (Transact-SQL)
sp_helpfile (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)
sys.filegroups (Transact-SQL)
Procédures stockées système (Transact-SQL)
Groupes de fichiers et fichiers de base de données