sp_helpfilegroup (Transact-SQL)
适用范围：
SQL Server
返回与当前数据库相关联的文件组的名称及属性。
语法
sp_helpfilegroup [ [ @filegroupname = ] N'filegroupname' ]
[ ; ]
参数
[ @filegroupname = ] N'filegroupname'
@filegroupname为 sysname，默认值为 NULL.
当前数据库中任何文件组的逻辑名称。 @filegroupname为 sysname，默认值为 NULL. 如果未 指定@filegroupname ，则会列出当前数据库中的所有文件组，并且仅显示结果集部分中显示的第一个结果集。
返回代码值
0（成功）或 1（失败）。
结果集
| 列名称 | 数据类型 | 描述 |
|---|---|---|
groupname |
sysname | 文件组的名称。 |
groupid |
smallint | 数字文件组标识符。 |
filecount |
int | 文件组中的文件数目。 |
如果 指定了@filegroupname ，则返回文件组中每个文件的一行。
| 列名称 | 数据类型 | 描述 |
|---|---|---|
file_in_group |
sysname | 文件组中文件的逻辑名称。 |
fileid |
smallint | 数字文件标识符。 |
filename |
nchar（260） | 文件的物理名称，包括目录路径。 |
size |
nvarchar（15） | 文件大小 (KB)。 |
maxsize |
nvarchar（15） | 文件的最大大小。 这是文件可增长到的最大大小。 此字段中的值 UNLIMITED 指示文件在磁盘已满之前增长。 |
growth |
nvarchar（15） | 文件的增量。 此值指示每次需要新空间时添加到文件的空间量。0 = 文件是固定大小且不会增长。 |
权限
要求 公共 角色具有成员身份。
示例
A. 返回数据库中的所有文件组
下面的示例返回有关 AdventureWorks2022 示例数据库中文件组的信息。
USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup;
GO
B. 返回文件组中的所有文件
下面的示例返回有关 AdventureWorks2022 示例数据库的 PRIMARY 文件组中所有文件的信息。
USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO