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)