Todos os produtos
Search
Central de documentação

Tablestore:Get started with the wide column model

Última atualização: Jul 03, 2026

O modelo Wide Column assemelha-se ao modelo de dados do Bigtable ou HBase e atende a diversos cenários, como armazenamento de metadados e big data. Uma única tabela de dados comporta volumes na escala de petabytes e suporta dezenas de milhões de consultas por segundo (QPS). Este tópico descreve como usar o modelo Wide Column no console do Tablestore.

Importante

Para obter informações sobre como iniciar o uso do modelo Wide Column pela CLI do Tablestore, consulte Primeiros passos com o modelo Wide Column.

Pré-requisitos

Tablestore ativado e uma instância criada. Para mais detalhes, consulte Ativar o Tablestore e criar uma instância.

Procedimento

Etapa 1: Criar uma tabela de dados

Crie uma tabela de dados para armazenar informações relacionadas ao negócio.

Para informações sobre cenários de exemplo e esquemas de tabelas, consulte Cenários de exemplo .
  1. Acesse a página Instance Management.

    1. Faça login no console do Tablestore.

    2. Na barra de navegação superior, selecione um grupo de recursos e uma região.

    3. Na página Overview, clique em nome da instância ou em Instance Management na coluna Actions.

  2. Na aba Instance Details, clique em Create Table.

  3. Na caixa de diálogo Create Table, defina Table Name como order e configure a chave primária.

    image

  4. Clique em Create.

    Após criar a tabela de dados, visualize-a na seção Tables. Caso a nova tabela não apareça, clique em ícone fig_tablestore_002 para atualizar a lista de tabelas.

Etapa 2: Ler e gravar dados

Na aba Instance Details, na seção Tables, clique em Query na coluna Actions da tabela de dados. Em seguida, leia e grave dados na página Query Data.

Inserir uma única linha de dados

Para inserir várias linhas de dados, repita as etapas quantas vezes forem necessárias.

  1. Na aba Query Data, clique em Insert.

  2. Na caixa de diálogo Insert, insira os valores da chave primária. Clique em Add Column repetidamente e defina Name, Type e Value para cada coluna de atributo.

    image

  3. Clique em OK.

Atualizar uma única linha de dados

Atualize os dados de uma linha existente. Neste exemplo, o status pós-venda de um pedido é atualizado e adiciona-se uma nova coluna de atributo chamada comments. A coluna de atributo comments é do tipo String.

  1. Na aba Query Data, selecione a linha desejada e clique em Update.

  2. Na caixa de diálogo Update, faça as alterações necessárias.

    1. Adicionar uma coluna de atributo: Clique em Add Column, defina Name como comments, configure Type como STRING e defina um Value conforme necessário.

    2. Atualizar uma coluna de atributo: Defina a operação como Update e modifique o valor da coluna de atributo order_status.

    image

  3. Clique em OK.

Ler dados

No console do Tablestore, leia uma única linha de dados ou um conjunto de dados cujo valor de chave primária esteja dentro de um intervalo específico, conforme a necessidade do seu negócio.

Execute instruções SQL para consultar e analisar dados na tabela. Para mais informações, consulte Consulta SQL .

Ler dados com valor de chave primária em um intervalo específico

  1. Na aba Query Data, clique em Search.

  2. Na caixa de diálogo Search, defina Mode como Range Search.

  3. Por padrão, todas as colunas são retornadas. Para retornar apenas colunas de atributo específicas, desative a opção Get All Columns e insira os nomes das colunas separados por vírgulas.

  4. Especifique os parâmetros Start Primary Key Column e End Primary Key Column para cada coluna de chave primária e mantenha as configurações padrão para os demais parâmetros.

    Nota
    • Ao definir Mode como Range Search, o intervalo especificado pelos valores inicial e final na coluna de chave primária à direita só terá efeito se os valores inicial e final forem idênticos em cada coluna de chave primária mais à esquerda. Se os valores inicial e final divergirem em uma coluna de chave primária mais à esquerda, o intervalo definido na coluna à direita não será aplicado.

    • O intervalo é aberto à esquerda e fechado à direita.

    image

  5. Clique em OK.

    O sistema exibe a linha que atende aos critérios de consulta. Se nenhuma linha corresponder aos critérios, a resposta será vazia.

Ler uma única linha de dados

  1. Na aba Query Data, clique em Search.

  2. Na caixa de diálogo Search, defina Mode como Get Row.

  3. Por padrão, todas as colunas são retornadas. Para retornar apenas colunas de atributo específicas, desative a opção Get All Columns e insira os nomes das colunas separados por vírgulas.

  4. Insira o Value da chave primária da linha alvo. Mantenha os demais parâmetros com seus valores padrão.

    A integridade e a precisão do valor da chave primária afetam diretamente os resultados da consulta.

    image

  5. Clique em OK.

    O sistema exibe a linha que atende aos critérios de consulta. Se nenhuma linha corresponder aos critérios, a resposta será vazia.

Excluir dados

Importante

Os dados excluídos não podem ser restaurados. Proceda com cautela.

  1. Na aba Query Data, selecione as linhas que deseja excluir e clique em Delete.

  2. Na caixa de diálogo Delete, clique em OK.

Cenários de exemplo

Sistemas de pedidos são extremamente comuns em diversos setores hoje em dia. Plataformas de e-commerce os utilizam para armazenar pedidos, bancos para guardar registros de transações e operadoras de telecomunicações para manter faturas. Neste exemplo, usamos uma tabela de pedidos para demonstrar como criar uma tabela de dados, além de ler e gravar informações nela. O nome da tabela é order. A tabela a seguir descreve o esquema dessa estrutura.

Nome da coluna

Tipo de dado

Descrição

order_id (coluna de chave primária)

String

ID do pedido. Neste exemplo, aplica-se hashing pelo algoritmo de geração de ID do pedido para evitar pontos de acesso (hotspots) de dados.

user_id

String

ID do cliente.

sku_id

String

ID do produto.

price

Double

Preço de compra do produto.

num

Integer

Quantidade de produtos adquiridos.

total_price

Double

Valor total do pedido.

order_status

String

Status do pedido.

create_time

String

Momento de criação do pedido. O valor corresponde a um carimbo de data/hora de 64 bits em milissegundos.

modified_time

String

Momento da última modificação do pedido.

Perguntas frequentes

Referências