FILEGROUPPROPERTY (Transact-SQL)

適用対象:SQL ServerAzure SQL Managed Instance

この関数では、指定した名前とファイル グループの値に対する、ファイル グループのプロパティ値を返します。

Transact-SQL 構文表記規則

構文

FILEGROUPPROPERTY ( filegroup_name, property )  

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

filegroup_name
FILEGROUPPROPERTY によって名前付けされたプロパティ情報が返されるファイル グループの名前を表す、sysname 型の式を指定します。

property
ファイル グループのプロパティの名前を返す varchar(128) 型の式を指定します。 property によって返される値は次のいずれかです。

説明 返される値
IsReadOnly ファイル グループが読み取り専用であるかどうかを示します。 1 = TRUE

0 = FALSE

NULL = 無効な入力です。
IsUserDefinedFG ファイル グループはユーザー定義のファイル グループです。 1 = TRUE

0 = FALSE

NULL = 無効な入力です。
IsDefault ファイルは既定のファイル グループです。 1 = TRUE

0 = FALSE

NULL = 無効な入力です。

戻り値の型

int

解説

filegroup_name は、sys.filegroups カタログ ビューの name 列に対応します。

この例では、AdventureWorks2022 データベースのプライマリ ファイル グループに対する IsDefault プロパティの設定が返されます。

SELECT FILEGROUPPROPERTY('PRIMARY', 'IsDefault') AS 'Default Filegroup';  
GO  

結果セットは次のようになります。

Default Filegroup   
---------------------   
1  
  
(1 row(s) affected)  

参照

FILEGROUP_ID (Transact-SQL)
FILEGROUP_NAME (Transact-SQL)
メタデータ関数 (Transact-SQL)
SELECT (Transact-SQL)
sys.filegroups (Transact-SQL)