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.

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 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