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 un nombre de propiedad. Devuelve NULL para los archivos que no están en la base de datos actual.

Icono de vínculo a temasConvenciones 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 de tipo varchar(128) y puede tener uno de los siguientes valores.

    Valor

    Descripción

    Valor devuelto

    IsReadOnly

    El grupo de archivos es de sólo 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 AdventureWorks2008R2_Data de la base de datos AdventureWorks2008R2.

USE AdventureWorks2008R2;
GO
SELECT FILEPROPERTY('AdventureWorks2008R2_Data', 'IsPrimaryFile')AS [Primary File];
GO

El conjunto de resultados es el siguiente.

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