Tablestore提供了控制台、命令列工具（Tablestore CLI）和Tablestore SDK三種訪問方式。通過控制台，您可以使用可視化介面快速體驗Tablestore服務。本文介紹了如何通過控制台管理寬表模型（WideColumn）。

前提条件

在使用Tablestore服務前，請確保您已經註冊了阿里雲帳號並完成實名認證。如果您還沒有建立阿里雲帳號，系統會在您開通Tablestore服務時提示您註冊帳號。

步驟一：開通Tablestore服務

如果已經開通Tablestore服務，請跳過此操作。服務僅需開通一次，開通過程免費。

  1. 登入Tablestore產品詳情頁。
  2. 單擊免費開通。
  3. 在Tablestore (Pay-As-You-Go)頁面，單擊立即購買。
  4. 在確認訂單頁面，選中我已閱讀並同意《Tablestore (Pay-As-You-Go)服務合約》，單擊立即開通。
    開通服務後，單擊管理主控台，進入Tablestore控制台介面。

    您也可以單擊阿里雲官網首頁右上方的控制台，進入阿里雲管理主控台首頁，單擊fig_tablestore_control_001表徵圖，在導覽列中選擇產品與服務 > 儲存 > 基礎儲存服務 > Tablestore，進入Tablestore控制台介面。

步驟二：建立執行個體

執行個體是Tablestore資源管理的基礎單元，Tablestore對應用程式的存取控制和資源計量均在執行個體層級完成。建立執行個體後，您可以在執行個體中建立和管理表。

  1. 登入Tablestore控制台。
  2. 在頁面上方，選擇地區，例如華東1（杭州）、華南1（深圳）等。
    選擇地區後，控制台上會提示該地區支援的執行個體規格。
  3. 單擊建立執行個體。
  4. 在購買方式對話方塊的按量模式頁簽，輸入執行個體名稱，選擇執行個體規格，根據業務需求填寫執行個體注釋。
    關於執行個體命名規則以及如何選擇執行個體規格，請參見執行個體。
    重要
    • 執行個體規格在執行個體建立後無法修改。
    • 單個阿里雲賬戶最多可以建立10個執行個體，且在同一地區中執行個體名稱必須唯一。
  5. 單擊確定。

步驟三：建立資料表

建立資料表後，您可以在資料表中讀寫資料。建立資料表時，您可以根據業務需求同時建立二級索引用於讀取資料。

  1. 在概覽頁面，單擊執行個體名稱或在操作列單擊執行個體管理。
  2. 在執行個體詳情頁簽，單擊建立資料表。
    说明 單個執行個體最多可以建立64張資料表。
  3. 在建立資料表對話方塊，按照下表說明配置相關參數。
    參數描述
    資料表名稱資料表名稱，用於在執行個體中唯一標識一張資料表。

    資料表的命名規則為由大小寫字母、數字或底線（_）組成，且只能以字母或底線（_）開頭，長度在1個~255個位元組之間。

    表主鍵表中的一列或多列，用於唯一標識表中的一條記錄。

    輸入表主鍵名稱並選擇資料類型，單擊添加表主鍵，可加入新的主鍵。

    單表最多可設定4個主鍵，第一個主鍵預設為分區鍵。主鍵的配置及順序設定後不能修改。

    说明
    • Tablestore支援將主鍵列設定為自增列，每張表只能設定一個主鍵列為自增列，且分區鍵不能設定為自增列。
    • 主鍵列設定為自增列後，在寫入一行資料時，該主鍵列無需填值，Tablestore會自動產生該主鍵列的值。自動產生的主鍵列的值在分區鍵內嚴格遞增且唯一。
    • 表主鍵名稱的命名規則為由大小寫字母、數字或底線（_）組成，且只能以字母或底線（_）開頭，長度在1個~255個位元組之間。
    • 主鍵的資料類型可選為字串、整型或二進位。
    是否允許更新是否允許通過UpdateRow更新寫入資料。預設值為是，表示允許通過UpdateRow更新寫入資料。

    當要使用多元索引生命週期功能時，您必須設定此參數為否，即不允許通過UpdateRow更新寫入資料。關於多元索引生命週期的更多資訊，請參見多元索引生命週期。

    是否加密是否開啟資料落盤加密。系統預設未開啟資料落盤加密功能。開啟是否加密開關，即可開啟資料落盤加密功能。
    重要 資料落盤加密功能開啟後不支援關閉，請謹慎操作。
    加密類型資料的加密類型，固定取值為KMS服務主要金鑰。選擇加密類型後，Tablestore會自動建立KMS服務主要金鑰用於資料落盤加解密。只有開啟是否加密開關時才能配置此參數。
  4. （可選）在建立資料表對話方塊，進行進階配置或者建立二級索引。
    當需要對資料表設定資料生命週期等進階配置或者建立二級索引時，請執行此步驟。
    • 開啟進階設定開關，配置進階參數，參數說明如下。
      參數描述
      資料生命週期資料表中資料的儲存時間。當資料的儲存時間超過設定的資料生命週期時，系統會自動清理超過資料生命週期的資料。單位為秒。

      取值：大於等於86400秒（一天）或-1（資料永不到期）。

      最大版本數資料表中的屬性列能夠保留資料的最大版本個數。當屬性列資料的版本個數超過設定的最大版本數時，系統會自動刪除較早版本的資料。

      取值必須為非0整數。

      資料有效版本偏差指定的資料版本號碼與系統目前時間偏差的允許最大值，單位為秒。有效版本偏差為正整數，可以大於1970-01-01 00:00:00 UTC時間到目前時間的秒數。

      只有當寫入資料所有列的版本號碼與寫入時時間的差值在資料有效版本偏差範圍內，資料才能成功寫入。

      屬性列的有效版本範圍為[max{資料寫入時間-有效版本偏差,資料寫入時間-資料生命週期}，資料寫入時間+有效版本偏差)。

      預留讀輸送量容量型執行個體不支援該參數。

      為資料表預留讀輸送量或寫輸送量。取值範圍為0~100000，且取值必須為整數。單位為CU。

      • 當預留讀輸送量或預留寫輸送量大於0時，Tablestore會根據配置為資料表分配和預留相應資源，且資料表建立成功後，將會立即按照預留輸送量開始計費。
      • 當預留讀輸送量或預留寫輸送量為0時，Tablestore不會為資料表分配和預留相應資源。
      預留寫輸送量
    • 開啟建立二級索引開關，建立二級索引。
      • 單擊添加預定義列，輸入預定義列名稱和選擇資料類型。

        預定義列名稱命名規則為由大小寫字母、數字或底線（_）組成，且只能以字母或底線（_）開頭，長度在1個~255個位元組。

        預定義列的資料類型可選為字串、整型、二進位、浮點數或布爾值。

      • 單擊添加二級索引，輸入索引名稱，選擇索引主鍵，根據需要選擇索引預定義列及索引類型。
  5. 單擊確定。
    資料表建立完成後，在資料表列表地區，可以查看已建立的資料表。如果建立的表未顯示在列表中，可單擊fig_tablestore_002表徵圖，重新整理資料表列表。

步驟四：讀寫資料

在資料表中寫入、更新、讀取或者刪除資料。

  1. 在執行個體詳情頁簽的資料表列表地區，單擊資料表名稱後選擇資料管理頁簽或在操作列單擊查詢/搜尋。
  2. 插入一行資料。
    1. 在資料管理頁簽，單擊插入資料。
    2. 在插入資料對話方塊，輸入主鍵的值，單擊增加屬性列，輸入屬性列名稱、屬性列類型、屬性值和資料版本號碼。
      系統預設已選中使用系統時間複選框，採用當前系統時間作為資料版本號碼。您也可以清除使用系統時間複選框輸入資料版本號碼。
    3. 單擊確定。
  3. 更新一行資料。
    1. 在資料管理頁簽，選中需要更新的資料行，單擊更新資料。
    2. 在更新資料對話方塊，修改主鍵的屬性值，增加或刪除屬性列，更新或刪除屬性列的資料。
      • 單擊增加屬性列，增加屬性列；單擊fig_tablestore_005，刪除屬性列。
      • 選擇更新操作為更新，修改屬性列的資料；選擇更新操作為刪除，選擇需要刪除的資料版本號碼，刪除對應資料版本號碼的資料；選擇更新操作為刪除全部，刪除全部資料版本號碼的資料。
    3. 單擊確定。
  4. 讀取資料。
    單行查詢的操作步驟如下：
    1. 在資料管理頁簽，單擊查詢資料。
    2. 設定查詢條件。
      1. 選擇查詢範圍為單行查詢，並選擇要查詢的表或者二級索引。
      2. 系統預設返回所有列，如需顯示指定屬性列，關閉擷取所有列並輸入需要返回的屬性列，多個屬性列之間用英文逗號（,）隔開。
      3. 輸入目標行的主鍵值。

        主索引值的完整性和準確性均會影響查詢。

      4. 輸入最大版本數，指定需要返回的版本數。
    3. 單擊確定。
    範圍查詢的操作步驟如下：
    1. 在資料管理頁簽，單擊查詢資料。
    2. 設定查詢條件。
      1. 選擇查詢範圍為範圍查詢，並選擇要查詢的表或者二級索引。
      2. 系統預設返回所有列，如需顯示指定屬性列，關閉擷取所有列並輸入需要返回的屬性列，多個屬性列之間用英文逗號（,）隔開。
      3. 系統預設返回所有列，如需顯示指定屬性列，關閉擷取所有列並輸入需要返回的屬性列，多個屬性列之間用英文逗號（,）隔開。
      4. 輸入起始主鍵列和結束主鍵列。
        说明
        • 範圍查詢優先使用第一個主索引值進行查詢，當設定的第一個主索引值一致時，系統會使用第二個主索引值進行查詢，其他主鍵的查詢規則同上。
        • 讀取範圍是前開後閉的區間。
      5. 輸入最大版本數，指定需要返回的版本數。
      6. 設定查詢結果的排序方向，可選正序查詢或逆序查詢。
    3. 單擊確定。
  5. 刪除資料。
    重要 刪除表資料，將導致資料不可恢複，請謹慎操作。
    1. 在資料管理頁簽，選中需要刪除的資料行，單擊大量刪除。
    2. 在大量刪除對話方塊，單擊確定。

步驟五：使用SQL查詢資料

SQL查詢相容MySQL的查詢文法，同時提供基礎的SQL DDL建表能力。對於已有資料表，通過執行CREATE TABLE一鍵自動建立映射關係後，您可以使用SQL方式訪問表中資料。

  1. 在概覽頁面，單擊執行個體名稱或在操作列單擊執行個體管理。
  2. 在SQL查詢頁簽，建立映射關係。
    1. 單擊fig_createtablevitural表徵圖。
      说明 當不存在映射表時，單擊SQL查詢頁簽，系統會自動彈出建立映射表對話方塊。
      fig_createtablemapping
    2. 在建立映射表對話方塊，根據下表說明配置參數。
      參數描述
      表名資料表名稱。
      映射模式建立映射關係的模式。取值範圍如下：
      • 表映射（預設）：為已存在的資料表建立映射關係。
      • 多元索引映射：為已存在的多元索引建立映射關係。
      進階選項用於配置映射表的一致性模式和是否使用不準確彙總。開啟進階選項開關，即可進行配置。只有當映射模式選擇為表映射時才能配置。
      一致性模式執行引擎支援的一致性模式。取值範圍如下：
      • 最終一致（預設）：執行的查詢結果滿足最終一致。此時新資料寫入後會在幾秒後影響到查詢結果。
      • 強一致性：執行的查詢結果滿足強一致性。此時新資料寫入後立刻影響到查詢結果。

      只有開啟了進階選項開關後才能配置。

      不準確彙總是否允許通過犧牲彙總操作的精準度提升查詢效能。取值範圍如下：
      • 是（預設）：允許通過犧牲彙總操作的精度提升查詢效能。
      • 否：不允許通過犧牲彙總操作的精度提升查詢效能

      只有開啟了進階選項開關後才能配置。

      多元索引表映射表綁定的多元索引名稱。只有當映射模式選擇為多元索引映射時才能配置。
      映射表表名映射表名稱。
      • 當映射模式選擇為表映射時，映射表表名與資料表名稱相同，不能更改。
      • 當映射模式選擇為多元索引映射時，需要填寫映射表名稱。
    3. 單擊產生SQL。
      系統會自動產生建立映射表的SQL語句。SQL樣本如下：
      CREATE TABLE `exampletable` (
    `id` BIGINT(20),
    `colvalue` MEDIUMTEXT,
    `content` MEDIUMTEXT,
    PRIMARY KEY(`id`)
);
      重要 請確保映射關係中欄位資料類型和資料表中欄位資料類型相匹配。關於資料類型映射的更多資訊，請參見資料類型映射。
    4. 根據實際需要修改映射表的Schema後，按住滑鼠左鍵拖動選中一條SQL語句並單擊執行SQL(F8)。

      執行成功後，在執行結果地區會顯示執行結果。

      重要
      • 建立映射表時設定的Schema中需要包括後續查詢資料所需的列。
      • 執行SQL語句時，請選中一條所需SQL語句，否則系統預設執行第一條SQL語句。
      • 執行SQL語句時，一次只能選中一條SQL語句，否則系統會報錯。
      fig_sqlquery
  3. 執行SELECT語句查詢所需資料。