FILE_ID (Transact-SQL)

  • [アーティクル]

適用対象: SQL ServerAzure SQL Managed Instance

この関数は、現在のデータベースのコンポーネント ファイルの特定の論理名に対するファイル識別 (ID) 番号を返します。

重要

この機能は、 SQL Serverの将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 代わりに FILE_IDEX を使用してください。

Transact-SQL 構文表記規則

構文

FILE_ID ( file_name )

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

file_name
ファイル ID 値 FILE_ID を取得するファイルの論理名を表す sysname 型の式です。

戻り値の型

smallint

解説

file_name は、カタログ ビュー sys.master_files または sys.database_files の name 列に表示される論理ファイル名に対応します。

file_name が現在のデータベースのコンポーネント ファイルの論理名に対応していない場合、FILE_ID は NULL を返します。

SQL Server では、フルテキスト カタログに 32,767 より大きいファイル識別番号が割り当てられます。 FILE_ID 関数の戻り値の型は smallint なので、FILE_ID はフルテキスト ファイルをサポートしません。 代わりに FILE_IDEX を使用してください。

例

この例では、AdventureWorks2022 データベースのコンポーネント ファイルである AdventureWorks2022_Data ファイルのファイル ID 値が返されます。

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)