sp_helpfilegroup (Transact-SQL)

適用対象: SQL サーバー

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

Transact-SQL 構文表記規則

構文

sp_helpfilegroup [ [ @filegroupname = ] N'filegroupname' ]
[ ; ]

引数

[ @filegroupname = ] N'filegroupname'

@filegroupnamesysname で、既定値は NULL です。

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

リターン コードの値

0 (成功) または 1 (失敗)。

結果セット

列名 データ型 説明
groupname sysname ファイル グループの名前。
groupid smallint 数値ファイル グループ識別子です。
filecount int ファイル グループ内のファイルの数。

@filegroupnameを指定すると、ファイル グループ内のファイルごとに 1 行が返されます。

列名 データ型 説明
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