SQL-Anweisungen

• stat := PrepareStatement(conn, sqlString) bereitet die als Zeichenkette angegebene SQL-Anweisung sqlString zur Ausführung über der Verbindung conn vor. Der Rückgabewert ist ein Zeiger auf eine Anweisungsstruktur. Die vorbereitete SQL-Anweisung kann anschließend mit Execute ausgeführt werden. Das Datenfeld results der Anweisungsstruktur stat enthält nach dem Aufruf von PrepareStatement Deskriptoren für die Tupel der Ergebnismenge. Wenn die SQL-Anweisung keine Ausgabe liefert, ist results NIL.

• BindParameters (stat, types, numParams) bindet numParams Parameter mit in types beschriebenen Eigenschaften an die Anweisung stat. Parameterplatzerhalter innerhalb von SQL-Anweisungen werden durch ein Fragezeichen dargestellt (z.B. "`INSERT INTO TABLE cities (name, population) VALUES (?, ?)"'). Die einzelnen Felder von types legen die Eigenschaften der Parameter fest. Die folgende Tabelle soll diese Felder erklären. In den meisten Fällen werden type und mapType gleich sein, außer wenn man automatische Datenkonversion veranlassen möchte oder die Datenbank den Oberondatentyp nicht kennt. Nach dem Aufruf von BindParameters enthält das Datenfeld params der Anweisungsstruktur numParams Felder der entsprechenden Typen, die man über ihren Namen wieder ansprechen kann ( FindField(stat.params, name)).

   
  Table: Felder von ParamDesc
  

• Execute(stat) führt die vorbereitete Anweisung stat aus.

• RowCount(stat, rows) liefert in rows die Anzahl der von der SQL-Anweisung (muß entweder eine UPDATE- oder eine DELETE-Anweisung sein) betroffenen Zeilen. Wenn man die Anzahl der von einer SELECT-Anweisung gelieferten Zeilen wissen möchte, muß man eine Anweisung der Art "`SELECT COUNT(*) ..."' ausführen (was allerdings ineffizient ist und lange dauern kann, da dazu die gesamte Ergebnismenge der Anweisung berechnet wird und erst anschließend die Anzahl der Zeilen in der Ergebnismenge berechnet und zurückgegeben wird) oder beim Auslesen der Daten einen Zähler mitführen.

• Fetch(stat) überträgt die erste oder nächste Ergebniszeile der bereits ausgeführten SQL-Anweisung stat nach results. Innerhalb der Ergebniszeile results kann man mit den Zugriffsprozeduren FirstField, NextField, PrevField und FindField auf die einzelnen Felder zugreifen.

• ErrS(str, stat) ruft ShowError mit entsprechenden Parameterwerten auf.

• GetStatementOption (stat, option, info) liefert den aktuellen Wert der die SQL-Anweisung stat betreffenden Option option in info, SetStatementOption (stat, option, info) setzt die Option option auf einen neuen Wert. Gültige Werte für option sind im Anhang zu finden. Abhängig von der Art der Option muß man ein StringField (wenn die Information als Zeichenkette zurückgeliefert wird) oder ein IntField (wenn die Information als Ganzzahl oder Bitmaske zurückgeliefert wird) zum Auslesen der Werte übergeben.

• stat := Tables(conn) bereitet eine Anweisung vor, über die man alle über die Verbindung conn verfügbaren Tabellen abfragen kann. Die Anweisung stat muß noch (wie eine gewöhnliche Anweisung) ausgeführt werden.

• stat := NewStatement(conn) liefert einen Zeiger auf eine initialisierte Anweisungsstruktur zurück.

• GenerateResultRow(stat) erzeugt die Deskriptoren für die Zeilen der Ergebnismenge. Die SQL-Anweisung stat muß bereits vorbereitet sein.

Die Abbildung zeigt das Objektmodell von Anweisungen und Verbindungen. Man sieht die mit einer SQL-Anweisung assoziierte Verbindung, die Parameterzeile und die Ergebniszeile, die beide beliebig viele Felder zur Parameterkommunikation enthalten können.

 
Figure:   Objektmodell Statement