FILEPROPERTY (Transact-SQL)

2025-06-06

Gilt für:SQL Server Azure SQL Managed Instance

Gibt den Eigenschaftswert für den angegebenen Dateinamen zurück, wenn ein Dateiname in der aktuellen Datenbank und ein Eigenschaftsname angegeben sind. Gibt NULL für Dateien zurück, die sich nicht in der aktuellen Datenbank befinden.

Transact-SQL-Syntaxkonventionen

Syntax

FILEPROPERTY ( file_name , property )

Argumente

file_name

Ein Ausdruck, der den Namen der Datei enthält, die der aktuellen Datenbank zugeordnet ist, für die Eigenschaftsinformationen zurückgegeben werden sollen. file_name ist vom Datentyp nchar(128).

Eigentum

Ein Ausdruck, der den Namen der zurückzugebenden Dateieigenschaft enthält. property ist vom Datentyp varchar(128). Die folgenden Werte sind möglich.

Wert	BESCHREIBUNG	Zurückgegebener Wert
`IsReadOnly`	Die Datei ist schreibgeschützt.	1 = True 0 = False NULL = Eingabe ist ungültig.
`IsPrimaryFile`	Datei ist die primäre Datei.	1 = True 0 = False NULL = Eingabe ist ungültig.
`IsLogFile`	Datei ist eine Protokolldatei.	1 = True 0 = False NULL = Eingabe ist ungültig.
`SpaceUsed`	Speicherplatz, der von der angegebenen Datei verwendet wird.	Anzahl der in der Datei zugeordneten Seiten.

Rückgabetypen

Int

Bemerkungen

file_name entspricht der Namensspalte in der sys.master_files Ansicht oder sys.database_files Katalogansicht.

Beispiele

Im folgenden Beispiel wird die Einstellung für die IsPrimaryFile-Eigenschaft des AdventureWorks_Data-Dateinamens in der AdventureWorks2022-Datenbank zurückgegeben.

SELECT FILEPROPERTY('AdventureWorks2022_Data', 'IsPrimaryFile') AS [Primary File];
GO

Hier sehen Sie das Ergebnis.

Primary File
-------------
1

Freigeben über