FILEPROPERTY (Transact-SQL)

現在のデータベース内のファイル名とプロパティ名を指定したときに、指定されたファイル名のプロパティ値を返します。現在のデータベース内にないファイルの場合は NULL を返します。

構文

FILEPROPERTY ( file_name , property )

Note

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

file_name
プロパティ情報を返す基になる、現在のデータベースに関連付けられたファイルの名前を含む式を指定します。 file_name は nchar (128)です。

property
返されるファイルプロパティの名前を含む式を指定します。 プロパティ は varchar (128), 、値は次のいずれかを指定することができます。

値	説明	返される値
IsReadOnly	ファイルグループが読み取り専用であるかどうかを示します。	1 = True 0 = False NULL = 入力は無効です。
IsPrimaryFile	ファイルはプライマリファイルです。	1 = True 0 = False NULL = 入力は無効です。
IsLogFile	ファイルはログファイルです。	1 = True 0 = False NULL = 入力は無効です。
SpaceUsed	指定されたファイルで使用されている領域のサイズ。	ファイルに割り当てられているページ数

int

file_name に対応する、名前内の列、 sys.master_files または sys.database_files カタログビューです。

次の例では、AdventureWorks2022 データベースのファイル名 AdventureWorks_Data の IsPrimaryFile プロパティに対する設定を取得します。

SELECT FILEPROPERTY('AdventureWorks2022_Data', 'IsPrimaryFile')AS [Primary File];  
GO

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

Primary File   
-------------  
1  
(1 row(s) affected)