cniSqlCreateStatement

Beginn der ÄnderungDiese 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 den SQL-Ausdruck aus, der als Eingabe für die Funktionen verwendet wird, welche die Anweisung ausführen (d. h. cniSqlExecute and 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. Ende der Änderung

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
Legt fest, dass nach Ausführung der Anweisung eine Festschreibung durchgeführt wird und innerhalb der Funktion cniSqlExecute oder cniSqlSelect (d. h. die Nachricht 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 | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as08000_