時序模型快速入門

注意事項

目前支援時序模型功能的地區包括華東1（杭州）、華東2（上海）、華北2（北京）、華北3（張家口）、華北6（烏蘭察布）、華南1（深圳）、西南1（成都）、中國香港、日本（東京）、新加坡、馬來西亞（吉隆坡）、印尼（雅加達）、德國（法蘭克福）、英國（倫敦）、美國（矽谷）、美國（維吉尼亞）、沙特（利雅得）。

其中支援使用Lastpoint索引、時序分析儲存、自訂時間軸標識和作為主鍵的資料欄位功能的地區有華東1（杭州）、華東2（上海）、華北2（北京）和華北3（張家口），請在上述地區內建立時序模型執行個體。

準備工作

已開通Tablestore服務。具體操作，請參見開通Table Store服務。
建立時序模型執行個體。
1. 登入Table Store控制台。
2. 在頁面上方，選擇資源群組和地區。
3. 在概覽頁面，單擊建立時序模型執行個體。
4. 在建立時序模型執行個體對話方塊，選擇執行個體規格，輸入執行個體名稱，並根據業務需求填寫執行個體注釋。
5. 單擊確定。

操作步驟

步驟一：建立時序表

建立時序表用於儲存時間序列資料。

範例情境及表結構資訊請參見範例情境。

進入執行個體管理頁面。
1. 登入Table Store控制台。
2. 在頁面上方，選擇資源群組和地區。
3. 在概覽頁面，單擊執行個體名稱或者單擊執行個體操作的執行個體管理。
在執行個體詳情頁簽，單擊時序表列表頁簽。
在時序表列表頁簽，單擊建立時序表。

說明
您也可以單擊一鍵產生範例，建立一張測試表以及範例資料來快速體驗功能。對於建立的測試表，系統會進行一些初始化操作，因此需要等待幾十秒左右才能看到時間軸。
在建立時序表對話方塊，填寫時序表名稱為car_example，其他參數保持預設。
單擊創建。

時序表建立完成後，在時序表列表頁簽，您可以查看已建立的時序表。如果建立的表未顯示在列表中，可單擊表徵圖，重新整理時序表列表。

步驟二：寫入資料

向時序表中寫入時序資料。時序資料由中繼資料和資料兩部分組成，如果未預先建立中繼資料，則系統會根據寫入的資料自動提取中繼資料。

在時序表列表頁簽，單擊時序表名稱後選擇資料管理頁簽或在時序表操作列單擊資料管理。
（可選）建立時間軸。
1. 在資料管理頁簽，單擊新增時間軸。
2. 在新增時間軸對話方塊，新增時間軸中繼資料，例如度量名稱、資料來源等。
  
  本樣本中，設定度量名稱為car_tsdata，選擇資料來源，在標籤地區添加篩選條件：key 為car_model、operator 為=、value 為model_A，然後單擊新增。
3. 單擊新增。
插入資料。
1. 單擊指定時間軸操作列的查詢數據。
2. 單擊插入數據。
  
  系統會自動擷取到選定時間軸的中繼資料。
3. 在插入數據對話方塊，設定時間和屬性列。
  
  度量名稱設定為 car_tsdata，標籤添加一行 key 為 car_model、value 為 model_A。時間設定為 2025年2月5日 00:00:00。屬性列（必填）包含以下欄位：vin_id（字串）、model（字串，值為 model_A）、speed（浮點數，值為 75.90）、gps（字串，值為 30.23,52.78）、current_mileage（浮點數，值為 10）、remaining_oil（浮點數，值為 20）、available_mileag（浮點數，值為 198）、tire_pressure（浮點數，值為 2.4）。設定完成後單擊確定。
4. 單擊確定。

步驟三：查詢時序資料

查詢某一時間軸在指定時間範圍內的資料。

如需使用SQL查詢表中資料，請參見使用SQL查詢時序資料。

如果未確定要查詢的時間軸資訊，您可以指定多種條件檢索時間軸。具體操作，請參見檢索時間軸。

在時序表的資料管理頁簽，在目標時間軸的操作列單擊查詢數據。
設定查詢條件。
1. 查詢結果預設按照時間從小到大排序。如需按照時間倒序讀取資料，請選擇倒序查詢為是。
2. 選取查詢方式並設定時間。
單擊查詢。

符合查詢條件的資料會顯示在資料管理頁簽，查詢結果支援按列表或者圖的方式展示。

使用Lastpoint索引

Lastpoint索引可以協助您快速檢索時序表內各時間軸最新時間點的資料。

進入執行個體管理頁面。
1. 登入Table Store控制台。
2. 在頁面上方，選擇資源群組和地區。
3. 在概覽頁面，單擊執行個體名稱或者單擊執行個體操作的執行個體管理。
進入時序表管理頁面。
1. 在執行個體詳情頁簽，單擊時序表列表頁簽。
2. 在時序表列表頁簽，單擊時序表名。
建立Lastpoint索引。
1. 在時序表管理頁面的基本詳情頁簽，單擊建立Lastpoint索引。
2. 在建立Lastpoint索引對話方塊中，設定Lastpoint索引名稱和同步方式。
  
  例如，Lastpoint 索引名稱填寫lastpoint_car_example，同步方式選擇全量同步，然後單擊建立。
3. 單擊創建。
使用Lastpoint索引查詢資料。
1. 單擊Lastpoint索引操作列的查詢。
2. 在查詢數據對話方塊，選擇查詢範圍為範圍查詢，其他保持預設配置。
  
  _#h、_m_name、_data_source和_tags的起始主鍵預設為最小值，結束主鍵預設為最大值。
3. 單擊查詢。
  
  符合查詢條件的資料將顯示在基本詳情頁簽的Lastpoint索引地區中。

檢索時間軸

如果不確定要查詢時間軸資訊（例如度量名稱、資料來源資訊），您可以指定多種條件檢索時間軸。

在時序表的資料管理頁簽，單擊右上方的查詢時間軸。
在查詢數據對話方塊，輸入時間軸的度量名稱或資料來源，並單擊對應地區的添加按需設定標籤、屬性或者更新時間的匹配條件。

樣本中條件用於查詢標籤中含有car_model=model_A的所有時間軸。
單擊確定。

符合查詢條件的資料會顯示在資料管理頁簽。

範例情境

在車連網情境中，車輛通過感應器上報時序資料到雲端。通過儲存、查詢和分析這些時序資料，使用者可以實現車況報告、車輛定位、交通管理和軌跡投屏等業務需求。本文以在車連網情境中儲存車輛時序資料（主要包含車輛軌跡資訊）的時序表為例介紹建立時序表以及讀寫資料的操作。時序表的表名為car_example，該表的結構如下：

欄位名稱	資料類型	描述
_m_name	String	度量名稱，表示時間軸資料所度量的物理量或者監控指標的名稱。
_data_source	String	資料來源，表示產生時間軸的資料來源標識，可以為空白。
_tags	String	時間軸的標籤資訊。您可以自訂多個字串類型的key-value對。
_time	Integer	資料上報時間。
vin_id	String	車輛識別代碼，即車架號，用於唯一標識車輛。
model	String	車輛型號。
speed	Double	當前速度。
gps	String	車輛GPS座標，格式為`緯度,經度`，緯度在前，經度在後，且緯度範圍為[-90,+90]，經度範圍為[-180,+180]。例如`30.23,52.78`。
current_mileage	Double	當前裡程數。
remaining_oil	Double	剩餘油量。
available_mileage	Double	剩餘可行駛裡程。
tire_pressure	Double	胎壓資料。