file-name-transact-sql.md

title	FILE_NAME (Transact-SQL)
description	FILE_NAME (Transact-SQL)
author	markingmyname
ms.author	maghan
ms.date	03/03/2017
ms.service	sql
ms.subservice	t-sql
ms.topic	reference
f1_keywords	FILE_NAME_TSQL FILE_NAME
helpviewer_keywords	viewing file names file names [SQL Server], FILE_NAME IDs [SQL Server], files file IDs [SQL Server] names [SQL Server], files displaying file names identification numbers [SQL Server], files FILE_NAME function logical file names [SQL Server]
dev_langs	TSQL

FILE_NAME (Transact-SQL)

[!INCLUDE SQL Server Azure SQL Managed Instance]

This function returns the logical file name for a given file identification (ID) number, in the context of the current database.

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions

Syntax

FILE_NAME ( file_id )   

Arguments

file_id
The file identification number whose file name FILE_NAME will return. file_id has an int data type.

Return Types

nvarchar(128)

Remarks

file_ID corresponds to the file_id column in the sys.master_files catalog view or the sys.database_files catalog view.

Examples

This example returns the file names for file_ID 1 and file_ID in the [!INCLUDEssSampleDBnormal] database.

SELECT FILE_NAME(1) AS 'File Name 1', FILE_NAME(2) AS 'File Name 2';  
GO  

[!INCLUDEssResult]

File Name 1                File Name 2  
-------------------------  ------------------------  
AdventureWorks2022_Data    AdventureWorks2022_Log  

(1 row(s) affected)

See Also

FILE_IDEX (Transact-SQL)
Metadata Functions (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)