このトピックには、以下のセクションが含まれています。
指定された ODBC データ・ソース内のデータベースと対話するには、DataUpdate ノードを使用します。 DataUpdate ノードは Database ノードの特殊な形で、対話は、データベース内の表の 1 つ以上の行を更新することに制限されています。 入力メッセージからのデータを何らかの方法で使用して必要なアクションを識別するマッピングを定義することにより、更新する情報を定義します。
プロパティーを設定することにより、データベースに対する更新をすぐにコミットするか、メッセージ・フローが完了するまで更新のコミットを待つか、またはメッセージ・フローの全体的な完了状況に応じてロールバックするかを制御することができます。
ワークベンチでは、DataUpdate ノードは次のアイコンで表されます。
新製品のキーボードの詳細情報を在庫データベースに追加した状況を考えてください。 入庫部門から、500 個のキーボードの入荷があったことを示すメッセージが届きました。 DataUpdate ノードを使用して、データベース内のキーボードの数量をゼロから 500 に変更することができます。
DataUpdate ノードのインスタンスをメッセージ・フローに入れると、DataUpdate ノードを構成することができます。 エディター・ビューでノードを右マウス・ボタンでクリックし、「プロパティー (Properties)」をクリックします。 ノードの基本プロパティーが表示されます。
値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、プロパティー・ダイアログにアスタリスクが表示されます。
以下のように、DataUpdate ノードを構成します。
z/OS システムの場合、ブローカーは、ブローカーが開始したタスクの ID を使用します。
この入力フィールドの隣の「ブラウズ (Browse)」をクリックすると、このノードからアクセス可能なすべての使用可能なマッピング・ルーチンをリストしたダイアログが表示されます。 必要なルーチンを選択し、「OK」をクリックします。 ルーチン名が「ステートメント (Statement)」に設定されます。
このノードに関連するマッピング・ルーチンを処理するには、ノードを右クリックして「マッピングを開く (Open Mappings)」をクリックします。 マッピング・ルーチンが存在しない場合は、デフォルト名で、デフォルト・ファイルの中に作成されます。 すでに存在する場合には、「ナビゲーター (Navigator)」ビューで <flow_name>_<node_name>.mfmap ファイルを開くこともできます。
マッピング・ルーチンは、関連するノードのタイプに特有のものです。 DataUpdate ノード用に開発したマッピング・ルーチンを、マッピングを使用する他のノード (DataInsert ノードなど) と一緒に使用することはできません。 マッピング・ルーチンを作成した場合、それを他のマッピング・ルーチンから呼び出すことはできません。 ただし、ESQL ルーチンから呼び出すことは可能です。
このボックスを選択した場合、ノードはデータベースからのすべての正の戻りコードをエラーとして扱い、負の戻りコードについてと同じ方法で例外を生成するか、問題がより重大である場合はエラーを生成します。
このボックスを選択しなかった場合、ノードは警告を通常の戻りコードとして扱い、例外を生成しません。 生成される最も重大な警告は「見つかりません (not found)」であり、これはほとんどの状況で正常な戻りコードとして安全に扱うことができます。
このチェック・ボックスのチェックを外す場合には、メッセージ・フロー内のエラーを処理してブローカーとデータベースの整合性を確認する必要があります。ブローカーによるデフォルト・エラー処理を呼び出さないように選択してあるため、自分でエラーを処理しない限り、エラーは無視されます。 たとえば、エラー処理サブルーチンに failure ターミナルを接続できます。
「キャンセル (Cancel)」をクリックすると、ダイアログを閉じてプロパティーの変更をすべて破棄します。
DataUpdate ノードのターミナルについては、次の表に説明されています。
ターミナル | 説明 |
---|---|
In | ノードが処理するメッセージを受け入れる入力ターミナル。 |
Failure | 計算時に障害が検出された場合、入力メッセージが伝搬される出力ターミナル。 「警告をエラーとして扱う (Treat warnings as errors)」を選択した場合、処理が正常に完了してもメッセージはノードからこのターミナルに伝搬されます。 |
Out | データベース・ステートメントの実行後にメッセージを出力する出力ターミナル。 |
以下の表でノードのプロパティーを説明します。M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、プロパティー・ダイアログにアスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 かどうかを示します (メッセージ・フローを bar ファイルに追加してデプロイするとき、値を変更できます)。
DataUpdate ノードの「基本 (Basic)」プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
データ・ソース (Data Source) | いいえ | はい | このノードに関連付けられたマッピング (「ステートメント (Statement)」プロパティーで識別される) で参照するテーブルが存在するデータベースの ODBC データ・ソース名。 | |
ステートメント (Statement) | はい | いいえ | DataUpdate | データベースまたはメッセージ・ツリーに対して実行されるステートメントが含まれるマッピング・ルーチンの名前。 このルーチンは、このタイプのノードに固有のものです。 |
トランザクション (Transaction) | はい | いいえ | 自動 (Automatic) | ノードのトランザクション・モードです。 「自動 (Automatic)」または「コミット (Commit)」を選択できます。 |
警告をエラーとして扱う (Treat warnings as errors) | はい | いいえ | 選択されていない | データベース SQL 警告をエラーとして扱います。 チェック・ボックスを選択すると、このアクションが実行されます。 |
データベース・エラーで例外を発生させる (Throw exception on database error) | はい | いいえ | 選択されている | データベース・エラーによりブローカーが例外を発生させます。 チェック・ボックスを選択すると、このアクションが実行されます。 |
DataUpdate ノードの「説明 (Description)」プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
簡略説明 (Short Description) | いいえ | いいえ | ノードの簡単な説明 | |
詳細説明 (Long Description) | いいえ | いいえ | メッセージ・フロー内のノードの目的を説明するテキスト |
注意 |
商標 |
ダウンロード |
ライブラリー |
技術サポート |
フィードバック
![]() ![]() |
ac04700_ |