FILEPROPERTY (Transact-SQL)

適用于:SQL Server (所有支援的版本) Azure SQL 受控執行個體

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

主題連結圖示Transact-SQL 語法慣例

Syntax

FILEPROPERTY ( file_name , property )  

注意

若要檢視 SQL Server 2014 與更早版本的 Transact-SQL 語法,請參閱舊版文件

引數

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

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

範例

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

SELECT FILEPROPERTY('AdventureWorks2012_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)