適用於：
SQL ServerAzure SQL 受控執行個體
指定了目前資料庫中的檔案名稱和屬性名稱時，傳回指定的檔案名稱屬性值。 針對 NULL 不在目前資料庫中的檔案傳回 。
語法
FILEPROPERTY ( file_name , property )
引數
file_name
表達式，其中包含與要傳回屬性資訊之目前資料庫相關聯的檔名。 file_name 為 nchar(128)。
財產
表達式，其中包含要傳回之檔案屬性的名稱。 property 為 varchar(128)，而且可以是下列值之一。
| 值 | 描述 | 傳回的值 |
|---|---|---|
IsReadOnly |
檔案是唯讀的。 | 1 = 正確 0 = 錯誤 NULL = 輸入無效。 |
IsPrimaryFile |
檔案是主要檔案。 | 1 = 正確 0 = 錯誤 NULL = 輸入無效。 |
IsLogFile |
檔案是記錄檔。 | 1 = 正確 0 = 錯誤 NULL = 輸入無效。 |
SpaceUsed |
指定檔案所用的空間量。 | 檔案中所配置的頁數 |
傳回類型
int
備註
file_name會對應至 或 目錄檢視中sys.master_filessys.database_files數據行。
範例
以下範例回傳 AdventureWorks2025 資料庫中檔名屬性AdventureWorks_Data的設定IsPrimaryFile。
SELECT FILEPROPERTY('AdventureWorks2022_Data', 'IsPrimaryFile') AS [Primary File];
GO
結果集如下所示。
Primary File
-------------
1