FILE_ID (Transact-SQL)

Область применения: SQL Server Управляемый экземпляр SQL Azure

Для указанного логического имени файла компонента текущей базы данных эта функция возвращает идентификатор файла.

Внимание

Эта функция будет удалена в будущей версии SQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Используйте вместо этого функцию FILE_IDEX.

Соглашения о синтаксисе Transact-SQL

Синтаксис

FILE_ID ( file_name )  

Аргументы

file_name
Выражение типа sysname, представляющее имя файла, для которого будет возвращено значение идентификатора файла (FILE_ID).

Типы возвращаемых данных

smallint

Замечания

file_name соответствует логическому имени файла, отображенному в столбце name в представлении каталога sys.master_files или sys.database_files.

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
FILE_NAME (Transact-SQL)
Функции метаданных (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)