FILEPROPERTYEX (Transact-SQL)

Статья
2025-01-02

Применимо к: База данных SQL Azure Управляемый экземпляр SQL Azure

Возвращает указанное значение расширенного свойства файла, если указываются имя файла текущей базы данных и имя свойства. Возвращает значение NULL для файлов, которые отсутствуют в текущей базе данных, или для несуществующих расширенных свойств файла. В настоящее время расширенные свойства файла применяются только к базам данных, которые находятся в хранилище BLOB-объектов Azure.

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

Синтаксис

FILEPROPERTYEX ( name , property )

Аргументы

name
Выражение, которое содержит имя файла, связанного с текущей базой данных, для которого нужно возвратить сведения о свойстве. Аргумент file_name имеет тип nchar(128).

свойство
Выражение, которое содержит имя свойства файла, которое нужно возвратить. Аргумент property имеет тип varchar(128) и может принимать одно из перечисленных ниже значений.

значение	Описание
BlobTier	Уровень целевого страничного BLOB-объекта Azure. Применяется только к базам данных категорий "Стандартный" или "Общего назначения", использующим хранилище страничных BLOB-объектов Azure.
AccountType	Тип учетной записи хранения, указывающий, является ли она учетной записью хранения BLOB-объектов или файлов, а также является ли она учетной записью хранения класса Premium или Standard.
IsInferredTier	Указывает, является ли уровень неявным (выводимым), размер которого может увеличиваться с ростом данных, или явным (фиксированным).
IsPageBlob	Указывает, является ли целевой BLOB-объект страничным.

Типы возвращаемых данных

sql_variant

Замечания

Аргумент file_name соответствует столбцу name в представлении каталога sys.master_files или sys.database_files.

Примеры

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

SELECT s.file_id,
       s.type_desc,
       s.name,
       FILEPROPERTYEX(s.name, 'BlobTier') AS BlobTier,
       FILEPROPERTYEX(s.name, 'AccountType') AS AccountType,
       FILEPROPERTYEX(s.name, 'IsInferredTier') AS IsInferredTier,
       FILEPROPERTYEX(s.name, 'IsPageBlob') AS IsPageBlob
FROM sys.database_files AS s
WHERE s.type_desc IN ('ROWS', 'LOG');

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

file_id  type_desc  name  BlobTier  AccountType  IsInferredTier  IsPageBlob
--------------------------------------------------------------------------------------
1     ROWS      data_0  P30  PremiumBlobStorage  0   1
2     LOG       log     P30  PremiumBlobStorage  0   1

(2 rows affected)

См. также

FILEGROUPPROPERTY (Transact-SQL)
Функции метаданных (Transact-SQL)
sp_spaceused (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)