cniSqlCreateStatement

Verwenden Sie diese Funktion, um mit der für den Rechenknoten definierten Syntax ein ESQL-Ausdrucksobjekt zu erstellen, das die durch das Anweisungsargument angegebene Anweisung darstellt.

Die folgenden Anweisungen können Sie nicht verwenden:
  • 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. Sie können mehrere SQL-Ausdruckobjekte in einem einzelnen Nachrichtenflussknoten erstellen. Obwohl Sie diese Objekte jederzeit erstellen können, wäre dies normalerweise angebracht, wenn der Nachrichtenflussknoten in der Implementierungsfunktion cniCreateNodeContext instanziiert 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 Implementierungsfunktion 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 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 | Support | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2013-02-27 15:22:27


ReferenzthemaReferenzthema | Version 8.0.0.2 | as08000_