Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Como solucionar erros da linguagem de definição de dados no Amazon Keyspaces

Modo de foco

Nesta página

Como solucionar erros da linguagem de definição de dados no Amazon Keyspaces - Amazon Keyspaces (para Apache Cassandra)

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Está tendo problemas para criar recursos? Aqui estão alguns problemas comuns e como resolvê-los.

Erros de linguagem de definição de dados

O Amazon Keyspaces executa operações de linguagem de definição de dados (DDL) de forma assíncrona, por exemplo, criando e excluindo espaços chave e tabelas. Se um aplicativo estiver tentando usar o recurso antes de estar pronto, a operação falhará.

Você pode monitorar o status de criação de novos espaços de chave e tabelas no AWS Management Console, o que indica quando um espaço de teclas ou tabela está pendente ou ativo. Você também pode monitorar programaticamente o status de criação de um novo espaço de chaves ou tabela consultando a tabela do esquema do sistema. Um espaço de chaves ou tabela fica visível no esquema do sistema quando está pronto para uso.

nota

Para otimizar a criação de espaços de chave usando AWS CloudFormation, você pode usar esse utilitário para converter CQL scripts em CloudFormation modelos. A ferramenta está disponível no GitHub repositório.

Eu criei um espaço de chaves, mas não consigo visualizá-lo nem o acessar

Você está recebendo erros do seu aplicativo que está tentando acessar um novo espaço de chaves.

Se você tentar acessar um espaço de chaves recém-criado do Amazon Keyspaces que ainda está sendo criado de forma assíncrona, você receberá um erro. Veja a seguir um exemplo de log de erros.

InvalidRequest: Error from server: code=2200 [Invalid query] message="unconfigured keyspace mykeyspace"

O padrão de design recomendado para verificar quando um novo espaço de chaves está pronto para uso é pesquisar as tabelas de esquema do sistema do Amazon Keyspaces (system_schema_mcs.*).

Para obter mais informações, consulte Verifique o status de criação do keyspace no Amazon Keyspaces.

Eu criei uma nova tabela, mas não consigo visualizá-la nem a acessar

Você está recebendo erros do seu aplicativo que está tentando acessar uma nova tabela.

Se você tentar acessar uma tabela recém-criada do Amazon Keyspaces que ainda está sendo criado de forma assíncrona, você receberá um erro. Por exemplo, tentar consultar uma tabela que ainda não está disponível falha com um erro unconfigured table.

InvalidRequest: Error from server: code=2200 [Invalid query] message="unconfigured table mykeyspace.mytable"

Tentando ver a tabela com falhas sync_table() com um KeyError.

KeyError: 'mytable'

O padrão de design recomendado para verificar quando uma nova tabela está pronta para uso é pesquisar as tabelas de esquema do sistema do Amazon Keyspaces (system_schema_mcs.*).

Esse é o exemplo de saída de uma tabela que está sendo criada.

user-at-123@cqlsh:system_schema_mcs> select table_name,status from system_schema_mcs.tables where keyspace_name='example_keyspace' and table_name='example_table'; table_name | status ------------+---------- example_table | CREATING (1 rows)

Esse é o exemplo de saída de uma tabela que está ativa.

user-at-123@cqlsh:system_schema_mcs> select table_name,status from system_schema_mcs.tables where keyspace_name='example_keyspace' and table_name='example_table'; table_name | status ------------+---------- example_table | ACTIVE (1 rows)

Para obter mais informações, consulte Verifique o status de criação da tabela no Amazon Keyspaces.

Estou tentando restaurar uma tabela usando o Amazon Keyspaces point-in-time recovery (PITR), mas a restauração falha

Se você está tentando restaurar uma tabela do Amazon Keyspaces com point-in-time recovery (PITR) e vê o processo de restauração começar, mas não ser concluído com sucesso, talvez você não tenha configurado todas as permissões necessárias para o processo de restauração dessa tabela específica.

Além das permissões de usuário, o Amazon Keyspaces pode exigir permissões para realizar ações durante o processo de restauração em nome da sua entidade principal. Esse é o caso se a tabela for criptografada com uma chave gerenciada pelo cliente ou se você estiver usando IAM políticas que restringem o tráfego de entrada.

Por exemplo, se você estiver usando chaves de condição em sua IAM política para restringir o tráfego de origem a endpoints ou intervalos de IP específicos, a operação de restauração falhará. Para permitir que o Amazon Keyspaces execute a operação de restauração da tabela em nome do seu diretor, você deve adicionar uma chave de condição aws:ViaAWSService global na IAM política.

Para obter mais informações sobre as permissões para restaurar tabelas, consulte Configurar permissões do IAM da tabela de restauração para o PITR do Amazon Keyspaces.

Estou tentando usarINSERT/UPDATEpara editar configurações personalizadas de Time to Live (TTL), mas a operação falha

Se você estiver tentando inserir ou atualizar um TTL valor personalizado, a operação poderá falhar com o seguinte erro.

TTL is not yet supported.

Para especificar TTL valores personalizados para linhas ou colunas usando nossas INSERT UPDATE operações, você deve primeiro habilitar TTL para a tabela. Você pode habilitar TTL para uma tabela usando a propriedade ttl personalizada.

Para obter mais informações sobre como habilitar TTL configurações personalizadas para tabelas, consulteAtualizar tabela com vida útil (TTL) personalizada.

Estou tentando fazer o carregamento de dados para minha tabela do Amazon Keyspaces e recebo um erro sobre exceder o número de colunas

Você está carregando dados e excedeu o número de colunas que podem ser atualizadas simultaneamente.

Esse erro ocorre quando o esquema da sua tabela excede o tamanho máximo de 350 KB. Para obter mais informações, consulte Cotas para Amazon Keyspaces (para Apache Cassandra).

Estou tentando excluir dados na minha tabela do Amazon Keyspaces e a exclusão falha no intervalo

Você está tentando excluir dados por chave de partição e recebe um erro de exclusão de intervalo.

Esse erro ocorre quando você está tentando excluir mais de 1.000 linhas em uma operação de exclusão.

Range delete requests are limited by the amount of items that can be deleted in a single range.

Para obter mais informações, consulte Intervalo de exclusão.

Para excluir mais de 1.000 linhas em uma única partição, considere as opções a seguir.

  • Excluir por partição – Se a maioria das partições tiver menos de 1.000 linhas, você poderá tentar excluir dados por partição. Se as partições contiverem mais de 1.000 linhas, tente excluí-las usando a coluna de clustering.

  • Excluir por coluna de clustering – Se seu modelo contiver várias colunas de clustering, você poderá usar a hierarquia de colunas para excluir várias linhas. As colunas de clustering são uma estrutura aninhada, e você pode excluir muitas linhas operando na coluna de nível superior.

  • Excluir por linha individual – Você pode iterar pelas linhas e excluir cada linha usando sua chave primária completa (colunas de partição e colunas de clustering).

  • Como melhor prática, considere dividir suas linhas em partições — No Amazon Keyspaces, recomendamos que você distribua seu throughput entre as partições da tabela. Isso distribui os dados e o acesso uniformemente entre os recursos físicos, o que proporciona melhor throughput. Para obter mais informações, consulte Melhores práticas de modelagem de dados: recomendações para projetar modelos de dados.

Considere também as recomendações a seguir ao planejar operações de exclusão para workload pesadas.

  • Com o Amazon Keyspaces, as partições podem conter um número praticamente ilimitado de linhas. Isso permite que você escale partições de forma “mais ampla” do que a orientação tradicional do Cassandra de 100 MB. Não é incomum que séries temporais ou livros contábeis cresçam mais de um gigabyte de dados ao longo do tempo.

  • Com o Amazon Keyspaces, não há estratégias de compactação ou marcas de exclusão a serem consideradas quando você precisa realizar operações de exclusão para workloads pesadas. Você pode excluir quantos dados quiser sem afetar o desempenho de leitura.

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.