FILE_IDEX (Transact-SQL)

Retorna o número de identificação (ID) de arquivo para o nome de arquivo lógico especificado de dados, log ou arquivo de texto completo no banco de dados atual.

Aplica-se a: SQL Server (SQL Server 2008 à versão atual).

Convenções da sintaxe Transact-SQL

Sintaxe

FILE_IDEX ( file_name )

Argumentos

• file_name
  É uma expressão do tipo sysname que representa o nome do arquivo para o qual retornar a ID de arquivo.

Tipos de retorno

int

NULL em erro

Comentários

file_name corresponde ao nome de arquivo lógico exibido na coluna de nome nos modos de exibição de catálogo sys.master_files ou sys.database_files.

FILE_IDEX pode ser usado em uma lista de seleção, cláusula WHERE ou em qualquer local em que uma expressão for permitida. Para obter mais informações, consulte Expressões (Transact-SQL).

Exemplos

A.Recuperando a ID de um arquivo especificado

O exemplo a seguir retorna a ID de arquivo para o arquivo AdventureWorks_Data.

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

Aqui está o conjunto de resultados.

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

B.Recuperando a ID do arquivo quando o nome de arquivo não é conhecido

O exemplo a seguir retorna a ID de arquivo do arquivo de log AdventureWorks selecionando o nome de arquivo lógico na exibição de catálogo sys.database_files em que o tipo de arquivo é igual a 1 (log).

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

Aqui está o conjunto de resultados.

File ID 
------- 
2

C.Recuperando a ID de um arquivo de catálogo de texto completo

O exemplo a seguir retorna a ID de arquivo do arquivo de texto completo selecionando o nome de arquivo lógico na exibição de catálogo sys.database_files em que o tipo de arquivo é igual a 4 (texto completo). Este exemplo retornará NULL se um catálogo de texto completo não existir.

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

Consulte também

Referência

funções de metadados (Transact-SQL)

sys.database_files (Transact-SQL)

sys.master_files (Transact-SQL)