FILE_ID (Transact-SQL)

Gilt für:SQL ServerAzure SQL Managed Instance

Für den angegebenen logischen Namen für eine Komponentendatei der aktuellen Datenbank gibt diese Funktion die Datei-ID zurück.

Wichtig

Diese Funktion wird in einer zukünftigen Version von SQL Serverentfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Verwenden Sie stattdessen FILE_IDEX.

Transact-SQL-Syntaxkonventionen

Syntax

FILE_ID ( file_name )  

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

file_name
Ein Ausdruck vom Typ sysname, der den logischen Namen der Datei darstellt, deren Datei-ID-Wert FILE_ID zurückgegeben wird.

Rückgabetypen

smallint

Hinweise

file_name entspricht dem logischen Dateinamen, der in der Namensspalte in den Katalogsichten „sys.master_files“ oder „sys.database_files“ angezeigt wird.

FILE_ID gibt NULL zurück, wenn file_name nicht mit dem logischen Namen einer Komponentendatei der aktuellen Datenbank übereinstimmt.

In SQL Server ist die Volltextkatalogen zugewiesene Datei-ID größer als 32767. Da die FILE_ID-Funktion den Rückgabetyp smallint aufweist, wird FILE_ID keine Volltextdateien unterstützen. Verwenden Sie stattdessen FILE_IDEX.

Beispiele

Dieses Beispiel gibt den Datei-ID-Wert für die AdventureWorks2022_Data-Datei zurück, bei der es sich um eine Komponentendatei der AdventureWorks2022-Datenbank handelt.

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

Hier ist das Resultset.

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

Weitere Informationen

Als veraltet markierte Funktionen der Datenbank-Engine in SQL Server 2016
FILE_NAME (Transact-SQL)
Metadatenfunktionen (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)