sp_helpfilegroup (Transact-SQL)
Renvoie le nom et les attributs des groupes de fichiers associés à la base de données active.
Conventions 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.
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.
Valeurs des codes renvoyés
0 (succès) ou 1 (échec)
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 AdventureWorks
.
USE AdventureWorks;
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 AdventureWorks
.
USE AdventureWorks;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO
Voir aussi
Référence
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)
Autres ressources
Présentation des fichiers et des groupes de fichiers