sp_helpfilegroup (Transact-SQL)sp_helpfilegroup (Transact-SQL)

S’APPLIQUE À : ouiSQL Server nonAzure SQL Database nonAzure Synapse Analytics (SQL DW) nonParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Renvoie le nom et les attributs des groupes de fichiers associés à la base de données active.Returns the names and attributes of filegroups associated with the current database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

  
sp_helpfilegroup [ [ @filegroupname = ] 'name' ]  

ArgumentsArguments

[ @filegroupname = ] 'name' Est le nom logique des groupes de fichiers dans la base de données actuelle.[ @filegroupname = ] 'name' Is the logical name of any filegroup in the current database. nom est sysname, avec NULL comme valeur par défaut.name is sysname, with a default of NULL. Si nom n’est pas spécifié, tous les groupes de fichiers dans la base de données active sont répertoriées et uniquement le premier jeu de résultats dans la section jeux de résultats s’affiche.If name is not specified, all filegroups in the current database are listed and only the first result set shown in the Result Sets section is displayed.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

Jeux de résultatsResult Sets

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
groupnamegroupname sysnamesysname Nom du groupe de fichiersName of the filegroup.
groupidgroupid smallintsmallint Identificateur numérique du groupe de fichiers.Numeric filegroup identifier.
filecountfilecount intint Nombre de fichiers appartenant au groupe de fichiers.Number of files in the filegroup.

Si nom est spécifié, une ligne pour chaque fichier dans le groupe de fichiers est retournée.If name is specified, one row for each file in the filegroup is returned.

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
file_in_groupfile_in_group sysnamesysname Nom logique du fichier dans le groupe de fichiers.Logical name of the file in the filegroup.
fileidfileid smallintsmallint Identificateur numérique du fichier.Numeric file identifier.
filenamefilename nchar(260)nchar(260) Nom physique du fichier, y compris le chemin d'accès du répertoire.Physical name of the file including the directory path.
sizesize nvarchar(15)nvarchar(15) Taille du fichier en kilo-octets.File size in kilobytes.
maxsizemaxsize nvarchar(15)nvarchar(15) Taille maximale du fichier.Maximum size of the file.

Taille maximale que peut atteindre le fichier.This is the maximum size to which the file can grow. La valeur UNLIMITED indique que le fichier peut augmenter jusqu'à ce que le disque soit plein.A value of UNLIMITED in this field indicates that the file grows until the disk is full.
growthgrowth nvarchar(15)nvarchar(15) Incrément de croissance du fichier.Growth increment of the file. Quantité d'espace ajoutée au fichier chaque fois que de l'espace supplémentaire est nécessaire.This indicates the amount of space added to the file every time new space is required.

0 = La taille du fichier est fixe et n'augmente pas.0 = File is a fixed size and will not grow.

AutorisationsPermissions

Nécessite l'appartenance au rôle public .Requires membership in the public role.

ExemplesExamples

R.A. Renvoi de tous les groupes de fichiers d'une base de donnéesReturning all filegroups in a database

L'exemple suivant renvoie des informations sur les groupes de fichiers dans la base de données exemple AdventureWorks2012AdventureWorks2012.The following example returns information about the filegroups in the AdventureWorks2012AdventureWorks2012 sample database.

USE AdventureWorks2012;  
GO  
EXEC sp_helpfilegroup;  
GO  

B.B. Renvoi de tous les fichiers d'un groupe de fichiersReturning all files in a filegroup

L'exemple suivant renvoie des informations sur tous les fichiers du groupe de fichiers PRIMARY dans la base de données exemple AdventureWorks2012AdventureWorks2012.The following example returns information for all files in the PRIMARY filegroup in the AdventureWorks2012AdventureWorks2012 sample database.

USE AdventureWorks2012;  
GO  
EXEC sp_helpfilegroup 'PRIMARY';  
GO  

Voir aussiSee Also

Procédures stockées du moteur de base de données (Transact-SQL) Database Engine Stored Procedures (Transact-SQL)
sp_helpfile (Transact-SQL) sp_helpfile (Transact-SQL)
sys.database_files (Transact-SQL) sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL) sys.master_files (Transact-SQL)
sys.filegroups (Transact-SQL) sys.filegroups (Transact-SQL)
Procédures stockées système (Transact-SQL) System Stored Procedures (Transact-SQL)
Groupes de fichiers et fichiers de base de donnéesDatabase Files and Filegroups