cniSqlCreateStatement

Inizio modificaCrea un oggetto espressione SQL che rappresenta l'istruzione specificata dal relativo argomento, utilizzando la sintassi come definito per il nodo di elaborazione del flusso di messaggi Compute, con l'eccezione di divieto all'uso di:
  • CREATE PROCEDURE
  • CREATE MODULE
  • CREATE SCHEMA
  • CREATE FUNCTION
Questa funzione restituisce un puntatore all'oggetto espressione SQL, che viene utilizzato come input delle funzioni che eseguono l'istruzione, ovvero cniSqlExecute e cniSqlSelect. E' possibile creare più oggetti espressione SQL in un unico nodo di elaborazione del flusso di messaggi. Sebbene sia possibile creare tali oggetti in qualsiasi momento, solitamente questi vengono creati quando viene creata l'istanza del nodo di elaborazione del flusso di messaggi, all'interno della funzione di implementazione cniCreateNodeContext.Fine modifica

Sintassi

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

Parametri

returnCode
Il codice di ritorno dalla funzione (output).
I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_NODE_OBJECT
  • CCI_INV_TRANSACTION_TYPE
  • CCI_INV_STATEMENT
nodeObject
Il nodo di elaborazione del flusso di messaggi a cui appartiene l'oggetto espressione SQL (input). Tale puntatore viene trasferito alla funzione di implementazione cniCreateNodeContext.
dataSourceName
Il nome di origine dei dati ODBC utilizzato se l'istruzione fa riferimento a dati contenuti in un database esterno (input).
transaction
Specifica se viene eseguito il commit di un database dopo l'esecuzione dell'istruzione (input). Valori validi sono:
CCI_SQL_TRANSACTION_AUTO
Specifica che viene eseguito il commit di un database al completamento del flusso di messaggi (ovvero, come una transazione coordinata globalmente in modo completo o parziale). Questo è il valore predefinito.
CCI_SQL_TRANSACTION_COMMIT
Specifica che viene eseguito un commit dopo l'esecuzione dell'istruzione e all'interno della funzione cniSqlExecute o cniSqlSelect (ovvero, il flusso di messaggi è coordinato dal broker in modo parziale).
statement
L'espressione SQL da creare, utilizzando la sintassi come definito per il nodo di elaborazione del flusso di messaggi Compute (input).

Valori di restituzione

Se ha esito positivo, viene restituito l'indirizzo dell'oggetto espressione SQL. Se si verifica un errore, viene restituito un valore zero (CCI_NULL_ADDR) e il parametro returnCode indica il motivo dell'errore.

Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as08000_