READ-Anweisung [Interactive SQL]

READ [ ENCODING Kodierung ] Dateiname [ Parameter ] ...

Kodierung : Bezeichner oder Zeichenfolge

ENCODING Mit der ENCODING-Klausel können Sie die Kodierung angeben, mit der die Datei gelesen werden soll. Die READ-Anweisung verarbeitet beim Lesen einer Datei keine Escapezeichen. Es wird vorausgesetzt, dass die gesamte Datei in der angegebenen Kodierung vorliegt.
Wenn Sie Interactive SQL ausführen, wird die beim Lesen der Daten verwendete Kodierung in der folgenden Reihenfolge ermittelt:
- Die durch die ENCODING-Klausel angegebene Kodierung (sofern diese Klausel angegeben ist).
- Die durch die Option default_isql_encoding angegebene Kodierung (sofern diese Option festgelegt wurde). Siehe default_isql_encoding-Option [Interactive SQL].
- Die Standardkodierung für die Plattform, die Sie verwenden. Auf Computern mit englischem Windows ist die Standardkodierung 1252.

Die READ-Anweisung liest eine Sequenz der Interactive SQL-Anweisungen aus der benannten Datei. Diese Datei kann jede gültige Interactive SQL-Anweisung einschließlich weiterer READ-Anweisungen enthalten. READ-Anweisungen können beliebig tief ineinander verschachtelt werden.

Wenn der Dateiname keine Erweiterung hat, sucht Interactive SQL nach demselben Dateinamen mit der Erweiterung .sql.

Wenn Dateiname keinen absoluten Pfad enthält, sucht Interactive SQL nach der Datei. Der Speicherort von Dateiname wird basierend auf dem Standort der READ-Anweisung wie folgt ermittelt:

Wenn die READ-Anweisung direkt in Interactive SQL ausgeführt wird, versucht Interactive SQL zunächst, den Pfad von Dateiname relativ zu dem Verzeichnis aufzulösen, in dem Interactive SQL ausgeführt wird. Wenn dies nicht gelingt, sucht Interactive SQL in den durch die Umgebungsvariable SQLPATH angegebenen Verzeichnissen nach Dateiname und anschließend in den durch die Umgebungsvariable PATH angegebenen Verzeichnissen.
Wenn die READ-Anweisungen in einer externen Datei enthalten sind (zum Beispiel in einer .sql-Datei), versucht Interactive SQL zuerst, den Pfad zu Dateiname relativ zum Speicherort der externen Datei aufzulösen. Wenn dies nicht gelingt, sucht Interactive SQL nach Dateiname in einem Pfad, der relativ zu dem Verzeichnis liegt, in dem Interactive SQL läuft. Wenn dies weiterhin nicht gelingt, sucht Interactive SQL in den durch die Umgebungsvariable SQLPATH angegebenen Verzeichnissen und anschließend in den durch die Umgebungsvariable PATH angegebenen Verzeichnissen.

Parameter können nach dem Namen der Befehlsdatei aufgeführt werden. Diese Parameter entsprechen den Parametern, die in der PARAMETERS-Anweisung zu Beginn der Anweisungsdatei benannt werden. Siehe PARAMETERS-Anweisung [Interactive SQL].

Parameternamen müssen in eckige Klammern gesetzt werden. Interactive SQL ersetzt dann den entsprechenden Parameter überall dort, wo die Quelldatei { Parametername } enthält, wobei Parametername der Name des entsprechenden Parameters ist.

Die Parameter, die an eine Befehlsdatei übergeben werden, können Bezeichner, Zahlen, angeführte Bezeichner oder Zeichenfolgen sein. Wenn ein Parameter in Anführungszeichen gesetzt ist, werden die Anführungszeichen während der Ersetzung in den Text eingegeben. Parameter, die keine Bezeichner, Zahlen oder Zeichenfolgen (mit Leerstellen oder Tabstops) sind, müssen in eckige Klammern ([ ]) gesetzt werden. Dadurch ist willkürliche Textersetzung in der Befehlsdatei möglich.

Wenn nicht genug Parameter in die Befehlsdatei übernommen werden, fordert Interactive SQL die Werte für die fehlenden Parameter an.

Wenn Sie eine reload.sql-Datei mit Interactive SQL ausführen, müssen Sie den Chiffrierschlüssel als Parameter angeben. Wenn Sie den Schlüssel nicht in der READ-Anweisung übergeben, werden Sie von Interactive SQL aufgefordert, den Schlüssel bereitzustellen. Siehe Interactive SQL-Dienstprogramm (dbisql).

Keine.

SQL/2008 Erweiterung des Herstellers.

Im Folgenden werden Beispiele für die Verwendung der READ-Anweisung gegeben.

READ status.rpt '160';
READ birthday.sql [>= '1988-1-1'] [<= '1988-1-30'];

Zum Verarbeiten einer Datei, die eine bestimmte OEM-Codepage verwendet, müssen Sie die Codepage angeben. Zum Beispiel:

dbisql READ ENCODING 'cp437' myfile.sql

READ-Anweisung [Interactive SQL]

Syntax

Parameter

Bemerkungen

Berechtigungen

Nebenwirkungen

Siehe auch

Standards und Kompatibilität

Beispiel