sp_helpfilegroup (Transact-SQL)

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

主题链接图标Transact-SQL 语法约定

语法

sp_helpfilegroup [ [ @filegroupname = ] 'name' ]

参数

  • [ @filegroupname = ] 'name'
    当前数据库中任意文件组的逻辑名称。name 的数据类型为 sysname,默认值为 NULL。如果没有指定 name,则列出当前数据库中的所有文件组并只显示在结果集部分中显示的第一个结果集。

返回代码值

0(成功)或 1(失败)

结果集

列名

数据类型

说明

groupname

sysname

文件组的名称。

groupid

smallint

数字文件组标识符。

filecount

int

文件组中的文件数目。

如果指定了 name,则为文件组的每个文件分别返回一行。

列名

数据类型

说明

file_in_group

sysname

文件组中文件的逻辑名称。

fileid

smallint

数字文件标识符。

filename

nchar(260)

文件的物理名称,包括目录路径。

size

nvarchar(15)

文件大小 (KB)。

maxsize

nvarchar(15)

文件的最大大小。

这是文件可增长到的最大大小。此字段中的 UNLIMITED 值表示文件可以一直增长到磁盘变满为止。

growth

nvarchar(15)

文件的增量。表示每次需要新的空间时给文件增加的空间大小。

0 = 文件的大小是固定的,不会增长。

权限

要求具有 public 角色的成员身份。

示例

A. 返回数据库中的所有文件组

下面的示例返回有关 AdventureWorks 示例数据库中文件组的信息。

USE AdventureWorks;
GO
EXEC sp_helpfilegroup;
GO

B. 返回文件组中的所有文件

下面的示例返回有关 AdventureWorks 示例数据库的 PRIMARY 文件组中所有文件的信息。

USE AdventureWorks;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO