FILEPROPERTY (Transact-SQL)
Возвращает указанное значение свойства имени файла, если указываются имя файла текущей базы данных и имя свойства. Возвращает значение NULL для файлов, которые не находятся в текущей базе данных.
Применимо для следующих объектов: SQL Server (начиная с SQL Server 2008 до текущей версии). |
.gif "Значок ссылки на раздел")
Синтаксические обозначения в 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 в базе данных AdventureWorks2012.
SELECT FILEPROPERTY('AdventureWorks2012_Data', 'IsPrimaryFile')AS [Primary File];
GO
Ниже приводится результирующий набор.
Primary File
-------------
1
(1 row(s) affected)
См. также
Справочник
FILEGROUPPROPERTY (Transact-SQL)
Функции метаданных (Transact-SQL)