TROUBLESHOOTING / 05

Resolver problemas de conexão e operação

Servidor inacessível, autenticação recusada ou célula não editável? Identifique a etapa da falha e siga as verificações do Cuvel SQL.

Windows / Interface de referência: Cuvel SQL 1.0.2

Identificar a etapa da falha

Diferencie falha de conexão e erro durante uma operação. Leia as orientações e abra os detalhes do servidor disponíveis. Anote código, banco/esquema e tabela. Um número UI identifica uma orientação do aplicativo, não um erro do servidor. Não repita imediatamente a operação.

Índice UNIQUE recusado com detalhes do erro
Índice UNIQUE recusado com detalhes do erroExemplo com dados de teste (Cuvel SQL 1.0.2)Abrir imagem em tamanho original em outra aba ↗

Tempo esgotado, conexão recusada ou host não encontrado

Compare host e porta com os dados do serviço. Confira servidor, rede e VPN necessário. Consulte firewall e IPs de origem permitidos. Com SSH, verifique PC–SSH e SSH–banco separadamente. Como destino do banco, 127.0.0.1 representa seu PC na conexão direta e o servidor SSH no túnel.

Falha ao resolver o host: causa e verificações
Falha ao resolver o host: causa e verificaçõesAbrir imagem em tamanho original em outra aba ↗

Erros de credenciais ou chave privada

Separe as credenciais do banco e do SSH. Autenticar no SSH não garante autenticação no banco. Escolha a chave privada, não o arquivo .pub, no Windows, WSL ou caminho manual correto. A frase secreta é diferente da senha SSH. Confira o nome exato do banco; PostgreSQL precisa do banco, não do esquema.

Conferir CA, hostname e chave do servidor SSH

Selecione o arquivo CA fornecido pelo serviço, não a URL. Confira nome oficial, validade, relógio do PC e CA. Compare a primeira chave do servidor SSH com a impressão digital do administrador. Confirme mudanças de chaves ou certificados conhecidos. Não desative verificações nem apague chaves salvas apenas para remover um aviso.

Guia de conexão SSH e SSL/TLS →

Conecta, mas tabelas não aparecem ou ações são negadas

Selecione o banco/esquema correto e recarregue. Autenticação e permissões são diferentes. Leitura, pesquisa e exportação exigem SELECT; alterações UPDATE, inclusão INSERT e exclusão DELETE. Estrutura pode exigir ALTER. Confira permissões para o destino e a operação, sem pedir acesso de administrador por padrão.

Não é possível editar ou salvar células

Sem chave primária, uma linha pode não ser identificada com segurança. Resultados SQL com junções ou agregações podem ser somente leitura. Colunas calculadas, dados binários e valores truncados têm restrições. Confira formato, tamanho, NOT NULL, duplicações de chaves primárias/UNIQUE, chaves estrangeiras e UPDATE. Revise os dados e o projeto antes de adicionar chave primária.

Explicação de um resultado SQL somente leitura
Explicação de um resultado SQL somente leituraExemplo com dados de teste (Cuvel SQL 1.0.2)Abrir imagem em tamanho original em outra aba ↗

Pesquisar, editar e exportar registros →

Conferir o estado antes de tentar novamente

Uma interrupção durante alterações não significa que nada foi executado. Reconecte e recarregue; uma exclusão múltipla pode estar parcial. Para zero resultados, confira condições, AND/OR e tipos. Para falha de exportação, confira SELECT, espaço e escrita. Se persistir, informe versão, SO, produto do banco, conexão, passos e detalhes sem senhas, chaves privadas ou dados pessoais.

Sua primeira conexão →
← Voltar aos guias