FILE_IDEX (Transact-SQL)FILE_IDEX (Transact-SQL)

ОБЛАСТЬ ПРИМЕНЕНИЯ: даSQL Server нетБаза данных SQL Azure нетAzure Synapse Analytics (хранилище данных SQL) нетParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Эта функция возвращает номер идентификатора файла для указанного логического имени файла данных, файла журнала, или полнотекстового файла в текущей базе данных.This function returns the file identification (ID) number for the specified logical name of a data, log, or full-text file of the current database.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQLTopic link icon Transact-SQL Syntax Conventions

СинтаксисSyntax

FILE_IDEX ( file_name )  

АргументыArguments

file_namefile_name
Выражение типа sysname, представляющее имя файла, для которого необходимо вернуть значение идентификатора файла (FILE_IDEX).An expression of type sysname that returns the file ID value 'FILE_IDEX' for the name of the file.

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

intint

NULL в случае ошибкиNULL on error

RemarksRemarks

file_name соответствует логическому имени файла, отображенному в столбце name в представлении каталога sys.master_files или sys.database_files.file_name corresponds to the logical file name displayed in the name column from the sys.master_files or sys.database_files catalog views.

Используйте FILE_IDEX в списке SELECT, предложении WHERE или любом другом объекте с поддержкой выражений.Use FILE_IDEX in a SELECT list, a WHERE clause, or anywhere that supports use of an expression. Дополнительные сведения см. в разделе Выражения (Transact-SQL).For more information, see Expressions (Transact-SQL).

ПримерыExamples

A.A. Получение идентификатора для указанного файлаRetrieving the file id of a specified file

Этот пример возвращает идентификатор файла AdventureWorks_Data.This example returns the file ID for the AdventureWorks_Data file.

USE AdventureWorks2012;  
GO  
SELECT FILE_IDEX('AdventureWorks2012_Data') AS 'File ID';  
GO  

Результирующий набор:Here is the result set.

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

Б.B. Получение идентификатора файла, имя которого неизвестноRetrieving the file id when the file name is not known

Этот пример возвращает идентификатор файла журнала AdventureWorks.This example returns the file ID of the AdventureWorks log file. Фрагмент кода Transact-SQL (T-SQL) выбирает логическое имя файла из представления каталога sys.database_files, где тип файла — 1 (журнал).The Transact-SQL (T-SQL) code snippet selects the logical file name from the sys.database_files catalog view, where the file type equals 1 (log).

USE AdventureWorks2012;  
GO  
SELECT FILE_IDEX((SELECT TOP (1) name FROM sys.database_files WHERE type = 1)) AS 'File ID';  
GO  

Результирующий набор:Here is the result set.

File ID   
-------   
2  

В.C. Получение идентификатора файла полнотекстового файла каталогаRetrieving the file id of a full-text catalog file

Этот пример возвращает идентификатор полнотекстового файла.This example returns the file ID of a full-text file. Фрагмент кода T-SQL выбирает логическое имя файла из представления каталога sys.database_files, где тип файла — 4 (полнотекстовый).The T-SQL code snippet selects the logical file name from the sys.database_files catalog view, where the file type equals 4 (full-text). Этот код возвращает значение NULL, если полнотекстовый каталог не существует.This code returns 'NULL' if a full-text catalog does not exist.

SELECT FILE_IDEX((SELECT name FROM sys.master_files WHERE type = 4))  
AS 'File_ID';  

См. также:See Also

Функции метаданных (Transact-SQL) Metadata Functions (Transact-SQL)
sys.database_files (Transact-SQL) sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)sys.master_files (Transact-SQL)