FILEPROPERTY (Transact-SQL)

适用于:SQL ServerAzure SQL 托管实例

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

Transact-SQL 语法约定

语法

FILEPROPERTY ( file_name , property )

参数

file_name

一个表达式,该表达式包含与要为其返回属性信息的当前数据库关联的文件的名称。 file_name 是 nchar(128)

属性

一个表达式,其中包含要返回的文件属性的名称。 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.database_files视图中的名称sys.master_files

示例

以下示例返回 AdventureWorks2022 数据库中的 IsPrimaryFile 文件名的 AdventureWorks_Data 属性的设置。

SELECT FILEPROPERTY('AdventureWorks2022_Data', 'IsPrimaryFile') AS [Primary File];
GO

结果集如下。

Primary File
-------------
1