Share via

FILEPROPERTY (Transact-SQL)

  • Статья

Возвращает указанное значение свойства имени файла, если указываются имя файла и имя свойства.

Значок ссылки на разделСоглашения о синтаксисе в 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 имени файла AdventureWorks_Data в базе данных AdventureWorks.

USE AdventureWorks;
GO
SELECT FILEPROPERTY('AdventureWorks_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)

Справка и поддержка

Получение помощи по SQL Server 2005