sp_helpfilegroup (Transact-SQL)

適用於:SQL Server

傳回與目前資料庫相關聯之檔案群組的名稱和屬性。

Transact-SQL 語法慣例

語法

  
sp_helpfilegroup [ [ @filegroupname = ] 'name' ]  

引數

[ @filegroupname = ] 'name' 這是目前資料庫中任何檔案群組的邏輯名稱。 name sysname ,預設值為 Null。 如果未 指定 name ,則會列出目前資料庫中的所有檔案群組,而且只會顯示結果集區段中顯示的第一個結果集。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

資料行名稱 資料類型 描述
groupname sysname 檔案群組的名稱。
groupid smallint 數值檔案群組識別碼。
filecount int 檔案群組中的檔案數目。

如果 指定名稱 ,則會傳回檔案群組中每個檔案的一個資料列。

資料行名稱 資料類型 描述
file_in_group sysname 檔案群組中檔案的邏輯名稱。
fileid smallint 數值檔案識別碼。
檔案名稱 Nchar(260) 檔案的機構名稱,包括目錄路徑。
size Nvarchar(15) 檔案大小以 KB 為單位。
maxsize Nvarchar(15) 檔案的大小上限。

這是檔案可以成長的大小上限。 此欄位中的 UNLIMITED 值表示檔案會成長到磁片已滿為止。
增長 Nvarchar(15) 檔案的成長增量。 這表示每次需要新空間時新增至檔案的空間量。

0 = 檔案是固定大小且不會成長。

權限

需要 public 角色的成員資格。

範例

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

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

USE AdventureWorks2022;  
GO  
EXEC sp_helpfilegroup;  
GO  

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

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

USE AdventureWorks2022;  
GO  
EXEC sp_helpfilegroup 'PRIMARY';  
GO  

另請參閱

Database Engine 預存程式 (Transact-SQL)
sp_helpfile (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)
sys.filegroups (Transact-SQL)
系統預存程序 (Transact-SQL)
資料庫檔案與檔案群組