FILEPROPERTY (Transact-SQL)

Artículo
05/15/2023

Se aplica a:SQL Server Azure SQL Managed Instance

Devuelve el valor de una propiedad de nombre de archivo especificada 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.

Convenciones de sintaxis de Transact-SQL

Sintaxis

FILEPROPERTY ( file_name , property )

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

file_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	Valor devuelto
IsReadOnly	El grupo de archivos es de solo lectura.	1 = True 0 = False NULL = La entrada no es válida.
IsPrimaryFile	El archivo es el archivo principal.	1 = True 0 = False NULL = La entrada no es válida.
IsLogFile	El archivo es un archivo de registro.	1 = True 0 = False NULL = La entrada no es válida.
SpaceUsed	Cantidad de espacio utilizada por el archivo especificado.	Número de páginas asignadas en el archivo.

Tipos de valor devuelto

int

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 la propiedad IsPrimaryFile para el nombre de archivo AdventureWorks_Data de la base de datos AdventureWorks2022.

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

El conjunto de resultados es el siguiente:

Primary File   
-------------  
1  
(1 row(s) 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)