DataWorks:ノードとワークフローのデバッグ

単一ノードのデバッグ

1. DataStudio ページに移動します。左側メニューで、[データ開発] または [手動トリガーワークフロー] の下にある対象のワークフローを見つけ、編集したいノードをダブルクリックします。

2. ノードを実行してデバッグします。

   ノードのエディタータブで、ツールバーの [実行] または [パラメーターを指定して実行] を使用してコードロジックをデバッグします。また、[クイック実行] を使用してコードスニペットをデバッグすることもできます。各オプションについては、次の表で説明します。

   説明

   ノードの実行時にクエリ対象データへの権限がない場合は、「コンピュートエンジンとデータの権限管理の概要」を参照して、DataWorks のさまざまなコンピュートエンジンに対する権限制御について確認してください。

   実行オプション	説明	ユースケース
   実行 ( アイコン)	このオプションでは、変数に値を割り当て、テスト用のリソースグループを指定できます。これらの設定は、次回以降の実行用に保存されます。 説明 新しく作成したノードを初めて実行すると、設定ダイアログが表示されます。コード内の変数に手動で定数値を割り当てる必要があります。DataWorks は割り当てた値を保存します。次回ノードを実行すると、保存された設定がデフォルトで使用されます。	コードを頻繁にデバッグする必要がある場合に使用します。
   パラメーターを指定して実行 ( アイコン)	ノードを実行するたびに、テストシナリオの変数に定数値を割り当て、リソースグループを指定する必要があります。	コード内の変数値の変更や、タスクで使用するリソースグループの変更が必要な場合に使用します。
   クイック実行 ( アイコン)	このオプションでは、ノードエディターのコード領域でコードスニペットをデバッグできます。	ノード内のコードスニペットのみをデバッグする必要がある場合に使用します。 説明 この機能は、コードスニペットの正しさをデバッグするためにのみ使用されます。完全なコードロジックをデバッグするには、[実行] または [パラメーターを指定して実行] を使用します。

ワークフローのデバッグ

1. DataStudio ページに移動します。左側メニューで、[データ開発] または [手動トリガーワークフロー] の下にある対象のワークフローをダブルクリックして、そのパネルを開きます。

2. ワークフローをデバッグします。

   ワークフローパネルのツールバーにある実行 ( アイコン) ボタンをクリックすると、ワークフロー内のすべてのタスクが依存関係に基づいて順次実行されます。

   また、ワークフローパネルで特定のノードを右クリックし、[ノードと下流ノードを実行] を選択して、そのノードとすべての下流ノードを依存関係に基づいて実行することもできます。

   ツールバーからの実行と右クリックでの実行は、メカニズムが異なります：

   • ツールバーからの実行：ワークフローの完全な DAG に基づいて、すべてのノードを上流から下流へと順次実行します。各ノードは独立してサブミットされ、これは各ノードをエディタータブで個別に実行することと同等です。

   • 右クリックでの [ノードと下流ノードを実行]：選択したノードから開始し、依存関係スケジューリングロジックを使用して、そのノードと下流ノードを実行します。この方法は上流ノードの実行ステータスと出力を検証するため、ノードをエディタータブで直接実行する場合 (スタンドアロンデバッグモード) とは異なります。

   ノードとその下流ノードを右クリックで実行したときにエラーが発生し、同じ SQL がノードエディタータブではエラーなく実行される場合、その原因は、右クリックでの実行では依存関係スケジューリングロジックが組み込まれ、上流ノードの実行ステータスと出力データが検証されるのに対し、直接実行では現在のノードの SQL コードのみが実行されるためです。次のようにトラブルシューティングを行います：

   • 上流ノードの実行ステータスを確認します。右クリックでの実行では、上流の依存関係が検証されます。上流ノードが実行されていないか、失敗している場合、現在のノードはエラーを報告します。ワークフローパネルで上流ノードの実行ステータスアイコンを確認し、すべての上流ノードが正常に実行されていることを確認します。

   • ノード間の依存関係設定を確認します。ノード間の入出力パラメーターの受け渡しが正しく、スケジューリングパラメーターの割り当てが期待どおりであることを確認します。ノードのスケジュール設定ページで、上流の出力テーブルが現在のノードの入力テーブルと一致しているかを確認します。

   • 失敗したノードを右クリックし、[実行ログの表示] を選択して、特定のエラー情報を特定します。ログ内のエラーには、通常、具体的な原因 (テーブルが見つからない、権限が不十分、構文エラーなど) が含まれています。

   • SQL にコメント構文の問題がないか確認します。一部のエンジンでは、スケジューリングモードでのコメントの解析が直接実行モードとは異なり、構文エラーを引き起こすことがあります。トラブルシューティングするには、まず SQL からブロックコメント (/* */) を削除し、行コメント (--) のみを残して、エラーが解決するかどうかを確認します。

   • 上流ノードの出力データが準備できているか確認します。右クリックでの実行は、上流ノードによって生成されたデータテーブルを入力として必要とします。上流ノードが正常に実行されても、その出力データがまだ準備できていないか、クリーンアップされている場合、現在のノードは入力テーブルを読み取れないためエラーを報告します。

   説明

   • 手動トリガーワークフロー内のノードに同じ名前の変数があり、それらの変数に一括で値を割り当てられる場合、ワークフローパネルでワークフローパラメーターを定義し、パラメーターに値を割り当てることができます。その後、ワークフローを実行して、割り当て結果と手動タスクの実行ステータスを表示します。

   • 一部のノードタイプのみがワークフローパラメーターをサポートしています。詳細については、実際の画面をご参照ください。

   • 実行が完了した後、ワークフローパネルで特定のノードを右クリックして、その実行時ログを表示できます。

実行履歴の表示

DataStudio の 実行履歴 ページに移動して、現在のアカウントの過去 3 日間のすべてのタスク実行レコードを表示できます。

タスクが DataStudio で実行されると、対応するエンジンにサブミットされて実行されます。実行中に誤ってタスクを閉じても、タスクは実行を継続します。実行履歴ページに移動して、実行時ログを表示したり、実行のためにサブミットされたタスクを停止したりできます。

アドホッククエリファイルの作成

クエリ結果の処理