FILE_ID (Transact-SQL)

適用於:SQL ServerAzure SQL 受控執行個體

對於目前資料庫元件檔案的給定邏輯名稱,此函式會傳回檔案識別碼 (ID)。

重要

SQL Server 的未來版本將移除此功能。 請避免在新的開發工作中使用這項功能,並規劃修改目前使用這項功能的應用程式。 請改用 FILE_IDEX

Transact-SQL 語法慣例

Syntax

FILE_ID ( file_name )  

注意

若要檢視 SQL Server 2014 (12.x) 和舊版的 Transact-SQL 語法,請參閱 舊版檔

引數

file_name
這是 sysname 類型的運算式,代表會傳回其檔案識別碼值 FILE_ID 之檔案的邏輯名稱。

傳回型別

smallint

備註

file_name 對應於 sys.master_files 或 sys.database_files 目錄檢視 name 資料行中所顯示的邏輯檔案名稱。

如果 file_name 未對應於目前資料庫元件檔案的邏輯名稱,FILE_ID 會傳回 NULL

在 SQL Server 中,指派給全文檢索目錄的檔案識別碼會超過 32767。 由於 FILE_ID 函數的傳回類型是 smallint,所以FILE_ID 不支援全文檢索檔案。 請改用 FILE_IDEX

範例

此範例會傳回 AdventureWorks2022_Data 檔案的檔案識別碼值,這是 AdventureWorks2022 資料庫的元件檔案。

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

以下為結果集。

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

另請參閱

SQL Server 2016 中已被取代的 Database Engine 功能
FILE_NAME (Transact-SQL)
中繼資料函數 (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)