Solução de problemas

Depois que o upload dos dados for concluído, verifique se as linhas foram ignoradas. Para fazer isso, navegue até o diretório de origem do CSV arquivo de origem e pesquise um arquivo com o nome a seguir.

import_yourcsvfilename.err.timestamp.csv

O cqlsh grava todas as linhas de dados ignoradas em um arquivo com esse nome. Se o arquivo existir em seu diretório de origem e tiver dados nele, essas linhas não foram carregadas no Amazon Keyspaces. Para repetir essas linhas, primeiro verifique se há erros encontrados durante o upload e ajuste os dados adequadamente. Para repetir essas linhas, você pode executar o processo novamente.

Erros comuns

Os motivos mais comuns pelos quais as linhas não são carregadas são erros de capacidade e erros de análise.

Erros de solicitação inválidos ao fazer o upload de dados para o Amazon Keyspaces

No exemplo a seguir, a tabela de origem contém uma coluna de contador, que resulta em chamadas em lote registradas do comando cqlsh COPY. As chamadas em lote registradas não são compatíveis com o Amazon Keyspaces.

Failed to import 10 rows: InvalidRequest - Error from server: code=2200 [Invalid query] message=“Only UNLOGGED Batches are supported at this time.“,  will retry later, attempt 22 of 25

Para resolver esse erro, use DSBulk para migrar os dados. Para obter mais informações, consulte Tutorial: Carregando dados no Amazon Keyspaces usando DSBulk.

Erros do analisador ao fazer o upload de dados para o Amazon Keyspaces

O exemplo a seguir mostra uma linha ignorada devido a ParseError.

Failed to import 1 rows: ParseError - Invalid ... – 

Para resolver esse erro, você precisa garantir que os dados a serem importados correspondam ao esquema da tabela no Amazon Keyspaces. Verifique se há erros de análise no arquivo de importação. Você pode tentar usar uma única linha de dados usando uma instrução INSERT para isolar o erro.

Erros de capacidade ao fazer o upload de dados para o Amazon Keyspaces

Failed to import 1 rows: WriteTimeout - Error from server: code=1100 [Coordinator node timed out waiting for replica nodes' responses]
 message="Operation timed out - received only 0 responses." info={'received_responses': 0, 'required_responses': 2, 'write_type': 'SIMPLE', 'consistency': 
 'LOCAL_QUORUM'}, will retry later, attempt 1 of 100

O Amazon Keyspaces usa as exceções ReadTimeout e WriteTimeout para indicar quando uma solicitação de gravação falha devido à capacidade de throughput insuficiente. Para ajudar a diagnosticar exceções de capacidade insuficiente, o Amazon Keyspaces publica WriteThrottleEvents uma métrica na Amazon. ReadThrottledEvents CloudWatch Para obter mais informações, consulte Monitorando o Amazon Keyspaces com a Amazon CloudWatch.

Erros de cqlsh ao fazer upload de dados para o Amazon Keyspaces

Para ajudar a solucionar erros de cqlsh, execute novamente o comando com falha com o sinalizador --debug.

Ao usar uma versão incompatível do cqlsh, você vê o seguinte erro.

AttributeError: 'NoneType' object has no attribute 'is_up'
Failed to import 3 rows: AttributeError - 'NoneType' object has no attribute 'is_up',  given up after 1 attempts

Confirme se a versão correta do cqlsh foi instalada executando o comando a seguir.

cqlsh --version

Você deve ver algo parecido com a saída a seguir.

cqlsh 5.0.1

Se estiver usando o Windows, substitua todas as instâncias de cqlsh por cqlsh.bat. Por exemplo, para verificar a versão do cqlsh no Windows, execute o comando a seguir.

cqlsh.bat --version

A conexão com o Amazon Keyspaces falha depois que o cliente cqlsh recebe três erros consecutivos de qualquer tipo do servidor. O cliente cqlsh falha com a seguinte mensagem.

Failed to import 1 rows: NoHostAvailable - , will retry later, attempt 3 of 100

Para resolver esse erro, você precisa garantir que os dados a serem importados correspondam ao esquema da tabela no Amazon Keyspaces. Verifique se há erros de análise no arquivo de importação. Você pode tentar usar uma única linha de dados usando uma INSERT instrução para isolar o erro.

O cliente tenta automaticamente restabelecer a conexão.