cniSqlCreateStatement

Início da mudançaCria um objeto de expressão SQL representando a instrução especificada pelo argumento statement, utilizando a sintaxe conforme definido para o nó de processamento do fluxo de mensagens Compute, com a exceção de que você não tem permissão para utilizá-la:
  • CREATE PROCEDURE
  • CREATE MODULE
  • CREATE SCHEMA
  • CREATE FUNCTION
Essa função retorna um ponteiro para o objeto de expressão SQL, o qual é utilizado como entrada para as funções que executam a instrução, especificamente cniSqlExecute e cniSqlSelect. É possível criar vários objetos de expressão SQL em um único nó de processamento de fluxo de mensagens. Embora seja possível criar esses objetos a qualquer momento, em geral eles devem ser criados quando é criada a instância do nó de processamento de fluxo de mensagens, dentro da função de implementação cniCreateNodeContext.Fim da mudança

Sintaxe

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

Parâmetros

returnCode
O código de retorno da função (saída).
Os possíveis códigos de retorno são:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_NODE_OBJECT
  • CCI_INV_TRANSACTION_TYPE
  • CCI_INV_STATEMENT
nodeObject
O nó de processamento de fluxo de mensagens ao qual o objeto de expressão SQL pertence (entrada). Esse ponteiro é transmitido à função de implementação cniCreateNodeContext.
dataSourceName
O nome da origem de dados ODBC utilizado se a instrução referenciar dados em um banco de dados externo (entrada).
transaction
Especifica se um commit do banco de dados é realizado depois que a instrução é executada (entrada). Os valores válidos são:
CCI_SQL_TRANSACTION_AUTO
Especifica que um commit do banco de dados é realizado na conclusão do fluxo de mensagens (ou seja, como uma transação coordenada globalmente completamente ou coordenada globalmente parcialmente). Este é o padrão.
CCI_SQL_TRANSACTION_COMMIT
Especifica que um commit é realizado após a execução da instrução e dentro da função cniSqlExecute ou cniSqlSelect (ou seja, o fluxo de mensagens é parcialmente coordenado pelo intermediário).
statement
A expressão SQL a ser criada, utilizando a sintaxe conforme definida para o nó de processamento de fluxo de mensagens de computação (entrada).

Valores de Retorno

Se bem-sucedida, o endereço do objeto de expressão SQL é retornado. Se um erro ocorrer, zero (CCI_NULL_ADDR) é retornado e o parâmetro returnCode indica a razão do erro.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as08000_