全部產品
Search
文件中心

IoT Platform:建立指標

更新時間:Jun 30, 2024

通過時間修飾詞、原子詞和計算邏輯等,您可配置衍生指標,然後將建立的指標應用於再次衍生、分析資料報表等業務。本文介紹建立指標的操作步驟。

前提條件

已完成匯入原始定義指標和新增原子詞。具體操作,請參見匯入原始定義指標新增原子詞

操作步驟

  1. 物聯網平台控制台執行個體概覽頁面,單擊目標企業版執行個體ID或備忘名稱。

  2. 在左側導覽列,選擇資料服務 > 資料指標,單擊自訂指標

  3. 所有指標頁簽,單擊建立指標

  4. 根據頁面提示配置指標定義。

    1. 選擇要建立的指標所屬的域後,通過頁面提示,選擇對應的具體實體和衍生範圍

      參數

      說明

      本實體

      作用到當前的實體。

      子實體

      作用到當前實體的子實體。配置衍生定義的指標時,需選擇子實體。

      例如,產品的子實體為對應的裝置,則該衍生定義指標是在每個裝置上做衍生定義指標計算,產品不做衍生定義指標計算。 更多資訊,請參見指標類型

    2. 參考如下說明,設定指標定義。

      參數

      說明

      時間修飾詞

      選擇時間修飾詞,即新增指標統計資料的時間範圍。

      原子詞

      選擇指標域下已添加的原子詞。

      您可以單擊右側前往建立原子詞添加原子詞。更多資訊,請參見添加原子詞

      指標名稱

      指標名稱不可修改,預設按照時間修飾詞+原子詞拼接。

      例如:最近1天平均溫度

      度量單位

      選擇單位類型及對應的具體單位。支援的單位以頁面提供的可選項為準。

      資料類型

      設定資料類型,及對應的精度、小數位元和取值範圍。

      單擊協助協助表徵圖,可查看資料類型詳細說明。

      加工方式

      基於已有指標資產衍生加工。不支援修改。

      是否可被計算

      當該指標是可以累加的數值型指標時,例如筆數、金額、次數等,可選擇

      統計頻率

      以日為周期計算產生資料。不支援修改。

      到期日

      選擇新增指標的到期日。

      重要

      指標到期後,會停止調度生產資料。

      指標描述

      指標的業務描述,預設按照時間修飾詞+原子詞拼接。

      例如:時間修飾詞:最近1天,原子詞:平均溫度

    3. 參考如下說明,設定計算規則。

      計算方式

      說明

      樣本

      彙總計算

      下拉選擇彙總函式、指標、運算子,支援最多添加10個運算式。

      選擇產品域的子實體,函數COUNT(計數)和產品(od3****)的溫度,表示:在產品(od3****)上,通過衍生定義指標,計算記錄溫度的次數。

      運算式計算

      輸入框內編輯運算運算式。支援的函數請參見下文附:函數列表

      您可單擊輸入框上方函數,查看說明和樣本。

      運算式寫法:在輸入框中輸入彙總函式,在函數體內輸入$@符號,選擇指標域,輸入英文句號(.),選擇指標域下的實體,再輸入英文句號(.),選擇需要衍生計算的指標。

      其中,$@符號支援選擇的指標類型不同:

      • $:原始定義和衍生定義。

      • @:原始指標和衍生指標。

      說明

      彙總函式運算式內不支援使用四則運算子。

      產品溫濕度感應器下有100台裝置,其中一台裝置為TH_sensor,以下是基於原始指標、原始定義的溫度衍生出最近一天平均溫度指標運算式。

      • avg($產品.溫濕度感應器.溫度):在產品上通過衍生定義指標,計算所有裝置的平均溫度。

      • avg(@裝置.TH_sensor.溫度):在裝置TH_sensor上,通過衍生定義指標,計算該裝置的平均溫度。

  5. 單擊完成並上線

    您可在所有指標列表中查看到新增完成的指標。

    說明
    • 僅單擊完成的指標,顯示狀態為未上線,暫不摘要資料。

    • 未完成配置的指標,可單擊進入草稿箱,繼續編輯,完成上線。

    指標

  6. (可選)在所有指標列表中,找到目標指標,單擊操作欄功能按鈕,可執行以下操作。

    說明

    原始定義的指標僅支援查看和刪除功能。

    操作

    說明

    查看

    查看指標的基本資料、計算邏輯、資料預覽等詳細資料。

    編輯

    修改衍生指標配置。

    下線

    下線已上線的指標。指標下線後,相關的衍生指標和服務失敗。

    上線

    上線已下線的指標。

    複製

    可在複製指標頁面,根據頁面提示,直接修改指標定義和配置,添加新指標。

    重要

    不支援儲存複製配置完全一致的指標。

    刪除

    刪除當前指標。

    重要

    以下情境,刪除指標,會提示失敗。

    • 該指標存在下遊指標。

    • 該指標已在資料分析報表中使用。

後續操作

由於衍生指標是T+1日維度統計資料,新增指標後,如需立即查看到資料,需手工建立回刷任務,回刷歷史資料。

具體操作,請參見指標回刷

附:函數列表

函數

說明

GREATEST

返回輸入參數中最大的一個。

LEAST

返回輸入參數中最小的一個。

AVG

計算平均值。

MAX

計算最大值。

MIN

計算最小值。

SUM

計算匯總值。

COUNT

計算記錄數。

ABS

計算絕對值。

CEIL

計算向上取整值。

ROUND

返回四捨五入到指定小數點位置的值。

TRUNC

返回截取到指定小數點位置的值。

COALESCE

返回列表中第一個非NULL的值。