Mensagens de erro do Cloud SQL para PostgreSQL

Nesta página, mostramos algumas mensagens de erro encontradas no Cloud SQL.

Visão geral

As mensagens de erro no Cloud SQL provêm de muitas origens e aparecem em muitos lugares. Algumas mensagens de erro são derivadas dos próprios mecanismos de banco de dados, do serviço Cloud SQL, de aplicativos clientes, e outras retornadas por chamadas à API Cloud SQL Admin.

Nesta página, incluímos alguns dos erros mais comuns encontrados no Cloud SQL. Se você não encontrar nela o código de erro ou a mensagem que procura, pesquise o material de referência de origem nestes locais:

Se você não encontrar o material de referência da mensagem de erro que aparece, pesquise também em alguns destes lugares, onde outros usuários podem ter experiência relevante:

Erros operacionais

A | B | C | D | E | F | G | I | L | M | N | O | P | Q | R | S | T | U | W

Mensagem de erro Solução de problemas
Acesso negado para o usuário "XXX"@"XXX" (usando a senha: XXX) Pode haver várias causas, incluindo:
  • o nome de usuário (ou senha) está incorreto;
  • o usuário está se conectando de um URL diferente de @XXX;
  • o usuário não tem os privilégios corretos para o banco de dados a que está tentando se conectar.

Tente fazer o seguinte:

  • Verifique o nome de usuário e a senha correspondente.
  • Verifique a origem da conexão para ver se ela corresponde ao URL em que o usuário tem privilégios de acesso.
  • Verifique os privilégios de concessão do usuário no banco de dados.
Intervalo de IP alocado não encontrado na rede. Os peerings de VPC não foram atualizados depois que um intervalo alocado foi modificado ou removido.

É necessário modificar a conexão particular. Use o seguinte comando e certifique-se de usar o argumento --force:

gcloud services vpc-peerings update \
--network=VPC_NETWORK \
--ranges=ALLOCATED_RANGES \
--service=servicenetworking.googleapis.com \
--force
Mensagem de erro Solução de problemas
Solicitação inválida. Essa mensagem pode ter muitas causas. Illegal Argument é uma das mais comuns. Nesse caso, a solicitação está usando o argumento errado ou um valor inválido para ele. Para muitas outras causas, a mensagem de erro pode conter uma dica útil.

Para Illegal Argument, verifique a solicitação para saber se cada argumento é permitido e se cada valor de argumento é válido. Para todas as outras causas, verifique os arquivos de registros para ver se há mais informações disponíveis.
Mensagem de erro Solução de problemas
Não é possível modificar intervalos alocados em CreateConnection. Use UpdateConnection. Os peerings de VPC não são atualizados depois que um intervalo alocado é modificado ou removido.

É necessário modificar a conexão particular. Use o seguinte comando e certifique-se de usar o argumento --force:

gcloud services vpc-peerings update \
--network=VPC_NETWORK \
--ranges=ALLOCATED_RANGES \
--service=servicenetworking.googleapis.com \
--force
Conexão redefinida pelo peering.

Se você estiver tentando fazer uma exportação e o Cloud Storage não receber dados em um determinado período, a conexão será redefinida.

Tente fazer uma exportação manual usando pg_dump.
Constraints/sql.restrictAuthorizedNetworks. A operação de clonagem é bloqueada pela configuração Authorized Networks. Authorized Networks são configurados para endereços IP públicos na seção "Conectividade" do Console do Google Cloud, e a clonagem não é permitida devido a considerações de segurança.

Remova todas as entradas Authorized Networks da instância do Cloud SQL, se possível. Caso contrário, crie uma réplica sem nenhuma entrada Authorized Networks.
Mensagem de erro Solução de problemas
O banco de dados user não existe. gcloud sql connect --user funciona apenas com o usuário postgres padrão.

Conecte-se com o usuário padrão e mude os usuários.
O disco está cheio. O tamanho do disco da instância principal pode ficar cheio durante a criação da réplica.

Edite a instância principal com upgrade para um tamanho de disco maior.
Mensagem de erro Solução de problemas
Falha ao criar sub-rede. Não há mais endereços disponíveis no intervalo de IP.

Não foi possível encontrar blocos gratuitos em intervalos de IP alocados. Aloque novos intervalos para este provedor de serviços.

Não há mais endereços disponíveis no intervalo de IP alocado.

Considere estes cenários possíveis:

  • O tamanho do intervalo de IP alocado para a conexão de serviço particular é menor que /24.
  • O tamanho do intervalo de IP alocado para a conexão de serviço particular é muito pequeno para o número de instâncias do Cloud SQL.
  • O requisito sobre o tamanho do intervalo de IP alocado será maior se as instâncias forem criadas em várias regiões. Consulte tamanho do intervalo alocado.

Para cada um dos cenários acima, é possível expandir a opção atual ou alocar um intervalo de IP adicional para a conexão de serviço particular.

Se você estiver alocando um novo intervalo, tenha cuidado para não criar uma alocação que se sobreponha a uma alocação existente.

Depois de criar um novo intervalo de IP, atualize o peering VPC com o comando a seguir:

gcloud services vpc-peerings update \
--service=servicenetworking.googleapis.com
--ranges=OLD_RESERVED_RANGE_NAME,NEW_RESERVED_RANGE_NAME \
--network=VPC_NETWORK
--project=PROJECT_ID \
--force

Se você estiver expandindo uma alocação atual, só aumente o intervalo de alocação em vez de diminuí-lo. Por exemplo, se a alocação original for 10.0.10.0/24, faça a nova alocação pelo menos 10.0.10.0/23.

Em geral, se começar com uma alocação de /24, diminuir a /mascaramento em 1 para cada condição (grupo de tipo de instância adicional, região adicional) é uma boa regra geral. Por exemplo, se você tentar criar os dois grupos de tipos de instância na mesma alocação, a mudança de /24 para /23 será suficiente.

Depois de expandir um intervalo de IP atual, use o seguinte comando para atualizar o peering VPC:

gcloud services vpc-peerings update \
--service=servicenetworking.googleapis.com
--ranges=RESERVED_RANGE_NAME \
--network=VPC_NETWORK \
--project=PROJECT_ID \
--force
Mensagem de erro Solução de problemas
(gcloud.sql.connect) Parece que o cliente não tem conectividade ipv6, e a instância do banco de dados não tem um endereço ipv4. Você está tentando se conectar à sua instância de IP particular usando o Cloud Shell.

No momento, não é possível se conectar do Cloud Shell a uma instância com apenas um endereço IP particular.
Mensagem de erro Solução de problemas
Erro interno. O projeto de serviço pode estar sem a conta de serviço de rede necessária para esse recurso.

Para corrigir as permissões do serviço, desative Service Networking API, aguarde cinco minutos e reative-o.
Solicitação inválida: configuração de rede de serviço incorreta, por exemplo. Service Networking API não está ativado no projeto.

Ative a Service Networking API no seu projeto. Se você vir esse erro ao tentar atribuir um endereço IP particular a uma instância do Cloud SQL e estiver usando uma VPC compartilhada, também será necessário ativar a Service Networking API para o projeto host.
Mensagem de erro Solução de problemas
Falha na associação de rede. A Service Networking API não está ativada no projeto.

Ative a Service Networking API no seu projeto. Se você vir esse erro ao tentar atribuir um endereço IP particular a uma instância do Cloud SQL e estiver usando uma VPC compartilhada, também será necessário ativar a Service Networking API para o projeto host.
Mensagem de erro Solução de problemas
A operação falhou porque outra operação ainda estava em andamento. A maioria das operações no Cloud SQL é síncrona. É possível executar apenas uma de cada vez.

Aguarde a operação anterior ser concluída antes de iniciar outra.
A operação não é válida para esta instância. Esse erro é retornado de uma chamada de API para instances.restoreBackup e significa que não é possível restaurar do backup para uma instância com um tamanho de armazenamento (XX GB) menor que o tamanho do backup (YY GB).

Edite a instância de destino para aumentar o tamanho de armazenamento dela.
Mensagem de erro Solução de problemas
Falha na autenticação da senha para o usuário "postgres". Quando você cria uma nova instância do Cloud SQL para PostgreSQL, o usuário administrador padrão postgres é criado, mas a senha não é criada. É necessário definir uma senha para esse usuário antes que o usuário faça login.

Mensagem de erro Solução de problemas
Cota excedida. Você atingiu o limite de sua cota diária ou por minuto. Revise as cotas e limites do Cloud SQL.

Solicite um aumento nas suas cotas pelo Console do Google Cloud.
Mensagem de erro Solução de problemas
Os slots de conexão restantes estão reservados. O número máximo de conexões permitidas foi atingido.

Aumente o valor da sinalização max_connections. Consulte Como configurar sinalizações do banco de dados.
Falta uma chave de API válida na solicitação Talvez você não tenha um arquivo JSON de chave de conta de serviço válida ou ele não esteja armazenado no local esperado.

Verifique se você tem um arquivo JSON de chave de conta de serviço válido no local armazenado na variável de ambiente GOOGLE_APPLICATION_CREDENTIALS e se a variável aponta para o local correto.
Mensagem de erro Solução de problemas
Erro de SSL: padding inválido. Erro de certificado do servidor.

Crie um novo certificado de servidor e rotate.
Ocorreu um erro de sistema.
  • O usuário pode não ter todas as permissões necessárias do Cloud Storage.
  • A tabela de banco de dados pode não existir.

Tente fazer o seguinte:

  • Verifique se você tem pelo menos as permissões de WRITER no bucket e de READER no arquivo de exportação. Para mais informações sobre como configurar o controle de acesso no Cloud Storage, consulte Criar e gerenciar listas de controle de acesso.
  • Verifique se a tabela existe. Se a tabela existir, confirme se você tem as permissões corretas no bucket de armazenamento.
Mensagem de erro Solução de problemas
A definição da tabela foi alterada. Durante o processo de exportação, ocorreu uma alteração na tabela.

A transação de despejo poderá falhar se você usar as seguintes instruções durante a operação de exportação:

  • ALTER TABLE
  • CREATE TABLE
  • DROP TABLE
  • RENAME TABLE
  • TRUNCATE TABLE

Remova qualquer uma dessas instruções da operação de despejo.
O tamanho do arquivo temporário excede temp_file_limit. A sinalização temp_file_limit está definida com valor muito baixo para o uso do banco de dados.

Aumente o tamanho de temp_file_limit. Consulte Como configurar sinalizações do banco de dados.
(Tempo limite) durante a exportação. Os formatos CSV e SQL são exportados de maneira diferente. O formato SQL inclui todo o banco de dados e provavelmente levará mais tempo para ser concluído.

Use o formato CSV e execute vários jobs de exportação menores para reduzir o tamanho e a duração de cada operação.
Muitas conexões. Definir um valor muito alto para a sinalização max_connections pode causar esse erro. Isso também pode ser causado pela ativação de uma sinalização fora de sequência.

Reduza o valor da sinalização max_connections ou entre em contato com o suporte ao cliente para solicitar a remoção de uma sinalização, seguida de um hard drain. Isso força a instância a reiniciar em um host diferente com uma nova configuração, sem a sinalização ou a configuração.
Mensagem de erro Solução de problemas
Sem autorização para se conectar. Pode haver muitas causas, já que a autorização ocorre em muitos níveis:
  • No nível do banco de dados, o usuário do banco de dados precisa existir e a senha precisa corresponder.
  • No nível do projeto, o usuário pode não ter as permissões de IAM corretas, incluindo as permissões serviceusage.services.use ou cloudsql.instances.connect.
  • No nível da rede, se a instância do Cloud SQL estiver usando IP público, o IP de origem da conexão precisa estar em uma rede autorizada.

Tente fazer o seguinte:

  • Verifique se o usuário existe e corresponde à senha.
  • Atribua o papel Service Usage Consumer à conta de usuário. Esse papel inclui a permissão serviceusage.services.use.
  • Se estiver usando IP público, verifique se o IP de origem está em uma rede autorizada.
Mensagem de erro Solução de problemas
x509: o certificado não é válido para nenhum nome. Problema conhecido: no momento, o Cloud SQL Proxy Dialer (em inglês) não é compatível com o Go 1.15.

Até que o problema seja resolvido, confira esta discussão no GitHub (em inglês), que inclui uma solução alternativa.

Erros desconhecidos

A tabela a seguir mostra alguns casos conhecidos em que um Unknown Error pode ocorrer e lista correções específicas quando aplicável. No entanto, esta não é uma lista completa. Se você não encontrar seu caso na tabela, consulte o Issue Tracker público do Cloud SQL. Se você não encontrar o problema, envie um relatório ou leia outras opções de suporte.

Operação O problema pode ser... O que você deve tentar...
Adicionar usuário Se o usuário já existir no banco de dados, esse erro poderá ocorrer quando você tentar adicioná-lo. Verifique se o usuário já não existe no banco de dados.
Backup Se isso aparecer durante os backups automáticos ou manuais, é provável que o disco da instância esteja cheio. Se o tamanho do arquivo temporário estiver ocupando muito espaço, reinicie a instância para remover esse arquivo e liberar o espaço no disco. Caso contrário, talvez seja necessário fazer upgrade da instância para um tamanho de disco maior.
Clonar Isso pode ocorrer quando há uma falta de recursos na zona selecionada. Tente outra zona na região ou aguarde e tente novamente mais tarde.
Criar instância
  • Isso pode ocorrer quando você tenta reutilizar o mesmo nome de uma instância excluída recentemente.
  • Também pode ser causado por problemas de conectividade intermitente.
  • Os registros podem mostrar que a API Service Networking não está ativada para o projeto.
  • O erro também foi visto ao tentar criar várias instâncias em paralelo. Por exemplo, os scripts do Terraform tornam essa tentativa possível.
  • O problema também pode ocorrer porque um recurso específico está esgotado ou um limite de cota foi excedido. Nos registros, procure uma entrada como Quota 'INTERNAL_FORWARDING_RULES_WITH_TARGET_INSTANCE_PER_NETWORK' exceeded. Limit: 100.0 globally
  • Esse erro poderá ocorrer se a criação da sub-rede falhar quando não houver mais endereços disponíveis no intervalo de IP.
  • Os nomes de instância só podem ser reutilizados uma semana após a exclusão.
  • No caso de problemas de conectividade intermitente, a única solução é tentar novamente.
  • Ative a API Service Networking no projeto host.
  • Scripts de criação de instâncias paralelas só terão êxito na criação de uma das instâncias. Modifique o script para aguardar até que cada operação de criação da instância seja concluída antes de avançar para a próxima.
  • Alocar novos intervalos.
Criar réplica É provável que um erro mais específico esteja nos arquivos de registro. Inspecione os registros no Cloud Logging para encontrar o erro real.

Se o erro for set Service Networking service account as servicenetworking.serviceAgent role on consumer project, desative e reative Service Networking API. Essa ação cria a conta de serviço necessária para continuar com o processo.

Se o erro for The instance creation failed due to a permission error with the CMEK key defined, analise as configurações e o local da chave.
Exportar Se você vir isso ao tentar exportar um banco de dados para um bucket do Cloud Storage, a transferência poderá falhar devido a um problema de largura de banda. A instância do Cloud SQL pode estar localizada em uma região diferente do bucket do Cloud Storage. A leitura e a gravação de dados de um continente para outro envolve o uso excessivo de rede e pode causar problemas intermitentes como esse.
Failover (automático) Uma operação de failover automática pode produzir essa mensagem de erro quando o serviço detecta que a instância principal ainda é responsiva. Não há nada a ser feito nesse caso. O failover não ocorrerá porque não é necessário.
Importar O arquivo de importação pode conter instruções que exijam o papel de superusuário. Edite o arquivo para remover instruções que exigem o papel de superusuário.

O Cloud SQL também usa alguns binários de terceiros (por exemplo, mysqld), que podem gerar mensagens de erro desconhecidas. Esses erros são internos para os binários de terceiros e estão fora do escopo do Cloud SQL. No entanto, às vezes, um erro mais específico pode ser encontrado nos arquivos de registros do Cloud SQL ao mesmo tempo.

Além disso, algumas vezes é um código de erro desconhecido. Nesse caso, a mensagem completa pode ser Unknown Error Code.