FILEPROPERTY (Transact-SQL)

  • 项目

适用于：SQL ServerAzure SQL 托管实例

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

Transact-SQL 语法约定

语法

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)