sp_helpfilegroup (Transact-SQL)
適用対象: 
SQL Server
現在のデータベースに関連付けられたファイル グループの名前と属性を返します。
構文
sp_helpfilegroup [ [ @filegroupname = ] N'filegroupname' ]
[ ; ]
引数
[ @filegroupname = ] N'filegroupname'
@filegroupname は sysname で、既定値は NULL です。
現在のデータベース内の任意のファイル グループの論理名。 @filegroupname は sysname で、既定値は 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