FILEPROPERTY (Transact-SQL)

适用于: SQL Server(所有支持的版本) Azure SQL 托管实例

指定当前数据库中的文件名和属性名时,返回指定的文件名属性值。 对于不在当前数据库中的文件,返回 NULL。

主题链接图标Transact-SQL 语法约定

语法

FILEPROPERTY ( file_name , property )  

注意

若要查看 SQL Server 2014 及更早版本的 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 列相对应

示例

以下示例返回 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)