Anfang des Inhaltsbereichs

Hintergrunddokumentation Methode sql Dokument im Navigationsbaum lokalisieren

Verwendung

$sqlrc = $session->sql ($cmd_string);

sql ist eine Methode der Klasse Loader. Sie senden damit die unter $cmd_string angegebene SQL-Anweisung an den StrukturlinkLoader-Server.

Sie können SQL-Anweisungen auch mit Hilfe der Methoden cmd oder rawCmd ausführen. Wenn dabei Ausnahmen auftreten, müssen Sie diese jedoch selbst erkennen und den Fehlercode aus dem Text der Ausnahme ermitteln.

Ergebnis

Wenn die Anweisung erfolgreich ausgeführt wurde, ist der Ergebniswert 0

Wenn die Ausführung der Anweisung zu einem SQL-Fehler führt, dann wird die Nummer der Fehlermeldung der SQL-Anweisung zurückgegeben.

Wenn die Ausführung der Anweisung zu einem Loader-Fehler führt, dann wird eine Ausnahme des Typs LoaderError ausgelöst.

Beispiel

Ausführen einer gültigen SQL-Anweisung

print $session->cmd ('CREATE TABLE testtable3 (a integer)');

Ausgabe:

0

 

Ausführen einer ungültigen SQL-Anweisung

print $session->cmd ('invalid command');

Ausgabe ist der Fehlercode der SQL-Anweisung:

3005

 

Ausführen eines ungültigen Loader-Kommandos

print $session->cmd ('dataload invalid spec')

Ausgabe ist die Ausnahme des Loader-Server:

Error Loader Server: Syntax error at position 10 (Unexpected token: invalid). at /opt/sdb/programs/misc/SAP/DBTech/loader.pm line 89.

Ende des Inhaltsbereichs