Todos os produtos
Search
Central de documentação

Tablestore:Criar uma tabela de mapeamento

Última atualização: Jul 03, 2026

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

Observações de uso

O Tablestore SDK for .NET V5.0.0 e versões posteriores oferecem suporte a consultas SQL. Certifique-se de instalar uma versão compatível do SDK.

Para mais informações, consulte Histórico de versões do Tablestore SDK for .NET .

Pré-requisitos

Parâmetros

Parâmetro

Descrição

query

Instrução SQL. Configure este parâmetro de acordo com o recurso necessário.

Exemplos

Nota

Este tópico descreve como criar uma tabela de mapeamento de uma tabela. Para criar uma tabela de mapeamento de um índice de pesquisa, substitua a instrução SQL no código de exemplo pela instrução correspondente à criação de tabelas de mapeamento para índices de pesquisa.

O exemplo a seguir usa a instrução CREATE TABLE para criar uma tabela de mapeamento da tabela test_table.

/// <summary>
/// Create a mapping table for a data table.
/// </summary>
/// <param name="otsClient"></param>
public static void CreateMappingTable(OTSClient otsClient)
{
    string sqlCommand = @"CREATE TABLE `test_table` (
        `pk0` VARCHAR(1024),
        `pk1` BIGINT(20),
        `col0` MEDIUMTEXT,
        `col1` BIGINT(20),
        `col2` DOUBLE,
        `col3` BOOL,
        `col4` MEDIUMBLOB,
        `date_col` MEDIUMTEXT,
        `geo_col` MEDIUMTEXT,
        `col0_v1` MEDIUMTEXT,
        `col0_v2` MEDIUMTEXT,
        PRIMARY KEY(`pk0`,`pk1`)
    );";

    SQLQueryRequest sqlQueryRequest = new SQLQueryRequest(sqlCommand);

    SQLQueryResponse sqlQueryResponse = otsClient.SQLQuery(sqlQueryRequest);
}

Perguntas frequentes

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 de destino da tabela de mapeamento não existe.

  • Solução

    A instrução CREATE TABLE em SQL cria tabelas de mapeamento apenas para tabelas ou índices de pesquisa existentes. Verifique se a tabela ou o índice de pesquisa de destino 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 essa tabela.

    • Criação manual da tabela de mapeamento pelo usuário.

    • Criação automática da tabela de mapeamento pelo Tablestore. O uso direto de instruções SQL (como DESCRIBE ou SELECT) para consultar dados sem uma tabela de mapeamento prévia aciona a criação automática dessa tabela pelo Tablestore. A tabela gerada automaticamente contém apenas as colunas de chave primária e as colunas predefinidas da tabela de dados, e não permite a atualização das colunas de atributo.

  • Solução

    Execute a instrução DESCRIBE para consultar o esquema da tabela de mapeamento. Se o esquema não atender aos requisitos do negócio, atualize as colunas de atributo da tabela de mapeamento. Caso o Tablestore tenha criado a tabela automaticamente, a atualização das colunas de atributo não é possível. Nesse cenário, exclua a tabela de mapeamento e crie uma nova, desde que a exclusão não afete o negócio.

Nota

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

Referências