Compartir a través de

FILEPROPERTY (Transact-SQL)

Se aplica a:SQL ServerAzure 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 los archivos que no están en la base de datos actual.

Convenciones de sintaxis de Transact-SQL

Sintaxis

FILEPROPERTY ( file_name , property )

Argumentos

file_name

Expresión que contiene el nombre del archivo asociado a la base de datos actual para la que se va a devolver información de propiedad. file_name es nchar(128).

propiedad

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.

Importancia Descripción Valor devuelto
IsReadOnly El archivo 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 retorno

Int

Observaciones

file_name corresponde a la columna de nombre de la sys.master_files vista de catálogo 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

Este es el conjunto de resultados.

Primary File
-------------
1

Contenido relacionado