適用対象:
SQL ServerAzure SQL Managed Instance
現在のデータベース内のファイル名とプロパティ名を指定したときに、指定されたファイル名のプロパティ値を返します。 現在のデータベースにないファイルの NULL を返します。
構文
FILEPROPERTY ( file_name , property )
引数
file_name
プロパティ情報を返す現在のデータベースに関連付けられているファイルの名前を含む式。 file_name は nchar (128)です。
財産
返すファイル プロパティの名前を含む式。 プロパティ は varchar (128), 、値は次のいずれかを指定することができます。
| 値 | 説明 | 返される値 |
|---|---|---|
IsReadOnly |
ファイルは読み取り専用です。 | 1 = 真 0 = 偽 NULL = 入力が無効です。 |
IsPrimaryFile |
ファイルはプライマリ ファイルです。 | 1 = 真 0 = 偽 NULL = 入力が無効です。 |
IsLogFile |
ファイルはログ ファイルです。 | 1 = 真 0 = 偽 NULL = 入力が無効です。 |
SpaceUsed |
指定されたファイルで使用されている領域のサイズ。 | ファイルに割り当てられているページ数 |
戻り値の型
int
解説
file_nameは、またはsys.master_files カタログ ビューのsys.database_files列に対応します。
例
以下の例は、AdventureWorks2025データベース内のAdventureWorks_Dataファイル名のIsPrimaryFileプロパティの設定を返します。
SELECT FILEPROPERTY('AdventureWorks2022_Data', 'IsPrimaryFile') AS [Primary File];
GO
結果セットは次のとおりです。
Primary File
-------------
1