deutschen Handbuch - QT software GmbH

die Parameterwerte noch nicht bekannt sind, wenn der Befehl
vorbereitet wird,
oder wenn
die Typen von Parameterwerten in andere umgewandelt werden
müssen.
Bevor ein Parameterwert gesetzt werden kann, muß ihm eine Variable,
bzw. genauer ein Speicherplatz für den Platzhalter mithilfe der Funktion
SQLBindParameter zugeordnet werden ("Parameter Binding").
SQLBindParameter gibt zudem den Datentyp des Speicherplatzes,
ggf. die Genauigkeit, Länge und Dezimalbereich an und assoziiert die
Spalte mit dem Parameter. Danach kann durch Zuweisung des
gewünschten Wertes an diesen Speicherplatz (d.h. der Variablen) der
Parameter gesetzt werden. Z.B.:
CHARACTER szName*30
INTEGER (SQLULEN) :: LENszName = 30
INTEGER (SQLLEN) :: cbName
...
rtc = SQLPrepare( stmt, &
"INSERT INTO adressbuch (name, vorname,
telefon) VALUES (?, ?, ?)"//CHAR(0), &
SQL_NTS )
rtc = SQLBindParameter( stmt, 1, SQL_PARAM_INPUT, &
SQL_C_CHAR, SQL_CHAR, &
LENszName, 0, szName, 0, &
cbName )
...
szName = 'Mustermann'; cbName = SQLNTSL;
rtc = SQLExecute( stmt )
! INSERT des Datensatz ("'Mustermann',...")
Erläuterung: An die erste Spalte (zweites Argument = 1) vom Typ
(SQL_CHAR) der Tabelle "adressbuch" wird der Speicherplatz der
Eingabevariablen szName (SQL_PARAM_INPUT) vom Typ
SQL_C_CHAR mit Länge LENszName gebunden. In der Variablen
cbName wird die Länge des Werts vorgegeben. Die Angabe der Puffergröße
(vorletztes Argument) für den Textpuffer (szName) ist hier nicht
notwendig (und ist zu 0 gesetzt).
Der Datentyp des Speicherplatzes (i.e.v. der Variable) muß nicht mit dem
Typ der Spalte in der Tabelle der Datenquelle übereinstimmen. Man kann
bspw. die Konvertierungsfunktionen des Treibers nutzen, um bspw. einen
als Ganzzahl (SQL_INTEGER) in der Tabelle abgelegten Wert in einen
Zeichentyp (SQL_C_CHAR) umgewandelt an die Applikation
zurückzugeben (sofern der Treiber diese Konvertierung unterstützt).
Die Zuordnungen der Speicherplätze (d.h. C/Fortran Variablen zu
ODBC/SQL Input Parameter) bleiben solange erhalten, bis die Funktion
SQLFreeHandle(SQL_HANDLE_STMT, ... ) aufgerufen
wird. Während der Laufzeit kann an den Platzhalter ein anderer
Speicherplatz gebunden werden, indem die Funktion
SQLBindParameter ein weiteres Mal aufgerufen wird. Auch der
Wert des Speicherplatzes kann während der Laufzeit beliebig geändert
werden. Genutzt wird vom Treiber bei Ausführung eines Befehls der jeweils
aktuelle Wert.
5.5.5 Transaktionen
ODBC bzw. SQL kennt zwei COMMIT Modi:
http://www.qtsoftware.de ForDBC - Fortran Database Connectivity 26