FILEPROPERTYEX (Transact-SQL)

Aplica a:Azure SQL DatabaseAzure SQL Managed InstanceBase de datos SQL en Microsoft Fabric

Devuelve el valor de propiedad de archivo extendida especificado al especificar un nombre de archivo en la base de datos actual y un nombre de propiedad. Devuelve NULL para los archivos que no están en la base de datos actual o para las propiedades de archivo extendidas que no existen. Actualmente, las propiedades de archivo extendidas solo se aplican a las bases de datos que están en Azure Blob Storage.

Convenciones de sintaxis de Transact-SQL

Sintaxis

FILEPROPERTYEX ( name , property )  

Argumentos

name
Es una expresión que contiene el nombre del archivo asociado a la base de datos actual de la que se va a devolver información de propiedades. file_name es nchar(128).

property
Es una expresión que contiene el nombre de la propiedad de archivo que se va a devolver. property es varchar (128) y puede ser uno de estos valores.

Value	Descripción
BlobTier	Nivel de blob en páginas de Azure de destino. Solo se aplica a las bases de datos Standard y GeneralPurpose que usa el almacenamiento de blobs en páginas de Azure.
AccountType	Tipo de cuenta de almacenamiento que indica si se trata de almacenamiento de blobs o de almacenamiento de archivos y si es un almacenamiento Premium o estándar.
IsInferredTier	Indica si el nivel es un nivel implícito (deducido) que podría crecer con el tamaño de los datos o un nivel explícito (fijo).
IsPageBlob	Indica si el blob de destino es un blob en páginas o no.

Tipos de valor devuelto

sql_variant

Observaciones

file_name corresponde a la columna name de la vista de catálogo sys.master_files o sys.database_files.

Ejemplos

En el siguiente ejemplo se devuelve el valor de los archivos de base de datos:

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');

Este es el conjunto de resultados.

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)

Consulte también

FILEGROUPPROPERTY (Transact-SQL)
Funciones de metadatos (Transact-SQL)
sp_spaceused (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)