sp_helpfilegroup (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.傳回資料庫中所有的檔案群組
下列範例會傳回 AdventureWorks2012 範例資料庫中檔案群組的相關資訊。
USE AdventureWorks2012;
GO
EXEC sp_helpfilegroup;
GO
B.傳回檔案群組中所有的檔案
下列範例會傳回 AdventureWorks2012 範例資料庫的 PRIMARY 檔案群組中之所有檔案的相關資訊。
USE AdventureWorks2012;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO
請參閱
參考
Database Engine 預存程序 (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)