sp_helpfilegroup (Transact-SQL)

适用于:SQL Server

返回与当前数据库相关联的文件组的名称及属性。

Transact-SQL 语法约定

语法

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