Problemas conhecidos

Esta página lista problemas conhecidos com o Cloud SQL para PostgreSQL, juntamente com maneiras de evitá-los ou se recuperar deles.

Se você estiver enfrentando problemas com sua instância, certifique-se de revisar também as informações em Diagnóstico de problemas .

Problemas de conexão de instância

  • Certificados SSL/TLS expirados

    Se sua instância estiver configurada para usar SSL, acesse a página Instâncias do Cloud SQL no Google Cloud console e abra a instância. Abra a página Conexões , selecione a aba Segurança e certifique-se de que o certificado do seu servidor esteja válido. Se ele estiver expirado, você deverá adicionar um novo certificado e alternar para ele.

  • Versão do Proxy de Autenticação do Cloud SQL

    Se você estiver se conectando usando o Proxy de Autenticação do Cloud SQL, certifique-se de usar a versão mais recente. Para obter mais informações, consulte Como manter o Proxy de Autenticação do Cloud SQL atualizado .

  • Não autorizado a conectar

    Se você tentar se conectar a uma instância que não existe naquele projeto, a mensagem de erro apenas dirá que você não está autorizado a acessar aquela instância.

  • Não é possível criar uma instância do Cloud SQL

    Se você vir a mensagem de erro Failed to create subnetwork. Router status is temporarily unavailable. Please try again later. Help Token: [token-ID] , tente criar a instância do Cloud SQL novamente.

  • O seguinte só funciona com o usuário padrão ('postgres'): gcloud sql connect --user

    Se você tentar se conectar usando este comando com qualquer outro usuário, a mensagem de erro será FATAL: database 'user' does not exist . A solução alternativa é conectar-se usando o usuário padrão ('postgres') e, em seguida, usar o comando psql "\c" para reconectar com o usuário diferente.

Questões administrativas

  • Apenas uma operação de importação ou exportação de longa duração do Cloud SQL pode ser executada por vez em uma instância. Ao iniciar uma operação, certifique-se de que não precisa executar outras operações na instância. Além disso, ao iniciar a operação, você pode cancelá-la .

    O PostgreSQL importa dados em uma única transação. Portanto, se você cancelar a operação de importação, o Cloud SQL não manterá os dados da importação.

    Problemas com importação e exportação de dados

    • Se a sua instância do Cloud SQL usa o PostgreSQL 17, mas seus bancos de dados usam o PostgreSQL 16 e versões anteriores, você não poderá usar o Cloud SQL para importar esses bancos de dados para a sua instância. Para isso, use o Database Migration Service .

    • Se você usar o Database Migration Service para importar um banco de dados PostgreSQL 17 para o Cloud SQL, ele será importado como um banco de dados PostgreSQL 16.

    • Para as versões 15 e posteriores do PostgreSQL, se o banco de dados de destino for criado a partir do template0 , a importação de dados poderá falhar e você poderá ver a mensagem de erro permission denied for schema public . Para resolver esse problema, conceda privilégios de esquema público ao usuário cloudsqlsuperuser executando o comando SQL GRANT ALL ON SCHEMA public TO cloudsqlsuperuser .

    • Exportar muitos objetos grandes faz com que a instância pare de responder

      Se o seu banco de dados contiver muitos objetos grandes (blobs), a exportação do banco de dados poderá consumir tanta memória que a instância deixará de responder. Isso pode acontecer mesmo se os blobs estiverem vazios.

    • O Cloud SQL não oferece suporte a tablespaces personalizados, mas oferece suporte à migração de dados de tablespaces personalizados para o tablespace padrão, pg_default , na instância de destino. Por exemplo, se você possui um tablespace chamado dbspace localizado em /home/data , após a migração, todos os dados dentro dbspace serão migrados para pg_default . No entanto, o Cloud SQL não criará um tablespace chamado "dbspace" em seu disco.

    • Se você estiver tentando importar e exportar dados de um banco de dados grande (por exemplo, um banco de dados com 500 GB de dados ou mais), as operações de importação e exportação podem levar muito tempo para serem concluídas. Além disso, outras operações (por exemplo, a operação de backup) não estarão disponíveis para execução durante a importação ou exportação. Uma opção possível para melhorar o desempenho do processo de importação e exportação é restaurar um backup anterior usando gcloud ou a API.

    • O Cloud Storage suporta um tamanho máximo de objeto único de até cinco terabytes . Se você tiver bancos de dados maiores que 5 TB, a operação de exportação para o Cloud Storage falhará. Nesse caso, você precisará dividir os arquivos de exportação em segmentos menores.

    Logs de transações e crescimento de disco

    Os logs são limpos uma vez por dia, não continuamente. Quando o número de dias de retenção de logs é configurado para ser igual ao número de backups, um dia de registro pode ser perdido, dependendo de quando o backup for realizado. Por exemplo, definir a retenção de logs para sete dias e a retenção de backups para sete backups significa que entre seis e sete dias de logs serão retidos.

    Recomendamos definir o número de backups como pelo menos um a mais que os dias de retenção de log para garantir um mínimo de dias especificados de retenção de log.

    Instâncias com os seguintes nomes de região são exibidas incorretamente em determinados contextos, como a seguir:

    • us-central1 é exibido como us-central
    • europe-west1 é exibido como europe
    • asia-east1 é exibido como asia

    Esse problema ocorre nos seguintes contextos:

    • Alertas no monitoramento de nuvem
    • Explorador de Métricas
    • Registro em nuvem

    Você pode atenuar o problema do Alertas no Cloud Monitoring e do Metrics Explorer usando Rótulos de metadados de recursos . Use a region rótulos de metadados do sistema em vez da region rótulos de recursos monitorados do cloudsql_database .