FILEPROPERTY (Transact-SQL)FILEPROPERTY (Transact-SQL)

SE APLICA A: síSQL Server (a partir de 2008) noAzure SQL Database noAzure SQL Data Warehouse noAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server (starting with 2008) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

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.Returns the specified file name property value when a file name in the current database and a property name are specified. Devuelve NULL para los archivos que no estén en la base de datos actual.Returns NULL for files that are not in the current database.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

  
FILEPROPERTY ( file_name , property )  

ArgumentosArguments

file_namefile_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.Is an expression that contains the name of the file associated with the current database for which to return property information. file_name es nchar(128) .file_name is nchar(128).

propertyproperty
Es una expresión que contiene el nombre de la propiedad de archivo que se va a devolver.Is an expression that contains the name of the file property to return. property es varchar (128) y puede ser uno de estos valores.property is varchar(128), and can be one of the following values.

ValorValue DescripciónDescription Valor devueltoValue returned
IsReadOnlyIsReadOnly El grupo de archivos es de solo lectura.Filegroup is read-only. 1 = True1 = True

0 = False0 = False

NULL = La entrada no es válida.NULL = Input is not valid.
IsPrimaryFileIsPrimaryFile El archivo es el archivo principal.File is the primary file. 1 = True1 = True

0 = False0 = False

NULL = La entrada no es válida.NULL = Input is not valid.
IsLogFileIsLogFile El archivo es un archivo de registro.File is a log file. 1 = True1 = True

0 = False0 = False

NULL = La entrada no es válida.NULL = Input is not valid.
SpaceUsedSpaceUsed Cantidad de espacio utilizada por el archivo especificado.Amount of space that is used by the specified file. Número de páginas asignadas en el archivo.Number of pages allocated in the file

Tipos devueltosReturn Types

intint

NotasRemarks

file_name corresponde a la columna name de la vista de catálogo sys.master_files o sys.database_files.file_name corresponds to the name column in the sys.master_files or sys.database_files catalog view.

EjemplosExamples

En el siguiente ejemplo se devuelve el valor de la propiedad IsPrimaryFile del nombre de archivo AdventureWorks_Data de la base de datos AdventureWorks2012AdventureWorks2012.The following example returns the setting for the IsPrimaryFile property for the AdventureWorks_Data file name in AdventureWorks2012AdventureWorks2012 the database.

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

El conjunto de resultados es el siguiente.Here is the result set.

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

Consulte tambiénSee Also

FILEGROUPPROPERTY (Transact-SQL) FILEGROUPPROPERTY (Transact-SQL)
Funciones de metadatos (Transact-SQL) Metadata Functions (Transact-SQL)
sp_spaceused (Transact-SQL) sp_spaceused (Transact-SQL)
sys.database_files (Transact-SQL) sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)sys.master_files (Transact-SQL)