FILEPROPERTY (Transact-SQL)

適用於：SQL ServerAzure SQL 受控執行個體

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

Transact-SQL 語法慣例

Syntax

FILEPROPERTY ( file_name , property )  

注意

若要檢視 SQL Server 2014 （12.x） 和舊版的 Transact-SQL 語法，請參閱 舊版檔。

引數

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)