FILEPROPERTY (Transact-SQL)
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 nicht in der aktuellen Datenbank sind.
Gilt für: SQL Server (SQL Server 2008 bis aktuelle Version). |
.gif "Themenlink (Symbol)")
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).property
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
Rückgabewert
IsReadOnly
Dateigruppe ist schreibgeschützt.
1 = True
0 = False
NULL = Eingabe ist nicht gültig.
IsPrimaryFile
Datei ist die primäre Datei.
1 = True
0 = False
NULL = Eingabe ist nicht gültig.
IsLogFile
Datei ist eine Protokolldatei.
1 = True
0 = False
NULL = Eingabe ist nicht gültig.
SpaceUsed
Speicherplatz, der von der angegebenen Datei verwendet wird.
Anzahl der in der Datei zugeordneten Seiten.
Rückgabetypen
int
Hinweise
file_name entspricht der name-Spalte in der Katalogsicht sys.master_files oder sys.database_files.
Beispiele
Im folgenden Beispiel wird die Einstellung für die IsPrimaryFile-Eigenschaft des AdventureWorks_Data-Dateinamens in der AdventureWorks2012-Datenbank zurückgegeben.
SELECT FILEPROPERTY('AdventureWorks2012_Data', 'IsPrimaryFile')AS [Primary File];
GO
Dies ist das Resultset.
Primary File
-------------
1
(1 row(s) affected)
Siehe auch
Verweis
FILEGROUPPROPERTY (Transact-SQL)
Metadatenfunktionen (Transact-SQL)