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 = 檔案是固定大小且不會成長。

權限

需要 public 角色的成員資格。

範例

A. 傳回資料庫中的所有檔案群組

下列範例會傳回範例資料庫中檔案群組 AdventureWorks2022 的相關信息。

USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup;
GO

B. 傳回檔案群組中的所有檔案

下列範例會傳回範例資料庫中檔案群組AdventureWorks2022PRIMARY所有檔案的資訊。

USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO