sp_helpfilegroup (Transact-SQL)

現在のデータベースに関連付けられたファイルグループの名前と属性を返します。

構文

sp_helpfilegroup [ [ @filegroupname = ] 'name' ]

[ @filegroupname = ] 'name'
データベース内のファイルグループの論理名を指定します。name のデータ型は sysname で、既定値は NULL です。name を指定しない場合は、現在のデータベース内にあるすべてのファイルグループの一覧が返されます。この場合は、結果セットセクションに示す最初の結果セットのみが表示されます。

成功した場合は 0 を、失敗した場合は 1 をそれぞれ返します。

name を指定した場合は、ファイルグループ内のファイルごとに 1 行のデータが返されます。

列名	データ型	説明
file_in_group	sysname	ファイルグループ内のファイルの論理名です。
fileid	smallint	数値ファイル識別子です。
filename	nchar(260)	ディレクトリパスを含むファイルの物理名です。
size	nvarchar(15)	ファイルサイズ (KB 単位) です。
maxsize	nvarchar(15)	ファイルの最大サイズです。この値は、ファイルのサイズの上限です。このフィールドの値が UNLIMITED である場合、ディスクがいっぱいになるまでファイルを拡張できることを示します。
growth	nvarchar(15)	ファイルを拡張するときの増分です。これは、新たに領域が必要になるたびにファイルに追加する容量を示します。 0 = ファイルのサイズは固定されており、容量を追加することはできません。

public ロールのメンバシップである必要があります。

次の例は、AdventureWorks サンプルデータベースのファイルグループに関する情報を返します。

USE AdventureWorks;
GO
EXEC sp_helpfilegroup;
GO

次の例は、AdventureWorks サンプルデータベースの PRIMARY ファイルグループにあるすべてのファイルの情報を返します。

USE AdventureWorks;
GO
EXEC sp_helpfilegroup 'PRIMARY';
GO