sp_helpfile (Transact-SQL)

Gilt für:SQL Server

Gibt die physischen Namen und Attribute der Dateien zurück, die der aktuellen Datenbank zugeordnet sind. Bestimmen Sie mithilfe dieser gespeicherten Prozedur die Namen von Dateien, die an den Server angefügt oder von diesem getrennt werden sollen.

Transact-SQL-Syntaxkonventionen

Syntax

  
sp_helpfile [ [ @filename= ] 'name' ]  

Argumente

[ @filename = ] 'name' Der logische Name einer beliebigen Datei in der aktuellen Datenbank. name ist vom Datentyp sysnameund hat den Standardwert NULL. Wenn name nicht angegeben ist, werden die Attribute aller Dateien in der aktuellen Datenbank zurückgegeben.

Rückgabecodewerte

„0“ (erfolgreich) oder „1“ (fehlerhaft)

Resultsets

Spaltenname Datentyp BESCHREIBUNG
name sysname Logischer Dateiname der Datei.
fileid smallint Numerischer Bezeichner der Datei. Wird nicht zurückgegeben, wenn name angegeben wird*.*
filename nchar(260) Physischer Dateiname.
filegroup sysname Dateigruppe, zu der die Datei gehört.

NULL = Die Datei ist eine Protokolldatei. Sie gehört nie zu einer Dateigruppe.
size nvarchar(15) Die Dateigröße in KB.
Maxsize nvarchar(15) Maximale Größe, auf die die Datei vergrößert werden kann. Mit UNLIMITED in diesem Feld kann die Datei so lange vergrößert werden, bis der Datenträger voll ist.
growth nvarchar(15) Vergrößerungsinkrement der Datei. Zeigt die Menge an Speicherplatz an, die jedes Mal der Datei hinzugefügt wird, sobald neuer Speicherplatz erforderlich wird.

0 = Die Datei weist eine feste Größe auf und wird nicht vergrößert.
Verwendung varchar(9) Für die Datendatei ist der Wert "nur Daten" und für die Protokolldatei der Wert "nur Protokoll".

Berechtigungen

Erfordert die Mitgliedschaft in der public -Rolle.

Beispiele

Das folgende Beispiel gibt Informationen zu den Dateien in AdventureWorks2022 zurück.

USE AdventureWorks2022;  
GO  
EXEC sp_helpfile;  
GO  

Weitere Informationen

Gespeicherte Prozeduren für die Datenbank-Engine (Transact-SQL)
sp_helpfilegroup (Transact-SQL)
sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)
sys.filegroups (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)
Datenbankdateien und Dateigruppen