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.
Para mais informações, consulte Criar uma tabela de mapeamento para uma tabela e Criar tabelas de mapeamento para índices de pesquisa.
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
Cliente inicializado. Para mais informações, consulte Inicializar um cliente Tablestore.
-
Para criar uma tabela de mapeamento de um índice de pesquisa, primeiro crie o índice de pesquisa.
Parâmetros
|
Parâmetro |
Descrição |
|
query |
Instrução SQL. Configure este parâmetro de acordo com o recurso necessário. |
Exemplos
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
DESCRIBEpara 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.
Para erros comuns e soluções relacionados ao recurso de consulta SQL, consulte Solucionar erros comuns de consulta SQL.
Referências
Após criar uma tabela de mapeamento, atualize as colunas de atributo, consulte informações sobre a tabela, liste os nomes das tabelas de mapeamento, verifique as informações de índice ou exclua a tabela. Para mais detalhes, consulte Atualizar colunas de atributo de uma tabela de mapeamento, Consultar informações sobre uma tabela, Consultar os nomes das tabelas de mapeamento, Consultar informações de índice sobre uma tabela e Excluir uma tabela de mapeamento.
Use a instrução SELECT para consultar e analisar dados em uma tabela de mapeamento. Para mais informações, consulte Consultar dados.