FILEPROPERTY (Transact-SQL)

Devuelve el valor de una propiedad de nombre de archivo especificada al especificar un nombre de archivo y un nombre de propiedad.

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

Notas

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 AdventureWorks;
GO
SELECT FILEPROPERTY('AdventureWorks_Data', 'IsPrimaryFile')AS [Primary File];
GO

Éste es el conjunto de resultados.

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)

Ayuda e información

Obtener ayuda sobre SQL Server 2005