Todos os produtos
Search

Este produto

    Tablestore:Use SQL queries in the Tablestore console

    Central de documentação

    Tablestore:Use SQL queries in the Tablestore console

    Última atualização: Jul 03, 2026

    Crie tabelas de mapeamento SQL, execute instruções SQL e exporte resultados de consultas no console do Tablestore para validação e consultas de dados em pequena escala.

    Pré-requisitos

    • Se utilizar um usuário RAM, conceda a permissão "Action": "ots:SQL*".

    • Uma tabela de dados criada.

    Etapa 1: Criar uma tabela de mapeamento

    1. Faça login no console do Tablestore. Alterne a região e o grupo de recursos na parte superior da página conforme necessário.

    2. Na página Overview, clique em no nome da instância ou em Instances.

    3. Clique em na aba Query by Executing SQL Statement e, em seguida, clique em no ícone de adição na árvore à esquerda para abrir a caixa de diálogo Create Mapping Table.

      Nota

      Caso não exista nenhuma tabela de mapeamento, a caixa de diálogo Create Mapping Table será exibida automaticamente. Como alternativa, crie uma tabela de mapeamento com uma instrução CREATE TABLE no editor SQL. Para mais informações, consulte Operações DDL.

    4. Configure os seguintes parâmetros na caixa de diálogo.

      Parâmetro

      Descrição

      Table Type

      Valores válidos:

      • Common Table (Padrão): cria um mapeamento para uma tabela de dados.

      • Time Series Table: cria um mapeamento para uma tabela de séries temporais.

      Table Name

      Selecione a tabela de dados ou de séries temporais para a qual deseja criar o mapeamento.

      Mapping Mode

      Este parâmetro está disponível apenas quando Table Type estiver definido como Common Table. Valores válidos:

      • Mapping Table for Table (Padrão): cria um mapeamento para uma tabela de dados existente.

      • Mapping Table for Search Index: cria um mapeamento para um índice de pesquisa existente.

      Advanced Settings

      Disponível somente se Mapping Mode for Mapping Table for Table. Ative esta opção para definir as configurações abaixo:

      • Consistency Mode: Eventual Consistency (Padrão. Novos dados tornam-se consultáveis em segundos.) ou Strong Consistency (Novos dados tornam-se consultáveis imediatamente.).

      • Inaccurate Aggregation: Yes (Padrão. Prioriza o desempenho em detrimento da precisão.) ou No.

      Search Index Name

      Aplicável apenas quando Mapping Mode estiver definido como Mapping Table for Search Index. Selecione o índice de pesquisa a ser vinculado à tabela de mapeamento.

      Mapping Table Name

      Nome da tabela de mapeamento. No modo de mapeamento de tabela, o nome corresponde ao da tabela de dados e não pode ser alterado. Nos modos de mapeamento de índice de pesquisa ou tabela de séries temporais, insira um nome personalizado.

      Enable Analytical Store

      Visível apenas se Table Type for Time Series Table. Ative esta opção para usar o Analytical store para armazenar e analisar dados de séries temporais com custo reduzido.

      Importante

      Ao criar uma tabela de mapeamento SQL com a opção Enable Analytical Store ativada, exclua a tabela de mapeamento SQL do analytical store antes de excluir o próprio analytical store. Caso contrário, a exclusão falhará.

    5. Clique em Next: Generate SQL Statement.

      A instrução SQL para criar a tabela de mapeamento é gerada automaticamente. Exemplo:

      CREATE TABLE `test_table` (
    `pk1` VARCHAR(1024),
    `pk2` BIGINT(20),
    `col_a` BIGINT(20),
    `col_b` BIGINT(20),
    `col_c` MEDIUMTEXT,
    `col_d` MEDIUMTEXT,
    PRIMARY KEY(`pk1`, `pk2`)
);
      Nota

      • O esquema deve incluir todas as colunas que você planeja consultar.

      • Verifique se os tipos de dados no mapeamento correspondem aos tipos de dados na tabela de dados. Para mais informações sobre mapeamentos de tipos de dados, consulte Mapeamento de tipos de dados.

    6. Modifique o esquema da tabela de mapeamento conforme necessário, selecione a instrução SQL e clique em Execute SQL Statement.

      Após a execução da instrução, o resultado aparece na seção Execution Result.

      Nota

      É possível selecionar e executar apenas uma instrução SQL por vez. Se nenhuma instrução for selecionada, a primeira será executada por padrão.

    Etapa 2: Consultar dados

    Após criar a tabela de mapeamento, execute instruções SELECT na aba Query by Executing SQL Statement. Para mais detalhes sobre a sintaxe SQL, consulte Instruções DQL.

    Exemplo: consultar as três primeiras linhas de test_table.

    SELECT * FROM test_table LIMIT 3;

    Saída de exemplo:

    +------+-----+-------+-------+--------+--------+
| pk1  | pk2 | col_a | col_b | col_c  | col_d  |
+------+-----+-------+-------+--------+--------+
| row1 |   1 |    10 |   100 | apple  | extra1 |
| row2 |   2 |    20 |   200 | banana | extra2 |
| row3 |   3 |    30 |   300 | apple  | extra3 |
+------+-----+-------+-------+--------+--------+
3 Rows

    Para exportar os resultados, clique em Data Export. É possível exportar até 2.000 linhas como arquivo CSV.

    Referências