ノードのコードを開発した後、実行、パラメーター付き実行、クイック実行などのさまざまなデバッグ方法を使用して、完全なコードまたはコードスニペットをデバッグできます。 また、デバッグ結果を表示することもできます。 このトピックでは、デバッグ手順の概要について説明します。
前提条件
ノード開発が完了していること。 詳細については、「DataStudio」をご参照ください。
背景情報
ノードまたはワークフローをデバッグできます。 詳細については、「ノードのデバッグ」または「ワークフローのデバッグ」をご参照ください。 操作が完了したら、「操作履歴の表示」と「アドホッククエリ機能の使用」に記載されている手順に従って、デバッグ結果を表示できます。 また、「クエリ結果に関連する操作の実行」を行うこともできます。
ノードまたはワークフローをデバッグする場合、スケジューリングリソースの料金は発生しませんが、使用する計算エンジンインスタンスの料金は発生します。 計算エンジンインスタンスの課金詳細については、関連するAlibaba Cloudサービスの課金ルールに関するドキュメントをご参照ください。
ノードのデバッグ
DataStudioページに移動します。 左側の [スケジュール済みワークフロー] または [手動でトリガーされるワークフロー] ペインで、デバッグするノードをダブルクリックして、ノードの構成タブに移動します。
ノードをデバッグします。
ノードの構成タブで、上部のツールバーにある [実行] または [パラメーター付き実行] アイコンをクリックして、完全なコードをデバッグします。 また、ノードのコード行の左側にあるクイック実行アイコンをクリックして、コードスニペットをデバッグすることもできます。 次の表に、デバッグ方法を示します。
説明ノードを実行するときに、クエリするデータにアクセスする権限がない場合は、「コンピューティングエンジンとデータの権限制御」に記載されている手順に従って、DataWorksの計算エンジンインスタンス内のデータの権限管理について理解してください。
デバッグ方法
説明
シナリオ
実行 (
)コードテストシナリオで変数に値を割り当て、スケジューリング用のリソースグループを指定できます。 割り当てられた値と指定されたリソースグループは記録され、後続の実行操作で使用できます。
説明作成したノードを初めて実行すると、[実行] アイコンをクリックした後に [パラメーター] ダイアログボックスが表示されます。 ダイアログボックスで、コード内の変数に定数を割り当てる必要があります。 割り当てられた値はDataWorksによって記録されます。 次回ノードを実行すると、デフォルトで構成が使用されます。
ノードコードを頻繁にデバッグする必要がある場合は、このデバッグ方法を使用します。
パラメーター付き実行 (
)ノードを実行するたびに、テストシナリオで変数に定数を割り当て、スケジューリング用のリソースグループを指定する必要があります。
コード内の変数に割り当てられた値、またはノードに使用されるスケジューリング用のリソースグループを変更する場合は、このデバッグ方法を使用します。
クイック実行 (
)目的のノードの構成タブのコードセクションで、コードスニペットをデバッグできます。
目的のノードのコードスニペットのみをデバッグする必要がある場合は、このデバッグ方法を使用します。
説明この方法は、コードスニペットの正確性を検証するためにのみ使用できます。 完全なコードをデバッグするには、[実行] または [パラメーター付き実行] 方法を使用します。
ワークフローのデバッグ
DataStudioページに移動します。 左側の [スケジュール済みワークフロー] または [手動でトリガーされるワークフロー] ペインで、デバッグするワークフローをダブルクリックして、ワークフローの構成タブに移動します。
ワークフローをデバッグします。
ワークフローの構成タブの上部ツールバーにある
アイコンをクリックします。 これにより、ワークフロー内のノードが依存関係に基づいて順番に実行されます。 説明手動でトリガーされるワークフローのノードに同じ名前の変数を定義し、変数の値を統一的に割り当てることができる場合は、「ワークフローのパラメーター」を構成し、ワークフローの構成タブでパラメーターに値を割り当てることができます。 手動でトリガーされるワークフローを実行して、値の割り当て結果と手動でトリガーされるワークフロー内のノードの実行の詳細を表示できます。
ワークフローパラメーターは、特定タイプのノードに対してのみ構成できます。
ワークフローを実行した後、ワークフローの構成タブで目的のノードを右クリックし、ショートカットメニューから [ログの表示] を選択して、ノードの実行ログを表示できます。
操作履歴の表示
DataStudioページの 操作履歴 ペインに移動して、現在のログオンアカウント内で過去3日間に実行されたすべてのノードのレコードを表示できます。
DataStudioでノードを実行すると、ノードは対応する計算エンジンインスタンスに発行されます。 ノードの実行中に誤ってノードを閉じた場合でも、ノードは継続的に実行されます。 [操作履歴] ペインに移動して、ノードの実行ログを表示したり、ノードを停止したりできます。
アドホッククエリ機能の使用
開発環境でデータと関連する SQL コードとテストコードをクエリしたり、コードの正確性を検証したりするだけの場合は、アドホッククエリ 機能を使用できます。
ノードを実行するときに、クエリするデータにアクセスする権限がない場合は、「コンピューティングエンジンとデータの権限制御」に記載されている手順に従って、DataWorksの計算エンジンインスタンス内のデータの権限管理について理解してください。
クエリ結果の処理
SQL コードの実行後、クエリ結果に対してさまざまな操作を実行できます。 次の表に、操作を示します。
操作 | 説明 | 参照 |
データの分析 | クエリ結果をワークブックに同期します。 これにより、クエリ結果に対してより多くの分析操作を実行できます。 | |
データの共有 | クエリ結果をワークブックに同期し、ワークブックのデータ共有機能を使用して、特定のユーザーとクエリ結果を共有します。 | |
データのダウンロード | クエリ結果をダウンロードし、クエリ結果をワークブックとしてオンプレミスマシンに保存します。 デフォルトでは、10,000件のデータレコードが表示されます。 |
[テナント管理者]、[テナントセキュリティ管理者]、および [ワークスペースマネージャー] ロールが割り当てられている RAM ユーザーは、データクエリと分析の制御 ページに移動して、表示できる SQL クエリ結果レコード数とダウンロードできる SQL クエリ結果レコード数の上限を指定し、ユーザーがデータをダウンロードできるようにするかどうかを決定できます。 詳細については、「RAM ユーザーをワークスペースにメンバーとして追加し、メンバーにロールを割り当てる」をご参照ください。
DataWorks Advanced Edition のみダウンロード機能をサポートしています。 ダウンロード機能を使用するには、DataWorks を Advanced Edition にアップグレードする必要があります。 詳細については、「DataWorks エディション間の違い」をご参照ください。