cniSqlCreateStatement

Diese Funktion erstellt ein SQL-Ausdrucksobjekt, das die Anweisung darstellt, die durch das Anweisungsargument angegeben wird, mit der für den Rechen-Nachrichtenflussverarbeitungsknoten definierten Syntax. Diese Funktion gibt einen Zeiger auf das SQL-Ausdrucksobjekt zurück, das als Eingabe für die Funktionen verwendet wird, die die Anweisung ausführen, d. h. cniSqlExecute und cniSqlSelect. Sie können mehrere SQL-Ausdrucksobjekte in einem Nachrichtenflussverarbeitungsknoten erstellen. Sie können diese Objekte zwar jederzeit erstellen, normalerweise werden sie jedoch erstellt, wenn in der Implementierungsfunktion cniCreateNodeContext ein Exemplar des Nachrichtenflussverarbeitungsknotens erstellt wird.

Syntax

CciSqlExpression* cniSqlCreateStatement(
int*               returnCode,
CciNode*           nodeObject,
CciChar*           dataSourceName,
CciSqlTransaction  transaction,
CciChar*           statement);

Parameter

returnCode
Der Rückkehrcode aus der Funktion (Ausgabe). Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_NODE_OBJECT
  • CCI_INV_TRANSACTION_TYPE
  • CCI_INV_STATEMENT
nodeObject
Der Nachrichtenflussverarbeitungsknoten, zu dem das SQL-Ausdrucksobjekt gehört (Eingabe). Dieser Zeiger wird an die Implementierungsfunktion cniCreateNodeContext übermittelt.
dataSourceName
Der ODBC-Datenquellenname, der verwendet wird, wenn die Anweisung auf Daten in einer externen Datenbank verweist (Eingabe).
transaction
Gibt an, ob eine COMMIT-Datenbankoperation nach der Ausführung der Anweisung ausgeführt wird (Eingabe). Folgende Werte sind gültig:
CCI_SQL_TRANSACTION_AUTO
Gibt an, dass zum Abschluss des Nachrichtenflusses eine COMMIT-Datenbankoperation ausgeführt wird (d. h. als vollständig oder teilweise global koordinierte Transaktion). Dies ist die Standardeinstellung.
CCI_SQL_TRANSACTION_COMMIT
Gibt an, dass nach der Ausführung der Anweisung und in der Funktion cniSqlExecute oder cniSqlSelect eine COMMIT-Operation ausgeführt wird (d. h., der Nachrichtenfluss wird teilweise vom Broker koordiniert.
statement
Der SQL-Ausdruck, der mit der für den Rechen-Nachrichtenflussverarbeitungsknoten definierten Syntax erstellt werden soll (Eingabe).

Rückgabewerte

Bei erfolgreicher Ausführung wird die Adresse des SQL-Ausdrucksobjekts zurückgegeben. Wenn ein Fehler auftritt, wird der Wert null (CCI_NULL_ADDR) zurückgegeben, und der Parameter returnCode gibt die Fehlerursache an.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
as08000_