• Статья

FILEPROPERTY (Transact-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 соответствует столбцу name в представлении каталога sys.master_files или sys.database_files.

Примеры

В следующем примере возвращается параметр для свойства IsPrimaryFile имени файла AdventureWorks2008R2_Data в базе данных База данных AdventureWorks2008R2.

USE AdventureWorks2008R2;
GO
SELECT FILEPROPERTY('AdventureWorks2008R2_Data', 'IsPrimaryFile')AS [Primary File];
GO

Ниже приводится результирующий набор.

Primary File 
-------------
1
(1 row(s) affected)