FILEPROPERTYEX (Transact-SQL)

Se aplica a: Azure SQL Database Azure SQL Managed Instance

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

syntaxsql

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:

SQL

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)