sp_helpfilegroup (Transact-SQL)

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

主題連結圖示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. 傳回資料庫中所有的檔案群組

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

USE AdventureWorks2008R2;
GO
EXEC sp_helpfilegroup;
GO

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

下列範例會傳回 AdventureWorks2008R2 範例資料庫的 PRIMARY 檔案群組中之所有檔案的相關資訊。

USE AdventureWorks2008R2;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO