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: Aug 20, 2026

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

    Pré-requisitos

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

    • Uma tabela de dados

    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, no ícone de adição na árvore à esquerda para abrir a caixa de diálogo Create Mapping Table.

      Nota

      Se não existir 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 DDL operations.

    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 um 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 quando Mapping Mode estiver definido como 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. Troca precisão por melhor desempenho.) ou No.

      Search Index Name

      Aplicável apenas se Mapping Mode for 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 quando 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 menor custo.

      Importante

      Se você criou uma tabela de mapeamento SQL com Enable Analytical Store ativado, 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.

      • Certifique-se de que os tipos de dados no mapeamento correspondam aos tipos de dados na tabela de dados. Para mais informações sobre mapeamentos de tipos de dados, consulte Data type mapping.

    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 uma tabela de mapeamento, execute instruções SELECT na aba Query by Executing SQL Statement. Para mais informações sobre a sintaxe SQL, consulte DQL statements.

    Exemplo: consulte 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 resultados, clique em Data Export. É possível exportar até 2.000 linhas como arquivo CSV.

    Referências