FILEPROPERTY (Transact-SQL)

適用於：SQL Server Azure SQL 受控執行個體

指定了目前資料庫中的檔案名稱和屬性名稱時，傳回指定的檔案名稱屬性值。 針對不在目前資料庫中的檔案，傳回 NULL。

Transact-SQL 語法慣例

語法

FILEPROPERTY ( file_name , property )  

引數

file_name
這是包含傳回屬性資訊所屬的目前資料庫之相關聯檔案名稱的運算式。 file_name 為 nchar(128)。

property
這是包含要傳回之檔案屬性名稱的運算式。 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 目錄檢視中的 name 資料行。

範例

下列範例會傳回資料庫 AdventureWorks2022 中檔名之 屬性AdventureWorks_Data的設定IsPrimaryFile。

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

結果集如下所示。

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

另請參閱

FILEGROUPPROPERTY (Transact-SQL)
中繼資料函數 (Transact-SQL)
sp_spaceused (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)