FILEPROPERTY (Transact-SQL)

2025-06-06

Область применения: SQL Server Управляемый экземпляр SQL Azure

Возвращает указанное значение свойства имени файла, если указываются имя файла текущей базы данных и имя свойства. Возвращает файлы 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.master_files или sys.database_files представлении каталога.

Примеры

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

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

Вот результирующий набор.

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

Поделиться через