SQL 代入ノードは、データベースに対して SELECT ステートメントを実行し、クエリ結果を出力変数に割り当てます。その後、タスクフロー内の後続ノードでこれらの変数を入力として参照できます。ノードの種類に応じて、出力変数の利用方法は異なります。
シングルインスタンス SQL ノードでは、変数をテーブル名やフィルター条件として使用できます。
スクリプトノードでは、変数をスクリプト内のパラメーターとして使用できます。
Lindorm ファイルチェックノードでは、変数をファイル名として使用できます。
SQL 代入ノードを使用しない場合、各後続ノードで値をハードコードするか、ノード間でデータを手動で渡す必要があります。一方、SQL 代入ノードを導入すれば、単一のクエリ結果が自動的に必要なすべてのノードへと流れます。
前提条件
開始する前に、以下の条件を満たしていることを確認してください。
DMS コンソール V5.0 へのアクセス
既存のタスクフローがあること。新規作成については、「概要」をご参照ください。
クエリ対象のデータベースに対する読み取り権限があること。権限の申請については、「概要」をご参照ください。
制限事項
SQL エディターでは、SELECT ステートメントのみがサポートされます。
「すべての行」と「すべての列」を同時に設定することはできません。
出力変数の値は常に文字列です。
タスクフローへの SQL 代入ノードの追加
DMS コンソール V5.0 にログインします。
上部ナビゲーションバーから、DTS ＞ データ開発 ＞ タスクオーケストレーション の順に選択します。
DMS をシンプルモードで使用している場合は、左上隅の
アイコンをクリックし、「すべての機能」＞「DTS」＞「データ開発」＞「タスクオーケストレーション」を選択します。編集対象のタスクフローの名前をクリックします。
左側の タスクタイプ パネルから、シングルインスタンス用 SQL 代入 ノードをキャンバス上にドラッグします。
ノードをダブルクリックして、構成タブを開きます。
構成タブの検索ボックスにキーワードを入力し、対象のデータベースを検索した後、ドロップダウンリストから選択します。
右側ナビゲーションウィンドウの メタデータ タブをクリックすると、選択したデータベース内のテーブルスキーマを表示できます。
右側ナビゲーションウィンドウの 変数設定 タブをクリックし、変数および定数を構成します。
ヒント: [変数設定] パネルの右上隅にある
このパネルには、以下の 5 つのタブがあります。
タブ 説明 ノード変数 ノードスコープの変数（時間変数を含む）。詳細については、「時間変数の設定」をご参照ください。 タスクフロー定数 タスクフロー内のすべてのノードで共有される固定値。参照形式は ${name}です。タスクフロー変数 タスクフロースコープの変数（時間変数を含む）。詳細については、「時間変数の設定」をご参照ください。 入力変数 上流ノードから渡された変数（読み取り専用）。 出力変数 このノードが後続ノード向けに出力する変数。追加するには、変数を追加 をクリックします。 出力変数 タブで、変数を追加 をクリックし、各出力変数を構成します。
パラメーター 説明 変数 変数の名前と説明。 行 含める行：「すべての行」または「特定の行」。 列 含める列：「すべての列」または「特定の列」。 リンク 値を文字列として連結する際に使用する演算子。「行」が「すべての行」に設定されている場合、または「列」が「すべての列」に設定されている場合に表示されます。 SQL エディターで、選択したデータベースの構文に従って SELECT ステートメントを作成します。ツールバーのボタンを使用してステートメントを操作できます。
プレビュー — 実行前の SQL をプレビューします。
チェック — SQL 構文を検証します。
保存 — SQL ステートメントを保存します。
試行実行 をクリックして、ノードをテストします。
実行ログの最終行に
status SUCCEEDEDと表示された場合、テスト実行は成功しています。status FAILEDと表示された場合、ログを確認して失敗したノードとその原因を特定し、構成を修正して再実行してください。
次のステップ
実際のタスクフローにおける SQL 代入ノードの完全な使用例については、「EC タグ付けのためのタスクオーケストレーション機能の利用」をご参照ください。
後続ノード（たとえばシングルインスタンス SQL ノード）がテーブル名やフィルター条件などとして出力変数を利用する方法については、「変数」をご参照ください。