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 = 檔案是固定大小且不會成長。 |
權限
需要 public 角色的成員資格。
範例
A. 傳回資料庫中的所有檔案群組
下列範例會傳回範例資料庫中檔案群組 AdventureWorks2022 的相關信息。
USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup;
GO
B. 傳回檔案群組中的所有檔案
下列範例會傳回範例資料庫中檔案群組AdventureWorks2022中PRIMARY所有檔案的資訊。
USE AdventureWorks2022;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO