xp_write_file( 
filename
, file_contents
)

Diese Funktion gibt einen INTEGER-Statuscode zurück.

Diese Funktion schreibt den file_contents in die Datei filename. Sie gibt "0" zurück, falls erfolgreich, und nicht Null bei Fehlschlag.

Dem filename-Wert kann ein absoluter oder ein relativer Pfad vorangestellt werden. Wenn filename ein relativer Pfad vorangestellt wird, ist der Dateiname relativ zum aktuellen Arbeitsverzeichnis des Datenbankservers. Falls die Datei bereits besteht, wird ihr Inhalt überschrieben.

Diese Funktion kann zum Entladen umfangreicher Binärdaten in Dateien hilfreich sein.

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

Sie müssen das WRITE FILE-Systemprivileg haben.

• CSCONVERT-Funktion [Zeichenfolge]
• xp_read_file-Systemprozedur
• Einfügen von Dokumenten und Grafiken
• Systemprozeduren für Verzeichnisse und Dateien

Dieses Beispiel verwendet xp_write_file, um eine Datei accountnum.txt zu erstellen, die die Daten 123456 enthält:

CALL xp_write_file( 'accountnum.txt', '123456' );

Dieses Beispiel fragt die Contacts-Tabelle der Beispieldatenbank ab und erstellt dann eine Textdatei für jeden Kontakt, der in New Jersey wohnt. Die Textdateien werden benannt, wobei eine Verkettung des Vornamens (GivenName), des Nachnamens (Surname) und der Zeichenfolge .txt verwendet wird (z.B. Reeves_Scott.txt), und enthalten auf separaten Zeilen die Straßenadresse (Street), Stadt (City) und den Bundesstaat (State).

SELECT xp_write_file( 
Surname || '_' ||  GivenName || '.txt', 
Street || '\n' || City || '\n' || State ) 
FROM Contacts WHERE State = 'NJ';

Dieses Beispiel verwendet xp_write_file, um eine Bilddatei (JPG) für jedes Produkt in der Products-Tabelle zu erstellen. Jeder Wert in der ID-Spalte wird zu einem Dateinamen für eine Datei, die den entsprechenden Wert der Photo-Spalte enthält:

SELECT xp_write_file( ID || '.jpg', Photo ) FROM Products;

Im obenstehenden Beispiel ist ID eine Zeile mit einer UNIQUE-Integritätsregel. Das ist wichtig, damit eine Datei nicht mit dem Inhalt von nachfolgenden Zeilen überschrieben wird. Auch müssen Sie die Dateierweiterung angeben, die den in der Spalte gespeicherten Daten entspricht. In diesem Fall werden in Products.Photo Bilddaten (JPEG-Dateien) gespeichert.