cniSqlCreateStatement

Diese Funktion erstellt ein SQL-Ausdrucksobjekt, das die Anweisung darstellt, die unter Verwendung der für den Rechen-Nachrichtenflussverarbeitungsknoten definierten Syntax durch das Anweisungsargument angegeben wird, wobei Folgendes nicht zulässig ist:
  • CREATE PROCEDURE
  • CREATE MODULE
  • CREATE SCHEMA
  • CREATE FUNCTION
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. Es können mehrere SQL-Ausdruckobjekte in einem einzelnen Nachrichtenflussverarbeitungsknoten verwendet werden. Obwohl diese Objekte jederzeit erstellt werden können, wäre dies normalerweise angebracht, wenn der Nachrichtenflussverarbeitungsknoten in der Implementierungsfunktion cniCreateNodeContext instanziert 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, der Eigner des SQL-Ausdruckobjekts ist (Eingabe). Dieser Zeiger wird an die Implentierungsfunktion cniCreateNodeContext weitergegeben.
dataSourceName
Der ODBC-Datenquellenname, der verwendet wird, wenn die Anweisung Daten in einer externen Datenbank referenziert (Eingabe).
transaction
Gibt an, ob eine Datenbankfestschreibung nach Ausführung der Anweisung durchgeführt wird (Eingabe). Gültige Werte sind:
CCI_SQL_TRANSACTION_AUTO
Legt fest, dass eine Datenbankfestschreibung beim Abschluss des Nachrichtenflusses durchgeführt wird (d. h. als komplett 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 zu erstellende SQL-Ausdruck unter Verwendung der Syntax, wie sie für den Rechenknoten der Nachrichtenflussverarbeitung definiert wurde (Eingabe).

Rückgabewerte

Bei Erfolg wird die Adresse des SQL-Ausdruckobjekts zurückgegeben. Beim Auftreten eines Fehlers wird Null (CCI_NULL_ADDR) ausgegeben, und der Parameter returnCode gibt den Grund für den Fehler an.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:29:58

as08000_