すべてのプロダクト
Search
ドキュメントセンター

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

最終更新日:Mar 27, 2025

SQL 分析タスクが公開された後、基本情報、構成、およびスケジューリングステータスを表示できます。このトピックでは、SQL 分析タスクを管理する手順について説明します。

前提条件

SQL 分析タスクが構成および公開されていること。具体的な操作については、「ステップ 3: タスクスケジューリングポリシーの設定と公開」をご参照ください。

背景情報

SQL 分析タスクの詳細については、「SQL分析の概要」をご参照ください。

SQL 分析タスクの管理

  1. IoT Platform コンソール[インスタンス概要] ページで、対象の Enterprise Edition インスタンスの [ID] または注釈名をクリックします。

  2. 左側のナビゲーションウィンドウで、[データサービス] > [分析インサイト] を選択します。

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

    • [表示]: [データ開発の詳細] ページで、SQL 分析タスクの基本情報と構成を表示します。

      説明

      SQL 分析タスクが完全に構成されていない場合、一部のデータが利用できない可能性があります。

      情報タイプ

      説明

      [基本情報]

      SQL 分析タスクの基本情報とストレージ情報を表示します。

      [基本情報の編集] をクリックして、SQL 分析タスクの基本情報を変更します。

      [テーブル構造]

      出力データのフィールド情報を表示します。

      [データプレビュー]

      クエリされたデータの一部をプレビューします。

      [分析 SQL]

      分析タスクの SQL 文を表示します。

    • [開発ワークベンチ]: [SQL データサービスワークベンチ] ページで、SQL 分析タスクを構成します。

      具体的な操作については、「ステップ 2: SQL分析文の作成」および「ステップ 3: タスクスケジューリングポリシーの設定と公開」をご参照ください。

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

      • 公開済みの SQL 分析タスクを変更する場合、出力フィールドの名前とタイプを変更すると、変更前に生成されたストレージテーブルのデータは、スケジューリングによって生成された新しいデータによって上書きされます。

        SQL 分析タスクによって出力されるストレージテーブルの構造を調整し、元のストレージテーブルのデータを保持する必要がある場合は、SQL 分析タスクを再作成して構成してください。

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

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

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

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

      • 削除された SQL 分析タスクは復元できないため、注意して操作してください。

      • SQL 分析タスクによって出力されたカスタムストレージテーブルがデータサービス内の他のサービスに適用されている場合、SQL 分析タスクが削除された後、対応するサービスはビジネスレベルで影響を受けます。

        たとえば、SQL 分析タスクによって出力されたカスタムストレージテーブルがデータ API のデータソースになっている場合、スケジューリングの有効期限前にタスクが未公開および削除されると、API はデータをクエリできなくなります。

SQL 分析タスクを手動でスケジューリングする

SQL 分析タスクが公開されると、システムはタスクを定期的にスケジューリングします。必要に応じて、タスクを手動でスケジューリングすることもできます。

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

  2. [タスクメンテナンス] ページで、[ワンタイムインスタンス] タブをクリックし、[ワンタイムタスクの作成] をクリックします。

  3. [ワンタイムタスクの作成] パネルで、ワンタイムタスクのパラメータ設定を完了し、[確認] をクリックします。

    説明
    • ワンタイムスケジューリングタスクを作成した後、SQL 分析タスクのスケジューリングサイクルに従って、[ワンタイムインスタンス] タブに定期スケジューリングタスクが生成されます。

    • [ワンタイムインスタンス] タブの定期スケジューリングタスクは、[定期インスタンス] のスケジューリングタスクと重複する可能性があります。

    • スケジューリングタスクに異常が発生した場合、または SQL 分析タスクに変更があった場合にのみ、タスクを手動でスケジューリングすることをお勧めします。

    設定項目

    説明

    スケジューリングサイクルの選択

    [日次スケジューリング] または [時間スケジューリング] を選択します。詳細については、「スケジューリングサイクル」をご参照ください。

    手動日付の選択

    過去 3 日以内の時間範囲を選択して、選択した時間範囲内で SQL 分析タスクを再スケジューリングします。

    たとえば、SQL 分析タスクのスケジューリングサイクルが [日] の場合、過去 3 日間を手動日付として選択すると、過去 3 日間にわたって合計 3 つのスケジューリングタスクの SQL 分析タスクが再スケジューリングされます。

    手動ダウンストリームメトリック

    SQL 分析タスクのダウンストリームタスクを同時に手動でスケジューリングするかどうかを決定します。

    説明

    SQL 分析タスクには依存関係がある場合があります。ある SQL 分析タスクの出力テーブルが別の SQL 分析タスクのクエリ対象として機能する場合、後者は前者のダウンストリームタスクと見なされます。

    データ開発名/番号

    実行する SQL 分析タスクの名前または番号を選択します。

SQL 分析タスクの実行ステータスを表示する

  1. [タスクメンテナンス] ページで、実行ステータスを表示するタスクを見つけます。

    • [定期インスタンス] タブで、定期的に実行される SQL 分析タスクを確認します。

    • [ワンタイムインスタンス] タブで、手動で実行された SQL 分析タスクを確認します。

  2. SQL 分析タスクの横にある [操作] 列の操作ボタンをクリックして、目的の操作を実行します。

    • [表示] を選択して、SQL 分析タスクの基本情報と操作ログを表示します。

    • [再実行] をクリックして、対応する SQL 分析タスクを再実行します。

      説明
      • ステータスが [初期化済み] のタスクは、2 時間待機してから再実行できます。

      • 再実行すると、SQL 分析タスクの異常実行中に発生した問題が解決される場合があります。

次のステップ

SQL 分析タスクがスケジューリングされると、次のようになります。

  • 結果のカスタムストレージテーブルは、[データストレージ][オフラインストレージ][カスタムストレージテーブル] としてアクセスできます。詳細については、「カスタムストレージテーブル」をご参照ください。

  • 出力ストレージテーブルは、データ API のデータソースとして使用できます。