步驟一：開通表格存儲服務

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

1. 登錄表格存儲產品詳情頁。

2. 單擊立即開通。

3. 在表格存儲頁面，仔細閱讀協議后選中我已閱讀并同意表格存儲服務協議后，單擊立即開通。

   開通服務后，單擊管理控制臺，進入表格存儲控制臺界面。

   您也可以單擊阿里云官網首頁右上方的控制臺，進入阿里云管理控制臺首頁，單擊圖標，在導航欄中選擇產品與服務 > 存儲 > 基礎存儲服務 > 表格存儲TableStore，進入表格存儲控制臺界面。

步驟二：創建實例

實例是表格存儲資源管理的基礎單元，表格存儲對應用程序的訪問控制和資源計量均在實例級別完成。創建實例后，您可以在實例中創建和管理表。

1. 登錄表格存儲控制臺。

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

3. 單擊創建實例。

4. 在購買方式對話框中，根據實際情況選擇計費模式。

   表格存儲提供VCU模式（原預留模式）和CU模式（原按量模式）兩種實例模型。

   說明

   關于計費模式的區別，請參見VCU模式和CU模式的區別。關于實例命名規則以及如何選擇實例規格，請參見實例。

   • VCU模式（原預留模式）：按照資源評估結果預先購買預留VCU或開啟彈性能力后按實際使用量支付計算性能消耗費用。您可以疊加使用預留VCU和彈性能力來節約成本。

     此模式能為用戶節省更多的計算資源支付費用。同時此模式也通過配置彈性能力上限或關閉彈性能力保障整體使用資源可控，避免異常流量導致的額外費用，是對于成本可控場景的更優選擇。

   • CU模式（原按量模式）：根據業務的實時讀寫吞吐量、存儲空間等資源計費，無需提前規劃硬件資源消耗。此模式適用于業務峰谷變化較大，不可預測的場景。

   重要

   實例規格在實例創建后無法修改，請謹慎選擇。

   單個阿里云賬戶最多可以創建10個實例，且在同一地域中實例名稱必須唯一。

   購買VCU模式實例

   1. 在VCU模式（原預留模式）頁簽，單擊前往購買，根據下表說明購買并配置表格存儲標準實例后，單擊立即購買。

      參數	描述
      商品類型	只支持VCU模式（預留模式）。
      地域	實例所屬地域。
      預留VCU	使用VCU模式（原預留模式）時，所有的計算資源均通過VCU進行定義。1 VCU相當于4核16 GB的處理能力。關于評估選型的更多信息，請參見資源預估選型。 根據預估資源，選擇購買的預留VCU個數。取值范圍為0~1000。 當預留VCU取值為0時，購買的實例無需預付費，但是您必須為實例開啟彈性能力。 為實例開啟彈性能力后，表格存儲會根據實際的VCU使用量收取費用。購買實例時，表格存儲會為實例配置默認彈性上限值。默認彈性上限值為Max(3*預留VCU， 5+預留VCU)。購買實例后，您可以在實例詳情頁調整實例彈性上限。具體操作，請參見如何調整實例的彈性上限？。 當預留VCU取值不為0時，購買的實例需要預付費，您還可以根據需要為實例開啟或關閉彈性能力。 如果未為實例開啟彈性能力，則后續在實例中進行操作時，最多只能使用預留VCU對應的計算資源。 您也可以在創建實例后為實例開啟彈性能力。具體操作，請參見如何為實例開啟彈性能力？。 如果為實例開啟了彈性能力，則后續在實例中進行操作時，最多能使用實例彈性上限對應的計算資源。 說明 您可以根據實際需要調整實例的彈性上限。具體操作，請參見如何調整實例的彈性上限？。 當實際業務中的計算資源消耗未超過預留VCU對應的計算資源時，表格存儲不會額外收取計算部分費用；當實際業務中的計算資源消耗超過預留VCU對應的計算資源時，表格存儲會按照實際使用的VCU彈性部分收取相應費用。
      彈性能力	是否為實例開啟彈性能力。取值范圍如下： 重要 當預留VCU配置為0時，您必須為實例開啟彈性能力。 啟用：為實例開啟彈性能力。開啟彈性能力后，實例彈性上限為彈性能力與預留VCU之和。您可以根據需要調整實例的彈性上限配置。具體操作，請參見如何調整實例的彈性上限？。 不啟用：不開啟彈性能力。業務最多可用的計算資源對應于購買的預留VCU。
      存儲類型	根據業務場景選擇合適的存儲類型。 容量型：適合寫多讀少、讀取延遲不敏感、海量數據低成本存儲場景。 高性能：適合對于讀取延遲敏感的業務，提供極低的延遲以及高穩定性保障。
      實例名稱	由系統自動生成，無需手動設置。
      實例別名	控制臺顯示的實例名稱。如果未設置，則實例別名和系統生成的實例名稱相同。
      實例描述	實例的描述信息，例如實例用途等。
      資源組	實例所屬資源組，默認值為默認資源組。如果已有資源組不滿足使用需求，您可以單擊創建資源組進行資源組創建。
      標簽	如果您有大量Tablestore實例，可以通過綁定標簽的方式，對實例進行分類管理。更多信息，請參見標簽概述。
      購買時長	購買實例的時長。

   2. 在確認訂單頁面，確認參數配置并仔細閱讀服務協議后，選中我已閱讀并同意表格存儲標準實例服務協議。

   3. 單擊去支付，根據系統提示完成訂單支付。

   4. 支付完成后，單擊管理控制臺，進入表格存儲控制臺界面。

   創建CU模式實例

   1. 在CU模式（原按量模式）頁簽，選擇資源組，輸入實例名稱，然后選擇實例規格，根據業務需求填寫實例注釋。

   2. 如果您有大量Tablestore實例，可以通過綁定標簽的方式，對實例進行分類管理。更多信息，請參見標簽概述。

   3. 如果要修改允許訪問實例的網絡類型或者允許來源，請打開高級選項開關并配置相應參數。

      參數	說明
      允許網絡	允許使用何種網絡類型訪問表格存儲資源，支持一次選擇多種網絡類型。取值范圍如下： VPC：是否支持通過VPC訪問。默認選中VPC，表示支持通過VPC訪問。 如果不需要通過VPC訪問，請取消選中VPC。 公網：是否支持通過互聯網訪問。默認選中公網，表示支持通過互聯網訪問。 如果不需要通過互聯網訪問，請取消選中公網。 經典網：是否支持通過經典網絡訪問。默認選中經典網，表示支持通過經典網絡訪問。 如果不需要通過經典網訪問，請取消選中經典網。
      允許來源	是否允許使用控制臺訪問表格存儲資源。默認選中可信網關(控制臺)，表示支持使用控制臺訪問。 如果不需要使用控制臺訪問，請取消選中可信網關(控制臺)。

   4. 單擊確定。

步驟三：創建數據表

創建數據表后，您可以在數據表中讀寫數據。創建數據表時，您可以根據業務需求同時創建二級索引用于讀取數據。

1. 在概覽頁面，單擊實例名稱或在操作列單擊實例管理。

2. 在實例詳情頁簽，單擊創建數據表。

   說明

   單個實例最多可以創建64張數據表。

3. 在創建數據表對話框，按照下表說明配置相關參數。

   參數	描述
   數據表名稱	數據表名稱，用于在實例中唯一標識一張數據表。 數據表的命名規則為由大小寫字母、數字或下劃線（_）組成，且只能以字母或下劃線（_）開頭，長度在1個~255個字節之間。
   表主鍵	表中的一列或多列，用于唯一標識表中的一條記錄。 輸入表主鍵名稱并選擇數據類型，單擊添加表主鍵，可加入新的主鍵。 單表最多可設置4個主鍵，第一個主鍵默認為分區鍵。主鍵的配置及順序設置后不能修改。 重要 表格存儲支持將主鍵列設置為自增列，每張表只能設置一個主鍵列為自增列，且分區鍵不能設置為自增列。 主鍵列設置為自增列后，在寫入一行數據時，該主鍵列無需填值，表格存儲會自動生成該主鍵列的值。自動生成的主鍵列的值在分區鍵內嚴格遞增且唯一。 表主鍵名稱的命名規則為由大小寫字母、數字或下劃線（_）組成，且只能以字母或下劃線（_）開頭，長度在1個~255個字節之間。 主鍵的數據類型可選為字符串、整型或二進制。
   是否允許更新	是否允許通過UpdateRow更新寫入數據。默認值為是，表示允許通過UpdateRow更新寫入數據。 當要使用多元索引生命周期功能時，您必須設置此參數為否，即不允許通過UpdateRow更新寫入數據。關于多元索引生命周期的更多信息，請參見生命周期管理。
   是否加密	是否開啟數據落盤加密。系統默認未開啟數據落盤加密功能。打開是否加密開關，即可開啟數據落盤加密功能。 重要 數據落盤加密功能開啟后不支持關閉，請謹慎操作。
   加密類型	數據的加密類型。只有打開是否加密開關時，需要配置該選項。取值范圍如下： kms服務主密鑰：表格存儲會自動創建KMS服務主密鑰用于數據落盤加解密。 BYOK自定義密鑰：表格存儲會基于您自定義的密鑰進行數據落盤加解密。 重要 使用BYOK自定義密鑰的加密類型前，您需要通過KMS控制臺創建軟件密鑰，然后創建自定義角色并配置權限。具體操作，請參見數據加密。
   密鑰ID	密鑰的ID。只有當加密類型選擇BYOK自定義密鑰時，需要配置該選項。
   ARN	角色ARN。只有當加密類型選擇BYOK自定義密鑰時，需要配置該選項。

4. （可選）在創建數據表對話框，進行高級配置或者創建二級索引。

   當需要對數據表設置數據生命周期等高級配置或者創建二級索引時，請執行此步驟。

   配置高級參數

   如果需要管理表中數據的保存時長，您可以指定數據生命周期；如果需要相同主鍵的多個版本數據，您可以指定最大版本數。更多信息，請參見數據版本和生命周期。

   對于按量模式下的高性能實例，如果要通過預留吞吐量節省成本，您可以指定數據表的預留讀吞吐量或寫吞吐量。更多信息，請參見預留讀/寫吞吐量。

   1. 打開高級設置開關。

   2. 根據下表說明配置高級參數。

      參數	描述
      數據生命周期	數據表中數據的保存時間。當數據的保存時間超過設置的數據生命周期時，系統會自動清理超過數據生命周期的數據。單位為秒。 取值：大于等于86400秒（一天）或-1（數據永不過期）。
      最大版本數	數據表中的屬性列能夠保留數據的最大版本個數。當屬性列數據的版本個數超過設置的最大版本數時，系統會自動刪除較早版本的數據。 取值必須為非0整數。
      數據有效版本偏差	指定的數據版本號與系統當前時間偏差的允許最大值，單位為秒。有效版本偏差為正整數，可以大于1970-01-01 00:00:00 UTC時間到當前時間的秒數。 只有當寫入數據所有列的版本號與寫入時時間的差值在數據有效版本偏差范圍內，數據才能成功寫入。 屬性列的有效版本范圍為[max{數據寫入時間-有效版本偏差,數據寫入時間-數據生命周期}，數據寫入時間+有效版本偏差)。
      預留讀吞吐量	容量型實例不支持該參數。 為數據表預留讀吞吐量或寫吞吐量。取值范圍為0~100000，且取值必須為整數。單位為CU。 當預留讀吞吐量或預留寫吞吐量大于0時，表格存儲會根據配置為數據表分配和預留相應資源，且數據表創建成功后，將會立即按照預留吞吐量開始計費。 當預留讀吞吐量或預留寫吞吐量為0時，表格存儲不會為數據表分配和預留相應資源。
      預留寫吞吐量

   配置二級索引

   當某些應用需要使用不同屬性作為查詢條件來執行數據查詢時，您可以通過將這些屬性作為二級索引的主鍵列實現按照屬性快速查詢數據的需求。更多信息，請參見二級索引介紹。

   1. 打開創建二級索引開關。

   2. 單擊添加預定義列，輸入預定義列名稱和選擇數據類型。

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

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

   3. 單擊添加二級索引，輸入索引名稱，選擇索引主鍵，根據需要選擇索引預定義列及索引類型。

      重要

      索引名不能與數據表名稱相同，索引名和數據表名稱均必須在實例中唯一。

      索引名稱必須由大小寫字母、數字或下劃線（_）組成，且只能以字母或下劃線（_）開頭，長度在1個~255個字節之間。

      • 索引主鍵可以是數據表主鍵和預定義列，支持多選；索引預定義列只能從數據表的預定義列中選擇，支持多選。但是選擇的索引預定義列不能與主鍵列重復。

      • 索引類型支持選擇為全局或者本地。

        重要

        全局二級索引的第一列主鍵可根據需要選擇任意主鍵列或者預定義列，本地二級索引的第一列主鍵必須和數據表的第一列主鍵相同。

        全局二級索引以異步方式將數據表中被索引的列和主鍵列的數據自動同步到索引表中，正常情況下同步延遲達到毫秒級別；本地二級索引以同步方式將數據表中被索引的列和主鍵列的數據自動同步到索引表中，當數據寫入數據表后，即可從索引表中查詢到數據。

5. 單擊確定。

   數據表創建完成后，在數據表列表區域，您可以查看已創建的數據表。如果新建的表未顯示在列表中，可單擊圖標，刷新數據表列表。

步驟四：讀寫數據

在數據表中寫入、更新、讀取或者刪除數據。

1. 在實例詳情頁簽的數據表列表區域，單擊數據表名稱后選擇數據管理頁簽或在操作列單擊查詢/搜索。

2. 根據需求進行數據讀寫。

   插入一行數據

   1. 在數據管理頁簽，單擊插入數據。

   2. 在插入數據對話框，輸入主鍵的值，單擊圖標，設置屬性列名稱、屬性列類型、屬性值和數據版本號。

      系統默認已選中使用系統時間復選框，采用當前系統時間作為數據版本號。您也可以清除使用系統時間復選框輸入數據版本號。

   3. 單擊確定。

   更新一行數據

   1. 在數據管理頁簽，選中需要更新的數據行，單擊更新數據。

   2. 在更新數據對話框，增加或刪除屬性列，更新或刪除屬性列的數據。

      • 單擊圖標，增加屬性列；單擊圖標，刪除屬性列。

      • 選擇更新操作為更新，修改屬性列的數據；選擇更新操作為刪除，選擇需要刪除的數據版本號，刪除對應數據版本號的數據；選擇更新操作為刪除全部，刪除全部數據版本號的數據。

   3. 單擊確定。

   讀取數據

   通過控制臺您可以讀取單行數據或者范圍讀取數據，請根據實際選擇。

   讀取單行數據

   1. 在數據管理頁簽，單擊查詢數據。

   2. 在查詢數據對話框，選擇查詢范圍為單行查詢，并選擇要查詢的表或者二級索引。

   3. 系統默認返回所有列。如需返回指定屬性列，關閉獲取所有列開關并輸入需要返回的屬性列，多個屬性列之間用半角逗號（,）隔開。

   4. 輸入目標行的主鍵值。

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

   5. 輸入最大版本數，指定需要返回的版本數。

   6. 單擊確定。

   范圍讀取數據

   1. 在數據管理頁簽，單擊查詢數據。

   2. 在查詢數據對話框，選擇查詢范圍為范圍查詢，并選擇要查詢的表或者二級索引。

   3. 系統默認返回所有列。如需返回指定屬性列，關閉獲取所有列開關并輸入需要返回的屬性列，多個屬性列之間用半角逗號（,）隔開。

   4. 輸入起始主鍵列和結束主鍵列。

   重要

   • 范圍查詢優先使用第一個主鍵值進行查詢，當設置的第一個主鍵值一致時，系統會使用第二個主鍵值進行查詢，其他主鍵的查詢規則同上。

   • 讀取范圍是前開后閉的區間。

   5. 輸入最大版本數，指定需要返回的版本數。

   6. 設置查詢結果的排序方向，可選正序查詢或逆序查詢。

   7. 單擊確定。

   刪除數據

   重要

   刪除表數據，將導致數據不可恢復，請謹慎操作。

   1. 在數據管理頁簽，選中需要刪除的數據行，單擊批量刪除。

   2. 在批量刪除對話框，單擊確定。

步驟五：使用SQL查詢數據

SQL查詢兼容MySQL的查詢語法，同時提供基礎的SQL DDL建表能力。對于已有數據表，通過執行CREATE TABLE一鍵自動建立映射關系后，您可以使用SQL方式訪問表中數據。更多信息，請參見SQL查詢。

1. 在概覽頁面，單擊實例名稱或在操作列單擊實例管理。

2. 在SQL查詢頁簽，創建映射關系。

   1. 單擊圖標。

      說明

      當不存在映射表時，單擊SQL查詢頁簽，系統會自動彈出創建映射表對話框。

      

   2. 在創建映射表對話框中，根據下表說明配置參數。

      參數	描述
      表類型	表類型。取值范圍如下： 普通表（默認）：在為數據表創建映射關系時，選擇此項。 時序表：在為時序表創建映射關系時，選擇此項。
      表名	表名稱。
      映射模式	創建映射關系的模式。只有當表類型選擇為普通表時才能配置。取值范圍如下： 表映射（默認）：為已存在的數據表創建映射關系。 多元索引映射：為已存在的多元索引創建映射關系。
      高級選項	用于配置映射表的一致性模式和是否使用不準確的聚合。打開高級選項開關，即可進行配置。只有當映射模式選擇為表映射時才能進行配置。
      一致性模式	執行引擎支持的一致性模式。只有打開了高級選項開關后才能配置。取值范圍如下： 最終一致（默認）：執行的查詢結果滿足最終一致。此時新數據寫入后會在幾秒后影響到查詢結果。 強一致性：執行的查詢結果滿足強一致性。此時新數據寫入后立刻影響到查詢結果。
      不準確的聚合	是否允許通過犧牲聚合操作的精準度提升查詢性能。只有打開了高級選項開關后才能配置。取值范圍如下： 是（默認）：允許通過犧牲聚合操作的精度來提升查詢性能。 否：不允許通過犧牲聚合操作的精度提升查詢性能
      多元索引表	映射表綁定的多元索引名稱。只有當映射模式選擇為多元索引映射時才能配置。
      映射表表名	映射表名稱。 如果表類型選擇為普通表，當映射模式選擇為表映射時，映射表表名與數據表名稱相同，不能更改；當映射模式選擇為多元索引映射時，需要填寫映射表名稱。 如果表類型選擇為時序表，請根據實際填寫映射表名稱。時序表映射關系創建成功后，系統會自動在映射表名前添加時序表名稱::前綴。
      使用分析存儲查詢	分析存儲功能主要用于時序數據長期存儲和分析場景。使用分析存儲（Analytical Store）功能，您可以低成本存儲時序數據以及快速查詢和分析時序數據。更多信息，請參見時序分析存儲概述。 只有當表類型選擇為時序表時才能配置。系統默認關閉使用分析存儲查詢開關，請根據實際業務場景進行相應配置。 如果不需要使用分析存儲來存儲與分析時序數據，使用分析存儲查詢保持默認配置即可。 如果需要低成本存儲時序數據以及快速查詢和分析時序數據，請確保已創建分析存儲并打開使用分析存儲查詢開關。 重要 如果創建了使用分析存儲查詢的SQL映射表，則在刪除分析存儲時，您需要同時刪除分析存儲SQL映射表。否則會導致刪除分析存儲失敗。

   3. 單擊生成SQL。

      系統會自動生成創建映射表的SQL語句。SQL示例如下：

      CREATE TABLE `exampletable` (
          `id` BIGINT(20),
          `colvalue` MEDIUMTEXT,
          `content` MEDIUMTEXT,
          PRIMARY KEY(`id`)
      );

      重要

      請確保映射關系中字段數據類型和數據表中字段數據類型相匹配。關于數據類型映射的更多信息，請參見SQL數據類型映射。

   4. 根據實際需要修改映射表的Schema后，按住鼠標左鍵拖動選中一條SQL語句并單擊執行SQL(F8)。

      執行成功后，在執行結果區域會顯示執行結果。

      重要

      • 創建映射表時設置的Schema中需要包括后續查詢數據所需的列。

      • 執行SQL語句時，請選中一條所需SQL語句，否則系統默認執行第一條SQL語句。

      • 執行SQL語句時，一次只能選中一條SQL語句，否則系統會報錯。

      

3. 執行SELECT語句查詢所需數據。更多信息，請參見查詢數據。

常見問題

• 表格存儲和傳統關系型數據庫（例如MySQL、SQL Server）有什么區別？

• 如何理解數據表的主鍵、數據分區和數據分區鍵

• 表格存儲寬表模型中表、行、列、值和電子表格的類比

相關文檔

• 您可以通過命令行工具快速體驗寬表模型。具體操作，請參見通過命令行工具使用寬表模型。

• 當要在實際業務中使用表格存儲時，請參見寬表模型介紹文檔了解產品的使用限制、使用流程等信息，并根據業務特點選擇合適的計費模式來節省使用成本。更多信息，請參見計費模式使用推薦。

• 如果要通過控制臺進行更多寬表模型的功能操作，請參見數據表操作、基礎數據操作、通過控制臺使用多元索引、通過控制臺使用二級索引、通過控制臺使用SQL查詢、通過控制臺使用通道服務、通過控制臺投遞數據到OSS、通過表格存儲控制臺查看監控數據文檔進行使用。

• 使用寬表模型可以實現元數據、大數據等多種場景的解決方案，例如搭建海量智能元數據管理系統、億量級訂單管理方案、基于多元索引搭建億量級店鋪搜索系統、表格存儲結合Spark流批處理實現一體化存儲和計算、表格存儲結合實時計算Flink進行大數據分析。更多方案介紹，請參見場景實戰-典型場景架構與實現。