Todos os produtos
Search
Central de documentação

Tablestore:Criar uma tabela de mapeamento

Última atualização: Jun 23, 2026

Execute a instrução CREATE TABLE para criar uma tabela de mapeamento para uma tabela ou índice de pesquisa existente. Ao criar uma tabela de mapeamento, especifique os nomes e tipos dos campos, as informações de chave primária e o mecanismo de execução para consultas de dados com base nos requisitos de negócios.

Pré-requisitos

Parâmetros

Parâmetro

Descrição

query

A instrução SQL. Configure este parâmetro com base no recurso necessário.

Exemplos

O exemplo a seguir usa a instrução create table test_table (pk varchar(1024), long_value bigint, double_value double, string_value mediumtext, bool_value bool, primary key(pk)) para criar uma tabela de mapeamento para a tabela test_table.

def create_mapping_table(client):
    query = 'create table test_table (pk varchar(1024), long_value bigint, double_value double, string_value mediumtext, bool_value bool, primary key(pk))'
    client.exe_sql_query(query)

FAQ

O que fazer se a mensagem de erro "Table 'instancename.tablename' doesn't exist ?" for retornada ao criar uma tabela de mapeamento?

  • Causa possível

    A tabela para a qual você deseja criar uma tabela de mapeamento não existe.

  • Solução

    A instrução CREATE TABLE em SQL cria uma tabela de mapeamento apenas para uma tabela ou índice de pesquisa existente. Verifique se a tabela ou o índice de pesquisa para o qual deseja criar uma tabela de mapeamento existe.

O que fazer se a mensagem de erro "Table 'instancename.tablename' already exist?" for retornada ao criar uma tabela de mapeamento?

  • Causa possível

    Já existe uma tabela de mapeamento para a tabela.

    • O usuário criou manualmente uma tabela de mapeamento para a tabela.

    • O Tablestore criou automaticamente uma tabela de mapeamento para a tabela. Ao usar instruções SQL (como DESCRIBE, SELECT, etc.) diretamente para consultar dados em uma tabela de dados sem criar uma tabela de mapeamento, o Tablestore cria automaticamente uma tabela de mapeamento. A tabela de mapeamento criada automaticamente contém apenas as colunas de chave primária e as colunas predefinidas da tabela de dados. Não é possível atualizar as colunas de atributo dessa tabela de mapeamento.

  • Solução

    Execute a instrução DESCRIBE para consultar o esquema da tabela de mapeamento. Se o esquema não atender aos requisitos de negócios, você pode atualizar as colunas de atributo da tabela de mapeamento. Se a tabela de mapeamento foi criada automaticamente pelo Tablestore, não é possível atualizar as colunas de atributo. Nesse caso, exclua a tabela de mapeamento e crie uma nova, desde que tenha certeza de que os negócios não serão afetados após a exclusão.

null

Para erros comuns e soluções do recurso de consulta SQL, consulte Solucionar erros comuns de consulta SQL.

Referências