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


FILEPROPERTY (Transact-SQL)

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

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

FILEPROPERTY ( file_name , property )  

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

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

Примеры

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

SELECT FILEPROPERTY('AdventureWorks2022_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)