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 verwenden und sein Wert nicht Null 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 Null oder non-lazy.

Die Funktion liest den Inhalt der angegebenen Datei und gibt das Ergebnis als einen LONG BINARY-Wert zurück.

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 Funktion CSCONVERT verwenden, um sie zu konvertieren.

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

DBA-Berechtigung

Die folgende Anweisung fügt ein Bild in eine Spalte namens "picture" der Tabelle t1 ein (wobei angenommen wird, dass alle anderen Spalten NULL sein können):

INSERT INTO t1 ( picture )
   SELECT xp_read_file( 'portrait.gif' );

xp_read_file-Systemprozedur

Syntax

Argumente

Bemerkungen

Berechtigungen

Siehe auch

Beispiel