IoT Platform：步驟二：編寫SQL分析語句

背景資訊

下列類型的資料存放區表可作為SQL分析的查詢對象，您可通過SQL分析語句來處理對應表的資料。

• 平台系統資料表：更多資訊，請參見查看平台系統資料表。

• 產品儲存表：作為查詢對象前，需備份資料來源。否則，僅可查詢30天內的資料。

  更多資訊，請參見查看產品儲存表和備份裝置資料來源。

• 自訂儲存表：作為查詢對象前，自訂儲存表需已成為資料解析的目標節點，或其他SQL分析任務的輸出的儲存表。更多資訊，請參見建立和管理自訂儲存表和資料解析。

注意事項

• 輸出欄位僅支援以字母或貨幣符號（$）為首，且僅包含英文字母、數字、貨幣符號（$）和底線（_）。長度不超過60個字元。

  如果原始欄位不滿足以上條件，需為其定義別名。

• 系統欄位和系統函數不可作為輸出欄位。

  類型	不支援的欄位
  系統欄位名	id、gmt_create、gmt_modified、creator、modifier、is_deleted、append_column_name、append_column_value、append_column_concat、scope_id、__closure_context__。
  系統函數	COUNT、DATE_FORMAT、AVG、MAX、MIN、SUM。

• 如果查詢對象的表中存在系統保留欄位，且需查詢該欄位的值，輸出欄位需使用您指定的新別名。

  例如，查詢裝置表${system.device}中欄位gmt_create的值時，將其輸出欄位指定為gmt_create_alias，SQL語句如下：

  select gmt_create as gmt_create_alias from ${system.device}

• 如果輸出欄位的資料類型不支援查詢對象欄位的資料類型，需轉換資料類型。

  例如，裝置表${system.device}中欄位gmt_create的資料類型為DATE，而輸出欄位的資料類型不支援該類型，需轉換為BIGINT，SQL語句如下：

  select CAST(EXTRACT(EPOCH FROM gmt_create) * 1000 AS BIGINT) as gmt_create_alias from  ${system.device}

• 如果SQL任務中需要擷取調度任務的目前時間，直接使用${bizDate}替換current_timestamp()。

  • ${bizDate}：SQL任務的調度時間點，實際執行任務時會被動態替換。格式為13位的毫秒級時間戳記，例如1699286400000。取值範圍是SQL任務調度策略生效日期內的時間。

  • current_timestamp()：當前TIMESTAMP類型的時間戳記。

  使用${bizDate}的原因：

  • 對於當前調度任務，根據當前調度時間${bizDate}和current_timestamp()都可正常調度產出資料。

  • 對於回刷周期任務，需要根據歷史的調度時間點${bizDate}產出資料。此時，如果使用current_timestamp()仍然是按照目前時間產出資料，無法回刷產出歷史時間的資料。

• SQL分析任務支援的函數說明，請參見函數概述。

操作步驟

1. 在分析洞察頁面，找到已建立的SQL分析任務，然後單擊右側操作列的開發工作台，進入SQL資料服務工作台頁面。

   SQL資料服務工作台的詳細說明，請參見步驟一：建立SQL分析任務。

2. 在SQL資料服務工作台左側，選擇要查詢的資料對象。

   重要

   SQL分析任務支援將資料存放區表作為查詢對象，更多資訊，請參見離線資料存放區。

   您可以執行以下操作：

   • 雙擊表名，快速產生查詢語句。

   • 將滑鼠移動至要查詢的表名處後：

     • 單擊複製，然後在SQL語句編寫地區，粘貼表名，用於SQL語句的編寫。

     • 單擊詳情，查看對應儲存表的資料結構，或預覽儲存表最近20條資料。

3. 在SQL語句編輯地區，根據業務需要，編寫SQL分析語句。

   重要

   如果SQL分析任務儲存資料到自訂的時序表中，每條資料寫入都必須包含時間戳記欄位ts，否則資料寫入時序表會失敗。如果寫入失敗，您可通過任務營運頁面查看SQL分析任務的作業記錄。具體操作，請參見營運SQL分析任務。

   您可單擊工作台頂部的智能助手，通過SQL模板快速產生SQL分析語句，進行資料分析。

   1. 您可在SQL模板頁簽，根據資料分析需求，選擇目標函數。

      函數的使用說明，請參見SQL支援的函數。

   2. 等待系統產生對應的SQL分析語句後，單擊立即使用或複製SQL語句到SQL語句編輯地區。

   3. 在SQL語句編輯地區，修改查詢對象等相關參數，即可完成SQL分析語句的編寫。

   

4. 可選：單擊編輯地區上方的驗證SQL表徵圖，校正編寫的SQ分析L語句的文法。

5. 確認SQL分析語句無誤後，單擊編輯地區上方的運行表徵圖。

   • 如果運行成功，可在編輯地區下方的作業記錄、結果頁簽下，分別查看運行SQL分析語句的日誌，及不同圖表樣式的結果。

     您也可單擊匯出資料，下載當前運行結果的CSV檔案。

   • 如果運行失敗，可在作業記錄頁簽下，根據報錯資訊，解決問題後，重新運行。