xp_read_file-Systemprozedur

xp_read_file(
filename
[, lazy ]
)

filename Verwenden Sie diesen LONG VARCHAR-Parameter, um den Namen der Datei anzugeben, deren Inhalt zurückgegeben werden soll.
lazy Wenn Sie diesen optionalen INTEGER-Parameter angeben und sein Wert nicht 0 ist, wird der Inhalt der Datei erst auf Anforderung gelesen. Lesevorgänge treten nur auf, wenn auf den LONG BINARY-Wert zugegriffen wird, und nur für den angeforderten Teil der Datei. Der Standardwert ist 0 oder "non-lazy".

Diese Funktion gibt den Inhalt der angegebenen Datei als LONG BINARY-Wert zurück. Wenn die Datei nicht vorhanden ist oder nicht gelesen werden kann, wird NULL zurückgegeben.

Der Dateiname in filename ist relativ zum Startverzeichnis des Datenbankservers.

Die Funktion kann beim Einfügen ganzer, in Dateien gespeicherter Dokumente oder Bilder in Tabellen hilfreich sein. Falls die Datei nicht gelesen werden kann, gibt die Funktion NULL zurück.

Wenn die Datendatei in einem anderen Zeichensatz geschrieben ist, können Sie die CSCONVERT-Funktion verwenden, um sie zu konvertieren.

Sie können die CSCONVERT-Funktion auch verwenden, um die für die xp_read_file-Systemprozedur erforderliche Zeichensatzkonvertierung durchzuführen.

Sie müssen das READ FILE-Systemprivileg haben.

Die folgende Anweisung fügt ein Bild in eine Spalte namens Photo in der Tabelle "Products" ein.

UPDATE Products
SET Photo=xp_read_file( 'c:\\sqlany\\scripts\\adata\\HoodedSweatshirt.jpg' )
WHERE Products.ID=600;

Die folgende Anweisung liest eine Textdatei und zeigt jede Zeile mit Zeilennummer an.

SELECT * FROM sa_split_list( CAST(xp_read_file('\\Windows\\win.ini') AS LONG VARCHAR), 0x0a);

xp_read_file-Systemprozedur

Syntax

Argumente

Rückgabe

Bemerkungen

Privilegien

Beispiel

Siehe auch