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.

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)