sp_helpfilegroup (Transact-SQL)
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) or 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