IoT Platform:オプション：SQL 分析タスクの管理

SQL 分析タスクの管理

1. IoT Platform コンソールの [インスタンス概要] ページで、対象のエンタープライズ版インスタンスの [ID] またはエイリアスをクリックします。

2. 左側のナビゲーションペインで、[Data service] > [Analysis Insight] の順に選択します。

3. [分析インサイト] ページで、[アクション] 列のボタンをクリックして SQL 分析タスクを管理します。

   • [表示]：[データ開発詳細] ページを開き、タスクの基本情報、設定、およびその他の詳細を表示します。

     説明

     SQL 分析タスクが完全に設定されていない場合、一部のデータが表示されないことがあります。

     タイプ	説明
     [基本情報]	SQL 分析タスクの基本情報とストレージ情報を表示します。 基本情報を変更するには、[基本情報の編集] をクリックします。
     [テーブル構造]	出力データのフィールドを表示します。
     [データプレビュー]	クエリしたデータのサンプルをプレビューします。
     [分析 SQL]	分析タスクの SQL ステートメントを表示します。

   • [開発ワークベンチ]: SQL 分析タスクを設定する [SQL データサービスワークベンチ] ページを開きます。

     詳細については、「ステップ 2：SQL 分析ステートメントの作成」および「ステップ 3：タスクスケジューリングポリシーの設定とタスクの公開」をご参照ください。

     重要

     • ステータスが [未公開] または [オフライン] の SQL 分析タスクのみ変更できます。

     • 公開済みのタスクで出力フィールドの名前またはタイプを変更すると、スケジュール実行により、既存のストレージテーブルのデータが新しいデータで上書きされます。

       既存のデータを失うことなく出力ストレージテーブルの構造を調整するには、新しい SQL 分析タスクを作成して設定する必要があります。

     • 公開済みの SQL 分析タスクを変更するには、まずタスクを非公開にする必要があります。

   • [削除]: SQL 分析タスクを削除します。

     重要

     • ステータスが [未公開] または [オフライン] の SQL 分析タスクのみ削除できます。

     • 公開済みの SQL 分析タスクを削除するには、まずタスクを非公開にする必要があります。

     • 削除した SQL 分析タスクは復元できません。

     • タスクが生成したカスタムストレージテーブルが他のデータサービスで使用されている場合、タスクを削除するとそれらのサービスに影響が及びます。

       たとえば、タスクのカスタムストレージテーブルがデータ API のデータソースであり、スケジューリングの有効日より前にタスクをオフラインにして削除した場合、スケジューリングが停止した後は API でデータをクエリできなくなります。

SQL 分析タスクの手動実行

公開済みの SQL 分析タスクは、スケジュールに従って自動的に実行されます。必要に応じて、タスクを手動で実行することもできます。

1. [分析インサイト] ページで、[タスク O&M] をクリックします。

2. [タスク O&M] ページで、[手動インスタンス] タブをクリックし、[手動タスクの作成] をクリックします。

3. [手動タスクの作成] パネルで、手動タスクのパラメーターを設定し、[確認] をクリックします。

   説明

   • 手動タスクを作成すると、システムはタスクのスケジューリング期間に基づいて[手動インスタンス] タブに定期的なインスタンスを生成します。

   • [手動インスタンス] タブの定期インスタンスは、[定期インスタンス] タブのスケジュールされたタスクと重複する可能性があります。

   • タスクの手動実行は、スケジュール実行が失敗した場合や、SQL 分析タスクを修正する場合にのみ行うことを推奨します。

   パラメーター	説明
   スケジューリング期間の選択	[日次スケジューリング] または [毎時スケジューリング] を選択します。詳細については、「スケジューリング期間」をご参照ください。
   手動実行の日付範囲の選択	過去 3 日以内の期間を選択します。システムは、この範囲内でスケジュールされたタスクを再実行します。 たとえば、タスクのスケジュール期間が [日次] で、過去 3 日間を選択した場合、タスクは 1 日に 1 回ずつ、3 回再実行されます。
   手動での下流タスク実行	この SQL 分析タスクの下流タスクも実行するかどうかを指定します。 説明 SQL 分析タスクは依存関係を持つことができます。別の SQL 分析タスクが最初のタスクの出力テーブルをクエリする場合、2 番目のタスクは最初のタスクの下流タスクになります。
   データ開発名/ID	実行する SQL 分析タスクの名前を選択します。

実行ステータスの表示

1. [Task O&M] ページで、実行ステータスを表示したいタスクを見つけます。

   • [定期インスタンス] タブで、定期実行される SQL 分析タスクを表示できます。

   • [手動インスタンス] タブで、手動で実行した SQL 分析タスクを表示できます。

2. SQL 分析タスクの [操作] 列で、対応する操作のボタンをクリックします。

   • [表示] をクリックすると、タスクの基本情報と実行ログを表示できます。

   • タスクを再度実行するには、[再実行] をクリックします。

     説明

     • [初期化中] 状態のタスクの場合、再実行する前に 2 時間待つ必要があります。

     • SQL 分析タスクが失敗した場合、再実行することでエラーを解消できることがあります。