FILEPROPERTY (Transact-SQL)

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

适用范围:SQL Server(SQL Server 2008 到当前版本)。

主题链接图标 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_filessys.database_files 目录视图中的 name 列相对应。

示例

以下示例返回 AdventureWorks2012 数据库中的 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)