FILE_IDEX (Transact-SQL)FILE_IDEX (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

Esta función devuelve el número de identificación del archivo (id.) para el nombre lógico especificado de un archivo de datos, registro o texto completo de la base de datos actual.This function returns the file identification (ID) number for the specified logical name of a data, log, or full-text file of the current database.

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

SintaxisSyntax

FILE_IDEX ( file_name )  

ArgumentosArguments

file_namefile_name
Una expresión de tipo sysname que devuelve el valor de id. de archivo "FILE_IDEX" del nombre del archivo.An expression of type sysname that returns the file ID value 'FILE_IDEX' for the name of the file.

Tipos devueltosReturn Types

intint

NULL en caso de errorNULL on error

NotasRemarks

file_name corresponde al nombre de archivo lógico mostrado en la columna name de las vistas de catálogo sys.master_files o sys.database_files.file_name corresponds to the logical file name displayed in the name column from the sys.master_files or sys.database_files catalog views.

Utilice FILE_IDEX en una lista SELECT, en una cláusula WHERE o en cualquier lugar que admita el uso de una expresión.Use FILE_IDEX in a SELECT list, a WHERE clause, or anywhere that supports use of an expression. Para obtener más información, vea Expresiones (Transact-SQL).For more information, see Expressions (Transact-SQL).

EjemplosExamples

A.A. Recuperar el Id. de archivo de un archivo especificadoRetrieving the file id of a specified file

Este ejemplo devuelve el id. de archivo para el archivo AdventureWorks_Data.This example returns the file ID for the AdventureWorks_Data file.

USE AdventureWorks2012;  
GO  
SELECT FILE_IDEX('AdventureWorks2012_Data') AS 'File ID';  
GO  

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

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

B.B. Recuperar el Id. de archivo cuando se desconoce el nombre del archivoRetrieving the file id when the file name is not known

Este ejemplo devuelve el id. de archivo del archivo de registro AdventureWorks.This example returns the file ID of the AdventureWorks log file. El fragmento de código Transact-SQL (T-SQL) selecciona el nombre de archivo lógico de la vista de catálogo sys.database_files, donde el tipo de archivo es igual a 1 (registro).The Transact-SQL (T-SQL) code snippet selects the logical file name from the sys.database_files catalog view, where the file type equals 1 (log).

USE AdventureWorks2012;  
GO  
SELECT FILE_IDEX((SELECT TOP (1) name FROM sys.database_files WHERE type = 1)) AS 'File ID';  
GO  

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

File ID   
-------   
2  

C.C. Recuperar el Id. de archivo de un archivo de catálogo de texto completoRetrieving the file id of a full-text catalog file

Este ejemplo devuelve el id. de archivo de un archivo de texto completo.This example returns the file ID of a full-text file. El fragmento de código T-SQL selecciona el nombre de archivo lógico de la vista de catálogo sys.database_files, donde el tipo de archivo es igual a 4 (texto completo).The T-SQL code snippet selects the logical file name from the sys.database_files catalog view, where the file type equals 4 (full-text). Este código devuelve "NULL" si no existe ningún catálogo de texto completo.This code returns 'NULL' if a full-text catalog does not exist.

SELECT FILE_IDEX((SELECT name FROM sys.master_files WHERE type = 4))  
AS 'File_ID';  

Consulte tambiénSee Also

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