すべてのプロダクト
Search

このプロダクト

    IoT Platform:手順 1: SQL分析ジョブを作成する

    ドキュメントセンター

    IoT Platform:手順 1: SQL分析ジョブを作成する

    最終更新日:Mar 27, 2025

    このトピックでは、SQL分析ジョブの作成方法の概要と、SQL分析コンソール内のクエリオブジェクトエリア、SQLステートメント編集エリア、および操作バーの機能について説明します。

    前提条件

    IoT Platform Enterprise Edition インスタンスが購入済みであること。 詳細については、「Enterprise Edition インスタンスを購入する」をご参照ください。

    背景

    SQL分析コンソールでは、SQL分析ジョブを構成できます。 詳細については、「SQL分析の概要」をご参照ください。

    SQL分析ジョブを作成する

    1. IoT Platform コンソール で、[概要] をクリックします。 [概要] タブで、管理するインスタンスを見つけ、インスタンス [ID] またはインスタンス名をクリックします。

    2. 左側のナビゲーションバーで、[dataservice Studio] > [分析インサイト] を選択します。

    3. Analytics Insight ページで、[新規 SQL 分析] をクリックします。

    4. ポップアップ ダイアログボックスで、SQL分析ジョブの [データ開発名] と [説明] 情報を入力し、[説明] [OK] をクリックします。

      重要

      [データ開発名] には、漢字、数字、英字、およびアンダースコアを含めることができ、長さは 32 文字以下にする必要があります。

    SQL DataService Studio に入る

    1. IoT Platform コンソール で、[概要] をクリックします。 [概要] タブで、管理するインスタンスを見つけ、インスタンス [ID] またはインスタンス名をクリックします。

    2. 左側のナビゲーションバーで、[dataservice Studio] > [分析インサイト] を選択します。

    3. [分析インサイト] ページで、構成する SQL 分析ジョブを見つけ、右側の [操作] 列をクリックし、[開発コンソール] を選択します。

      SQL DataService Studio に入ると、次のように機能が配置されています。

    コンソールの詳細は以下のとおりです。

    コンソールの左側: クエリオブジェクトエリア

    各タブの下にあるデータテーブルをダブルクリックして、クエリオブジェクトとして選択します。

    テーブルタイプ

    選択可能なデータテーブル

    説明

    プロダクトストレージテーブル

    プロダクト属性時系列テーブル

    デバイスから IoT Platform にレポートされた TSL (Thing Specification Language) プロパティおよびイベントデータを格納します。

    プロダクト属性スナップショットテーブル

    プロダクトイベントテーブル

    IoT ツインエンジン時系列テーブル

    IoT ツインエンジンのツインスペースにあるツインノードの TSL (Thing Specification Language) プロパティデータを格納します。

    IoT ツインエンジンスナップショットテーブル

    カスタムストレージテーブル

    トランザクショナルテーブル

    SQL分析ジョブによって解析または生成されたデータ、およびタスクスケジューリング後にカスタムストレージテーブルに出力されたデータなど、カスタム初期化と構成が行われたデータを格納します。

    パーティションテーブル

    時系列テーブル

    プラットフォームシステムテーブル

    プロダクト、デバイス、デバイスグループ、デバイスタグ、デバイスの場所などの重要な情報を格納します。

    コンソールの右側: SQLステートメント編集エリア

    機能

    説明

    运行按钮

    このアイコンをクリックして、記述した SQL ステートメントを実行します。

    • 実行に成功した場合、編集エリアの下にある [実行ログ]、[結果]、および [出力構造] タブで、SQL 文のログ、結果、および出力フィールド構造を確認できます。

    • 実行に失敗した場合、[実行ログ] タブでエラー情報を確認し、問題に対処して再実行できます。実行ログ

    停止

    このアイコンをクリックして、現在実行中の SQL ステートメントを停止します。

    验证SQL

    このアイコンをクリックして、SQL ステートメントを基本仕様に照らして検証します。

    代码格式化

    このアイコンをクリックすると、SQL ステートメントがフォーマットされ、読みやすさが向上します。 例：

    • フォーマット前:

      SELECT `description`, `gmt_create` AS `gmt_create_alias`, `gmt_modified` AS `gmt_modified_alias`, `group_id`, `group_type`, `name` FROM ${system.device_group} LIMIT 5

    • フォーマット後:

      SELECT `description`, `gmt_create` AS `gmt_create_alias`, `gmt_modified` AS `gmt_modified_alias`, `group_id`, `group_type`
, `name`
FROM ${system.device_group}
LIMIT 5

    実行ログ

    SQL ステートメントの実行後:

    • 実行に失敗した場合、デフォルトでこのタブに実行ログが表示されます。

    • 実行に成功した場合、ここをクリックして実行ログを表示します。

    結果

    実行に成功した後、デフォルトでこのタブにクエリ結果が表示されます。

    説明

    クエリ条件を満たすデータエントリは、最大 200 件までここに表示されます。

    コンソールの上部: 操作エリア

    機能

    説明

    image.png

    SQL ステートメントが完了したら、[公開して実行] アイコンをクリックして、SQL分析ジョブの実行ポリシーを定義し、公開します。

    実行ポリシーには以下が含まれます。

    • 結果ストレージテーブル: クエリ結果を指定されたカスタムストレージテーブルに出力します。

    • データ書き込みポリシー: SQL分析ジョブのスケジューリング時のデータ書き込みポリシー。デフォルトは [プライマリキー上書き] に設定されており、変更できません。

    • プライマリキー: データのプライマリキーフィールドを示し、カスタムストレージテーブルのプライマリキーフィールドを表示します。

    • スケジューリングポリシーの有効日: SQL分析ジョブをスケジューリングする時間範囲を指定します。

    • スケジューリングサイクル: SQL分析ジョブをスケジューリングする頻度を決定します。

    撤销

    公開済みの SQL 分析ジョブを取り消すには、[取り消し] アイコンをクリックします。

    保存

    SQL分析ジョブの現在の構成を保存するには、[保存] アイコンをクリックします。

    快捷键

    ショートカットキーを表示するには、[ショートカットキー] アイコンをクリックします。

    Windows 環境では、次のショートカットキーを使用します。Mac 環境では、 Ctrl を Command に置き換えます。

    • [保存]: Ctrl+S

    • [実行]: Ctrl+Enter

    • フォーマット: Ctrl+F

    • [SQL の確認]: Ctrl+I

    帮助

    IoT DataService Studio のサポートについては、[ヘルプ] アイコンをクリックして、関連ドキュメントにアクセスしてください。

    image.png

    • [SQL テンプレート] 機能は、SQL分析ステートメントの作成を迅速化するためのテンプレートを提供します。