FILE_ID (Transact-SQL)

Статья
03/12/2024

Применимо к:SQL Server Управляемый экземпляр SQL Azure

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

Внимание

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

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

Синтаксис

FILE_ID ( file_name )

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

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)