sp_helpfilegroup (Transact-SQL)

适用于:SQL Server

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

Transact-SQL 语法约定

语法

  
sp_helpfilegroup [ [ @filegroupname = ] 'name' ]  

参数

[ @filegroupname = ] 'name' 当前数据库中任何文件组的逻辑名称。 namesysname,默认值为 NULL。 如果未指定 name ,则会列出当前数据库中的所有文件组,并且仅显示“结果集”部分中显示的第一个结果集。

返回代码值

0(成功)或 1(失败)

结果集

列名称 数据类型 说明
groupname sysname 文件组的名称。
groupid smallint 数字文件组标识符。
filecount int 文件组中的文件数目。

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

列名称 数据类型 说明
file_in_group sysname 文件组中文件的逻辑名称。
fileid smallint 数字文件标识符。
filename nchar (260) 文件的物理名称,包括目录路径。
大小 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  

另请参阅

数据库引擎存储过程 (Transact-SQL)
sp_helpfile (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)
sys.filegroups (Transact-SQL)
系统存储过程 (Transact-SQL)
数据库文件和文件组