cniSqlCreateStatement

Compute メッセージ・フロー処理ノードに定義されている構文を使用して、ステートメント引き数によって指定されるステートメントを表す SQL 式オブジェクトを作成します。 この関数は、SQL 式オブジェクトへのポインターを戻します。 これは、ステートメントの cniSqlExecute および cniSqlSelect を実行する関数への入力として使用されます。 複数の SQL 式オブジェクトを、単一のメッセージ・フロー処理ノードで作成できます。 これらのオブジェクトは随時作成できますが、通常は、インプリメンテーション関数 cniCreateNodeContext 内で、メッセージ・フロー処理ノードがインスタンス化される際に作成されます。

構文

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

パラメーター

returnCode
関数からの戻りコード (出力)。
nodeObject
SQL 式オブジェクトを所有するメッセージ・フロー処理ノード (入力)。 このポインターは、cniCreateNodeContext インプリメンテーション関数に渡されます。
dataSourceName
ステートメントが外部データベースにあるデータを参照する場合に使用される ODBC データ・ソース名 (入力)。
transaction
ステートメントの実行後にデータベース・コミットを実行するかどうかを指定します (入力)。 有効な値は以下のとおりです。
CCI_SQL_TRANSACTION_AUTO
メッセージ・フローの完了時に、データベース・コミットが実行されることを指定します (つまり、完全にグローバルな整合トランザクションまたは部分的にグローバルな整合トランザクションとして)。 これはデフォルトです。
CCI_SQL_TRANSACTION_COMMIT
ステートメントの実行後、cniSqlExecute または cniSqlSelect 関数内でコミットを実行することを指定します (つまり、メッセージ・フローは部分的にブローカー整合)。
statement
計算メッセージ・フロー処理ノード用に定義した構文を使用して、作成する SQL 式 (入力)。

戻り値

成功した場合、SQL 式オブジェクトのアドレスが戻されます。 エラーが発生した場合、ゼロ (CCI_NULL_ADDR) が戻され、returnCode パラメーターがエラーの理由を示します。

関連概念
ユーザー定義のメッセージ処理ノード
ユーザー定義の出力ノード

関連タスク
C でのメッセージ処理ノードの作成

関連資料
C 言語ノード・ユーティリティー関数
cniCreateNodeContext
cniSqlDeleteStatement
cniSqlExecute
cniSqlSelect