Todos os produtos
Search

Este produto

    Tablestore:Get started with the wide column model

    Central de documentação

    Tablestore:Get started with the wide column model

    Última atualização: Jul 29, 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 armazena volumes na casa dos 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 começar a usar o modelo Wide Column com a CLI do Tablestore, consulte Get started with the Wide Column model.

    Pré-requisitos

    Tablestore ativado e instância criada. Para mais informações, consulte Activate Tablestore and create an instance.

    Procedimento

    Etapa 1: Criar uma tabela de dados

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

    Para obter informações sobre cenários de exemplo e esquemas de tabelas, consulte Sample scenarios .

    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 no 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.

      Defina o nome da coluna de chave primária como order_id, o tipo como String e configure-a como Partition Key. Mantenha as demais opções com os valores padrão e clique em Create.

    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 no í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 quantas vezes for necessário e defina Name, Type e Value para cada coluna de atributo.

      Neste exemplo, a chave primária order_id (String) está definida como 3a0ab074-ea98-11ef-821b-00163e184c56. As colunas de atributo têm a seguinte configuração:

      • user_id (String): 1000000096

      • sku_id (String): 9000000002

      • price (Double): 400.00

      • num (Integer): 43

      • total_price (Double): 17200.00

      • order_status (String): closed

      • create_time (String): 2025-01-09 13:4

      • modified_time (String): 2025-01-09 13:4

    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, 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, defina Type como STRING e especifique 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.

      Por exemplo, altere o valor de order_status para refunded e defina o valor de comments como Returned item received.

    3. Clique em OK.

    Ler dados

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

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

    Ler dados cujo valor de chave primária está dentro de 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 colunas de atributo específicas, desative a opção 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

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

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

      Defina a coluna de chave primária inicial como INF_MIN e a coluna de chave primária final como INF_MAX.

    5. Clique em OK.

      O sistema exibe a linha que atende às condições da 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 colunas de atributo específicas, desative a opção All Columns e insira os nomes das colunas separados por vírgulas.

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

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

      Na caixa de diálogo Search, defina Mode como Get Row e configure Table/Secondary Index como order.

    5. Clique em OK.

      O sistema exibe a linha que atende às condições da 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 arquivar 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 por meio do algoritmo de geração de ID do pedido para evitar pontos de acesso (hotspots) nos dados.

    user_id

    String

    ID do cliente.

    sku_id

    String

    ID do product.

    price

    Double

    Preço unitário do product.

    num

    Integer

    Quantidade de products adquiridos.

    total_price

    Double

    Valor total do pedido.

    order_status

    String

    Status atual do pedido.

    create_time

    String

    Momento de criação do pedido. O valor corresponde a um timestamp de 64 bits em milissegundos.

    modified_time

    String

    Momento da última modificação do pedido.

    Perguntas frequentes

    Referências

    • Use índices secundários ou índices de busca para acelerar as consultas de dados. Para mais informações, consulte Secondary index e Search index.