FILE_ID (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

Para o nome lógico específico para um arquivo de componente do banco de dados atual, essa função retorna o número de identificação (ID) do arquivo.

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Use FILE_IDEX.

Convenções de sintaxe de Transact-SQL

Sintaxe

FILE_ID ( file_name )

Argumentos

file_name
Uma expressão do tipo sysname, que representa o nome lógico do arquivo cujo valor de ID de arquivo será retornado por FILE_ID.

Tipos de retorno

smallint

Comentários

file_name corresponde ao nome de arquivo lógico exibido na coluna name nas exibições do catálogo sys.master_files ou sys.database_files.

O FILE_ID retorna NULL se file_name não corresponde ao nome lógico de um arquivo de componente do banco de dados atual.

No SQL Server, o número de identificação de arquivo atribuído a catálogos de texto completo excede 32767. Como a função FILE_ID tem um tipo de retorno smallint, FILE_ID não dará suporte a arquivos de texto completo. Use FILE_IDEX.

Exemplos

Este exemplo retorna o valor de ID de arquivo para o arquivo AdventureWorks2022_Data, um arquivo de componente do banco de dados AdventureWorks2022.

USE AdventureWorks2022;  
GO  
SELECT FILE_ID('AdventureWorks2022_Data')AS 'File ID';  
GO

Veja a seguir o conjunto de resultados.

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

Confira também

Recursos do Mecanismo de Banco de Dados preteridos no SQL Server 2016
FILE_NAME (Transact-SQL)
funções de metadados (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)