deutschen Handbuch - QT software GmbH

mehrfache, vorbereitete Ausführung (prepared execution).
Direkte Ausführung erfolgt mittels SQLExecDirect, wenn der Befehl
nur einmal ausgeführt werden soll (bspw. SELECT) und keine
Information über den Ergebnisinhalt (result set) vor Ausführung bekannt
ist.
Die vorbereitete Ausführung mittels SQLPrepare und folgendem
SQLExecute wird im gegenteiligen Fall verwendet, also wenn ein
Befehl mehrfach ausgeführt werden soll (bspw. INSERT, UPDATE) oder
wenn Information über den Ergebnisinhalt (result set) vor Ausführung
bekannt ist.
Ein vorbereiteter Befehl wird im allgemeinen schneller ausgeführt als ein
direkter, da für jeden SQL Befehl intern ein „Zugriffsplan“ erstellt wird, der
bei wiederholter Ausführung im vorbereiteten Fall nur einmal zu generieren
ist, hingegen beim direkten Fall bei jedem Befehl. Allerdings ist Vorsicht
beim Verhalten von SQLTransact (d.h. beim COMMIT bzw.
ROLLBACK) oder bei Verwendung von SQL_AUTOCOMMIT (bzw.
SQL_ATTR_AUTOCOMMIT) geboten, da dabei der Zugriffsplan intern
gelöscht werden kann. Näheres hierzu: siehe die Informationstypen via
SQLGetInfo von SQL_CURSOR_COMMIT_BEHAVIOR und
SQL_CURSOR_ROLLBACK_BEHAVIOR.
Vor Ausführung eines SQL Befehls müssen intern Speicherbereiche
angelegt werden, die über die Befehlsidentifkationsnummer (statement
handle) identifiziert werden. Die Befehlsidentifkationsnummer ist vom
Typ SQLHANDLE und kann bspw. wie folgt deklariert werden.
INTEGER (SQLHANDLE) :: stmt = SQL_NULL_HANDLE
Sie wird dann durch den Aufruf von SQLAllocHandle erzeugt und
benötigt die zuvor generierte Verbindungsidentifikationsnummer (im
Beispiel: dbc).
rtc = SQLAllocHandle( SQL_HANDLE_STMT, dbc, stmt )
Vor Ausführung eines SQL Befehls können Werte und Befehlsparameter
gesetzt werden (siehe dazu Abschnitt „Das Setzen von Parametern“).
Schließlich folgt im direkten Fall die Ausführung des Befehls mittels
SQLExecDirect. Z.B.:
rtc = SQLExecDirect( stmt, &
"DELETE FROM Waehrungen WHERE Kuerzel = 'DM'" &
//CHAR(0), SQL_NTSL )
Erläuterung: Die zuvor erzeugte Befehlsidentifkationsnummer (stmt)
identifiziert den intern angelegten Speicherbereich, in dem der
nachfolgende SQL Befehl „DELETE FROM...“ als null-terminierte
Zeichenkette („//CHAR(0)“) abgelegt wird. Die Länge des Befehls wird
intern ermittelt, da als Längenparameter SQL_NTSL (null terminated
string) verwandt wird. Hier ist die "lange" Variange von SQL_NTS
notwendig, da das INTERFACE der Funktion dies fordert.
Im vorbereiteten Fall wird der SQL Befehl SQLPrepare analog
verwandt. D.h., die Funktion verwendet die gleichen Parameter wie
SQLExecDirect. Anschließend können Werte und Befehlsparameter
gesetzt werden (siehe dazu Abschnitt „Das Setzen von Parametern“).
Daraufhin besteht die Möglichkeit Information über das Ergebnis (result
set) vorab zu erhalten. Der Aufruf von SQLExecute schließlich führt
den vorbereiteten Befehl aus. Z.B.:
rtc = SQLExecute( stmt )
http://www.qtsoftware.de ForDBC - Fortran Database Connectivity 24