FILEPROPERTY (Transact-SQL)

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.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

FILEPROPERTY ( file_name , property )

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 de tipo 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 los siguientes valores.

    Valor

    Descripción

    Valor devuelto

    IsReadOnly

    El grupo de archivos es de solo lectura.

    1 = Verdadero

    0 = Falso

    NULL = La entrada no es válida.

    IsPrimaryFile

    El archivo es el archivo principal.

    1 = Verdadero

    0 = Falso

    NULL = La entrada no es válida.

    IsLogFile

    El archivo es un archivo de registro.

    1 = Verdadero

    0 = Falso

    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 devueltos

int

Comentarios

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 del nombre de archivo AdventureWorks_Data de la base de datos AdventureWorks.

USE AdventureWorks2012;
GO
SELECT FILEPROPERTY('AdventureWorks2012_Data', 'IsPrimaryFile')AS [Primary File];
GO

El conjunto de resultados es el siguiente.

Primary File 
-------------
1
(1 row(s) affected)

Vea también

Referencia

FILEGROUPPROPERTY (Transact-SQL)

Funciones de metadatos (Transact-SQL)

sp_spaceused (Transact-SQL)

sys.database_files (Transact-SQL)

sys.master_files (Transact-SQL)