DataStudio で手動トリガータスクを作成し、オペレーションセンターで管理できます。このトピックでは、手動トリガータスクを作成して本番環境にデプロイする方法について説明します。
使用上の注意
-
タスクを本番環境にデプロイしてコンピュートエンジンで実行する必要がない場合は、代わりにアドホッククエリを作成できます。
-
手動トリガータスクは手動でのみ実行でき、自動スケジューリングには対応していません。
-
手動トリガータスクを線で接続することで実行順序を設定できますが、これによってスケジューリング依存関係が作成されるわけではありません。
-
手動トリガーワークフローと定期実行ワークフローの間には、わずかな違いしかありません。UI については、「DataStudio ページの機能」をご参照ください。
手動トリガーワークフローページへの移動
ページに移動して、手動トリガータスクを作成します。
-
[DataStudio] ページに移動します。
DataWorks コンソールにログインします。 左側のナビゲーションウィンドウで、 を選択します。 表示されるページで、ドロップダウンリストから目的のワークスペースを選択し、[DataStudioに移動] をクリックします。
-
Data Studio ページで、左側のナビゲーションペインの Manually Triggered Workflows をクリックします。このメニュー項目が表示されない場合は、「表示される DataStudio モジュールを調整する」を参照して手動で追加してください。
手動トリガーワークフローの作成
DataWorks では、ワークフロー内でデータ開発タスクを整理します。ワークフローはコンテナとして機能し、特定のビジネス目的のためにノード、ツール、管理アクションを配置するキャンバスを提供します。次の手順では、ワークフローの作成方法について説明します。
-
次のいずれかの方法でワークフローを作成します：
-
方法 1:
アイコンにカーソルを合わせ、Create Workflowをクリックします。 -
方法 2: DataStudio の左側のディレクトリツリーで、Manually Triggered Workflows を右クリックし、Create Workflow を選択します。
-
-
「ワークフローの作成」ダイアログボックスで、ワークフローの名前と説明を入力し、Create をクリックします。
ワークフローの詳細については、「ワークフローの作成と管理」をご参照ください。
手動トリガーノードの作成
ディレクトリツリーまたはワークフローキャンバスからノードを作成できます。
-
手動トリガーノードを作成します。
-
方法 1： ディレクトリツリーから作成します。
-
手動トリガーワークフローの下のディレクトリツリーで、「手動トリガーワークフローの作成」で作成したワークフローを見つけます。
-
必要なコンピューティングエンジンを右クリックし、Create Node でノードタイプを選択します。
-
-
方法 2： ワークフローキャンバスから作成します。
-
Manually Triggered Workflows 配下のディレクトリツリーで、「手動トリガーワークフローの作成」で作成したワークフローを探します。
-
ワークフローをダブルクリックして、ワークフローキャンバスを開きます。
-
キャンバスの上部で、Create Node をクリックします。 次に、左側のナビゲーションペインで、必要なノードタイプをクリックするか、キャンバスにドラッグします。
-
-
-
ノード名、コンピュートエンジンインスタンス、その他の情報を構成します。
-
タスクコードを定義します。
選択したコンピュートエンジンの構文を使用してタスクロジックを記述します。パラメータを動的に渡すには、
${変数名}形式で変数を定義します。その後、定期実行タスクの変数定義と同様に、ノードプロパティでこれらの変数にデフォルト値を割り当てることができます。説明スケジューリングパラメータの構成は、ノードタイプによって異なります。たとえば、Shell ノードの変数は $1、$2、$3、... の形式を使用する必要があります。詳細については、「異なるタイプのノードのスケジューリングパラメータの構成」をご参照ください。
(オプション) 実行順序の設定
手動トリガーワークフロー内のノードの実行順序を定義することは任意です。ただし、ワークフローキャンバス上でノードを接続して、上流から下流への実行順序を設定できます。ワークフロー全体を実行すると、定義された順序のないノードは同時にトリガーされ、定義された順序のあるノードは順次トリガーされます。
ノードプロパティの構成
タスクが本番環境のコンピュートエンジンからデータにアクセスする必要がある場合は、ノードエディターの右側のパネルで実行プロパティを構成できます。これらのプロパティは、定期実行タスクと同じです。次のプロパティを使用できます。
|
プロパティ |
説明 |
|
ノード名、ID、タイプ、所有者が自動的に表示されます。構成は不要です。 説明
|
|
|
ノードの実行時に使用されるパラメータを定義します。 説明
DataWorks には、タスク実行時に動的に値を割り当てるための組み込みパラメータとカスタムパラメータが用意されています。コードで変数を定義した場合は、このセクションで変数に値を割り当ててください。 |
|
|
タスクが本番環境にデプロイされた後に実行するために使用されるリソースグループを指定します。現在のワークスペースで使用可能なスケジューリングリソースグループを選択できます。DataWorks サーバーレスリソースグループの購入と使用を推奨します。詳細については、「サーバーレスリソースグループの使用」をご参照ください。 |
手動トリガーノードのデバッグ
ノードエディターのツールバーにある 
アイコンと 
アイコンを使用して、現在のノードをデバッグできます。また、ワークフローキャンバスの 
実行アイコンをクリックして、手動トリガーワークフロー全体をデバッグすることもできます。
この操作は、お客様のアカウントで実行され、開発環境用に設定されたデータソースを使用します。 データソースを表示または管理するには、 ページに移動します。 詳細については、「データソースの管理」をご参照ください。
(オプション) ワークフローパラメータの定義
手動トリガーワークフローに同じ名前の変数が含まれており、それらに 1 か所で値を割り当てたい場合は、ワークフローキャンバスでワークフローパラメータを定義できます。パラメータを定義した後、ワークフローを実行し、パラメータに値を割り当て、それらの値を使用した手動トリガータスクの実行の詳細を表示できます。
ワークフローパラメータにデフォルト値を設定することも、パラメータ名のみを定義して、本番環境でワークフローを実行するたびに特定の値を割り当てることもできます。
ノードのコミットとデプロイ
本番環境で手動トリガータスクを実行するには、ノードを保存してコミットし、オペレーションセンターにデプロイする必要があります。詳細については、「ノードのデプロイ」をご参照ください。デプロイが失敗する可能性があるため、最終的なデプロイステータスを確認してください。
タスクのデプロイ後、に移動して、デプロイした手動トリガーノードを確認できます。
本番環境でのタスクの実行
手動でトリガーされたタスクを実行するには、 に移動し、[手動トリガータスク] ページを開きます。このページでは、目的のタスクを見つけて実行できます。
手動トリガータスクは、最大 3 日間実行できます。タスクがこの制限を超えると、DataWorks は自動的にタスクを停止し、対応するインスタンスは失敗します。
-
ワークフローパラメータ値の割り当て： 手動トリガーワークフローにワークフローパラメータがある場合、ワークフローを実行するたびにパラメータに値を割り当てることができます。このアクションにより、ワークフローのノードのコード内で名前が一致するすべての変数に同じ値が割り当てられます。このオプションは、ワークフローパラメータが定義されているワークフローでのみ使用できます。
-
タスクの実行順序： 実行順序は、「(オプション) 実行順序の設定」セクションで説明されているロジックに従います。
-
ワークフロー全体を実行すると、定義された実行順序のないタスクは同時にトリガーされます。
-
定義された実行順序を持つタスクは、順次実行されます。
-
本番環境で手動タスクを実行すると、手動インスタンスが生成されます。実行結果は、 にある 手動インスタンス ページで確認できます。