注意事項(xiàng)

目前支持時(shí)序模型功能的地域包括華東1（杭州）、華東2（上海）、華北2（北京）、華北3（張家口）、華北6（烏蘭察布）、華南1（深圳）、西南1（成都）、中國(guó)香港、日本（東京）、新加坡、馬來西亞（吉隆坡）、印度尼西亞（雅加達(dá)）、德國(guó)（法蘭克福）、英國(guó)（倫敦）、美國(guó)（硅谷）、美國(guó)（弗吉尼亞）。

如果使用過程中遇到問題，請(qǐng)通過釘釘加入用戶群44327024（物聯(lián)網(wǎng)存儲(chǔ) IoTstore 開發(fā)者交流群）聯(lián)系我們。

步驟一：開通表格存儲(chǔ)服務(wù)

如果已經(jīng)開通表格存儲(chǔ)服務(wù)，請(qǐng)?zhí)^此操作。服務(wù)僅需開通一次，開通過程免費(fèi)。

1. 登錄表格存儲(chǔ)產(chǎn)品詳情頁(yè)。

2. 單擊立即開通。

3. 在表格存儲(chǔ)頁(yè)面，仔細(xì)閱讀協(xié)議后選中我已閱讀并同意表格存儲(chǔ)服務(wù)協(xié)議后，單擊立即開通。

   開通服務(wù)后，單擊管理控制臺(tái)，進(jìn)入表格存儲(chǔ)控制臺(tái)界面。

   您也可以單擊阿里云官網(wǎng)首頁(yè)右上方的控制臺(tái)，進(jìn)入阿里云管理控制臺(tái)首頁(yè)，單擊圖標(biāo)，在導(dǎo)航欄中選擇產(chǎn)品與服務(wù) > 存儲(chǔ) > 基礎(chǔ)存儲(chǔ)服務(wù) > 表格存儲(chǔ)TableStore，進(jìn)入表格存儲(chǔ)控制臺(tái)界面。

步驟二：創(chuàng)建時(shí)序模型實(shí)例

1. 登錄表格存儲(chǔ)控制臺(tái)。

2. 在頁(yè)面上方，選擇資源組和地域。

3. 在概覽頁(yè)面，單擊創(chuàng)建時(shí)序模型實(shí)例。

4. 在創(chuàng)建時(shí)序模型實(shí)例對(duì)話框，選擇實(shí)例規(guī)格，輸入實(shí)例名稱，并根據(jù)業(yè)務(wù)需求填寫實(shí)例注釋。

   說明

   關(guān)于實(shí)例命名規(guī)則以及如何選擇實(shí)例規(guī)格，請(qǐng)參見實(shí)例。

5. 單擊確定。

步驟三：創(chuàng)建時(shí)序表

創(chuàng)建時(shí)序表用于存儲(chǔ)時(shí)間序列數(shù)據(jù)。創(chuàng)建時(shí)序表時(shí)您可以按需創(chuàng)建時(shí)序分析存儲(chǔ)。

1. 進(jìn)入實(shí)例管理頁(yè)面。

   1. 登錄表格存儲(chǔ)控制臺(tái)。

   2. 在頁(yè)面上方，選擇資源組和地域。

   3. 在概覽頁(yè)面，單擊實(shí)例名稱或者單擊實(shí)例操作的實(shí)例管理。

2. 在實(shí)例詳情頁(yè)簽，單擊時(shí)序表列表頁(yè)簽。

3. 在時(shí)序表列表頁(yè)簽，單擊創(chuàng)建時(shí)序表。

   說明

   您也可以單擊一鍵生成樣例，創(chuàng)建一張測(cè)試表以及樣例數(shù)據(jù)來快速體驗(yàn)功能。對(duì)于新建的測(cè)試表，系統(tǒng)會(huì)進(jìn)行一些初始化操作，因此需要等待幾十秒左右才能看到時(shí)間線。

4. 在創(chuàng)建時(shí)序表對(duì)話框，按照如下說明配置時(shí)序表信息。

   參數(shù)	描述
   時(shí)序表名稱	時(shí)序表的名稱，用于在實(shí)例中唯一標(biāo)識(shí)一張時(shí)序表。 時(shí)序表的命名規(guī)則為由大小寫字母、數(shù)字或下劃線（_）組成，且只能以字母或下劃線（_）開頭，長(zhǎng)度在1~128個(gè)字符之間。 時(shí)序表名稱不能與已存在的數(shù)據(jù)表名稱重復(fù)。
   數(shù)據(jù)生命周期	時(shí)序表中數(shù)據(jù)的過期時(shí)間，單位為秒。當(dāng)系統(tǒng)判斷當(dāng)前時(shí)間減去用戶傳入數(shù)據(jù)列的時(shí)間已經(jīng)超過設(shè)置的數(shù)據(jù)生命周期時(shí)，系統(tǒng)會(huì)自動(dòng)清理超過數(shù)據(jù)生命周期的數(shù)據(jù)。 重要 在時(shí)序表中，系統(tǒng)判斷數(shù)據(jù)產(chǎn)生時(shí)間以用戶傳入的時(shí)間列為準(zhǔn)，并非數(shù)據(jù)寫入表中的時(shí)間。 取值必須大于等于86400秒（一天）或者必須為-1（數(shù)據(jù)永不過期）。
   創(chuàng)建分析存儲(chǔ)	分析存儲(chǔ)功能主要用于時(shí)序數(shù)據(jù)長(zhǎng)期存儲(chǔ)和分析場(chǎng)景。使用分析存儲(chǔ)（Analytical Store）功能，您可以低成本存儲(chǔ)時(shí)序數(shù)據(jù)以及快速查詢和分析時(shí)序數(shù)據(jù)。更多信息，請(qǐng)參見時(shí)序分析存儲(chǔ)概述。 系統(tǒng)默認(rèn)已開啟分析存儲(chǔ)，請(qǐng)根據(jù)實(shí)際業(yè)務(wù)場(chǎng)景進(jìn)行分析存儲(chǔ)配置。 如果不需要使用分析存儲(chǔ)，關(guān)閉創(chuàng)建分析存儲(chǔ)開關(guān)即可。 如果需要?jiǎng)?chuàng)建默認(rèn)分析存儲(chǔ)，創(chuàng)建分析存儲(chǔ)保持默認(rèn)配置即可。 如果需要自定義分析存儲(chǔ)，創(chuàng)建分析存儲(chǔ)保持默認(rèn)，打開高級(jí)選項(xiàng)開關(guān)并配置分析存儲(chǔ)名稱和分析存儲(chǔ)生命周期。

5. 單擊確定。

   時(shí)序表創(chuàng)建完成后，在時(shí)序表列表頁(yè)簽，您可以查看已創(chuàng)建的時(shí)序表。如果新建的表未顯示在列表中，可單擊圖標(biāo)，刷新時(shí)序表列表。

步驟四：寫入數(shù)據(jù)

通過控制臺(tái)向時(shí)序表中寫入時(shí)序數(shù)據(jù)。時(shí)序數(shù)據(jù)由元數(shù)據(jù)和數(shù)據(jù)兩部分組成，如果未預(yù)先新建元數(shù)據(jù)，則系統(tǒng)會(huì)根據(jù)寫入的數(shù)據(jù)自動(dòng)提取元數(shù)據(jù)。

1. 在時(shí)序表列表頁(yè)簽，單擊時(shí)序表名稱后選擇數(shù)據(jù)管理頁(yè)簽或在時(shí)序表操作列單擊數(shù)據(jù)管理。

2. （可選）新建時(shí)間線。

   1. 在數(shù)據(jù)管理頁(yè)簽，單擊新增時(shí)間線。

   2. 在新增時(shí)間線對(duì)話框，新增時(shí)間線元數(shù)據(jù)。

      

      詳細(xì)參數(shù)說明請(qǐng)參見下表。

      參數(shù)	描述
      度量名稱	時(shí)間線數(shù)據(jù)所度量的物理量或者監(jiān)控指標(biāo)的名稱，例如cpu或net，用于表示該時(shí)間線記錄的是cpu或者網(wǎng)絡(luò)使用率等。
      數(shù)據(jù)源	產(chǎn)生時(shí)間線的數(shù)據(jù)源標(biāo)識(shí)，可以為空。
      標(biāo)簽	時(shí)間線的標(biāo)簽信息。您可以自定義多個(gè)字符串類型的key-value對(duì)。
      屬性	時(shí)間線的屬性列，用于記錄該時(shí)間線的一些屬性信息。

   3. 單擊確定。

3. 插入數(shù)據(jù)。

   1. 單擊插入數(shù)據(jù)。

   2. 在插入數(shù)據(jù)對(duì)話框，設(shè)置時(shí)間和屬性列。

   3. 單擊確定。

步驟五：查詢時(shí)序數(shù)據(jù)

當(dāng)要查詢某一時(shí)間線在指定時(shí)間范圍內(nèi)的數(shù)據(jù)時(shí)，如果未確定要查詢的時(shí)間線信息，您可以指定多種條件檢索時(shí)間線，如果已確定要查詢的時(shí)間線信息，請(qǐng)直接進(jìn)行時(shí)序數(shù)據(jù)查詢即可。

查詢時(shí)序數(shù)據(jù)的具體步驟如下：

1. 在數(shù)據(jù)管理頁(yè)簽，在目標(biāo)時(shí)間線的操作列單擊查詢數(shù)據(jù)。

2. 選擇時(shí)間范圍或者微秒時(shí)間戳的查詢方式并設(shè)置時(shí)間，單擊查詢。

   符合查詢條件的數(shù)據(jù)會(huì)顯示在數(shù)據(jù)管理頁(yè)簽，查詢結(jié)果支持按列表或者圖的方式展示。

   按列表展示數(shù)據(jù)

   

   按圖形展示數(shù)據(jù)

   說明

   圖中不同顏色代表不同的數(shù)據(jù)列，將鼠標(biāo)移動(dòng)到數(shù)據(jù)趨勢(shì)線上將顯示該時(shí)間節(jié)點(diǎn)上不同數(shù)據(jù)列的值。您還可以通過取消選中或者選中指定數(shù)據(jù)列來展示所需數(shù)據(jù)列。

   

步驟六：使用SQL查詢數(shù)據(jù)

SQL查詢兼容MySQL的查詢語(yǔ)法。創(chuàng)建時(shí)序表并建立SQL映射關(guān)系后，您可以使用SQL方式訪問表中數(shù)據(jù)。

對(duì)于同一個(gè)時(shí)序表，您可以建立三種SQL映射關(guān)系用于數(shù)據(jù)查詢。更多信息，請(qǐng)參見使用SQL查詢時(shí)序數(shù)據(jù)。

1. 在概覽頁(yè)面，單擊實(shí)例名稱或在實(shí)例操作列單擊實(shí)例管理。

2. 在SQL查詢頁(yè)簽，根據(jù)實(shí)際選擇合適的映射表進(jìn)行數(shù)據(jù)查詢。

   • 如果要檢索時(shí)間線，選擇時(shí)間線元數(shù)據(jù)映射表后，執(zhí)行SELECT語(yǔ)句查詢所需時(shí)間線。

     例如要查詢時(shí)序元數(shù)據(jù)映射表timeseries_table::meta中basic_metric度量類型下的時(shí)間線，SQL示例如下：

     SELECT * FROM `timeseries_table::meta` WHERE _m_name = "basic_metric" LIMIT 100;

   • 如果要以單值模型查詢時(shí)序數(shù)據(jù)，選擇單值模型映射表后，執(zhí)行SELECT語(yǔ)句查詢滿足條件的時(shí)序數(shù)據(jù)。

     例如要查詢單值模型映射表timeseries_table中basic_metric度量類型的數(shù)據(jù)，SQL示例如下：

     SELECT * FROM timeseries_table WHERE _m_name = "basic_metric" LIMIT 10;

   • 如果要以多值模型查詢時(shí)序數(shù)據(jù)，創(chuàng)建多值模型映射關(guān)系后，執(zhí)行SELECT語(yǔ)句查詢滿足條件的時(shí)序數(shù)據(jù)。

     說明

     關(guān)于創(chuàng)建多值模型映射關(guān)系的具體操作，請(qǐng)參見創(chuàng)建多值模型映射關(guān)系。

     例如要查詢多值模型映射表timeseries_table::muti_model中cpu大于20.0的所有度量信息，SQL示例如下：

     SELECT cpu,memory,disktop FROM `timeseries_table::muti_model` WHERE cpu > 20.0 LIMIT 10;

相關(guān)文檔

• 您可以通過命令行工具快速體驗(yàn)時(shí)序模型。具體操作，請(qǐng)參見通過命令行工具CLI使用時(shí)序模型。

• 當(dāng)要在實(shí)際業(yè)務(wù)中使用表格存儲(chǔ)時(shí)，請(qǐng)參見時(shí)序模型介紹和通過SDK使用時(shí)序模型文檔了解產(chǎn)品時(shí)序模型的使用限制、使用流程等信息，并根據(jù)業(yè)務(wù)特點(diǎn)選擇合適的計(jì)費(fèi)模式來節(jié)省使用成本。更多信息，請(qǐng)參見計(jì)費(fèi)模式使用推薦。

• 如果要通過控制臺(tái)進(jìn)行更多時(shí)序模型的功能操作，請(qǐng)參見通過控制臺(tái)使用時(shí)序模型。

• 基于時(shí)序模型可以實(shí)現(xiàn)基于設(shè)備接入平臺(tái)與Tablestore搭建車輛軌跡數(shù)據(jù)平臺(tái)等方案。更多方案介紹，請(qǐng)參見場(chǎng)景實(shí)戰(zhàn)-典型場(chǎng)景架構(gòu)與實(shí)現(xiàn)。