Errores conocidos

En esta página se enumeran los problemas conocidos de Cloud SQL para PostgreSQL y las maneras en que puedes evitarlos o repararlos.

Si tienes problemas con tu instancia, asegúrate de revisar también la información en Cómo diagnosticar problemas.

Problemas de conexión de la instancia

  • Certificados SSL/TLS vencidos

    Si tu instancia está configurada para usar SSL, ve a la página Instancias de Cloud SQL en la consola de Google Cloud y abre la instancia. Abre la página Conexiones, selecciona la pestaña Seguridad y asegúrate de que tu certificado de servidor sea válido. Si caducó, debes agregar uno nuevo y rotarlo.

  • Versión del proxy de Cloud SQL Auth

    Si utilizas el proxy de Cloud SQL Auth para conectarte, asegúrate de utilizar la versión más reciente. Para obtener más información, visita Mantén actualizado el proxy de Cloud SQL Auth.

  • No autorizado para conectarte

    Si intentas conectarte a una instancia que no existe en ese proyecto, el mensaje de error solo dirá que no estás autorizado para acceder a esa instancia.

  • No se puede crear una instancia de Cloud SQL

    Si ves el mensaje de error Failed to create subnetwork. Router status is temporarily unavailable. Please try again later. Help Token: [token-ID], vuelve a crear la instancia de Cloud SQL.

  • Este comando solo funciona con el usuario predeterminado (“postgres”): gcloud sql connect --user

    Si intentas conectarte mediante este comando con cualquier otro usuario, el mensaje de error dirá FATAL: database 'user' does not exist. La solución consiste en conectarse con el usuario predeterminado (“postgres”) y, luego, usar el comando "\c" de psql para volver a conectarse como el usuario diferente.

  • Las conexiones de PostgreSQL se bloquean cuando se habilita la autenticación del proxy de base de datos de IAM.

    Cuando el proxy de autenticación de Cloud SQL se inicia mediante sockets TCP y con la marca -enable_iam_login, un cliente PostgreSQL queda en espera durante la conexión TCP. Una solución alternativa es usar sslmode=disable en la string de conexión de PostgreSQL. Por ejemplo:

    psql "host=127.0.0.1 dbname=postgres user=me@google.com sslmode=disable"

    Otra solución alternativa es iniciar el proxy de autenticación de Cloud SQL mediante sockets Unix. Esto desactiva la encriptación SSL de PostgreSQL y permite que el proxy de autenticación de Cloud SQL realice la encriptación SSL.

Problemas de administración

  • Solo se puede ejecutar una operación de importación o exportación de Cloud SQL de larga duración a la vez en una instancia. Cuando inicies una operación, asegúrate de que no necesites realizar otras operaciones en ella. Además, cuando inicies la operación, puedes cancelarla.

    PostgreSQL importa datos en una sola transacción. Por lo tanto, si cancelas la operación de importación, Cloud SQL no conservará los datos de dicha importación.

    Problemas con la importación y la exportación de datos

    • Si tu instancia de Cloud SQL usa PostgreSQL 17, pero tus bases de datos usan PostgreSQL 16 y versiones anteriores, no puedes usar Cloud SQL para importar estas bases de datos a tu instancia. Para ello, usa Database Migration Service.

    • Si usas Database Migration Service para importar una base de datos de PostgreSQL 17 a Cloud SQL, se importará como una base de datos de PostgreSQL 16.

    • En las versiones 15 y posteriores de PostgreSQL, si la base de datos de destino se crea a partir de template0, es posible que la importación de datos falle y se muestre un mensaje de error permission denied for schema public. Para resolver este problema, proporciona privilegios de esquema públicos al usuario cloudsqlsuperuser mediante la ejecución del comando GRANT ALL ON SCHEMA public TO cloudsqlsuperuser de SQL.

    • Exportar muchos objetos grandes hace que la instancia no responda.

      Si tu base de datos contiene muchos objetos grandes (BLOB), exportarla puede consumir tanta memoria que la instancia deja de responder. Esto puede pasar incluso si los BLOB están vacíos.

    • Cloud SQL no admite espacios de tabla personalizados, pero admite la migración de datos desde espacios de tablas personalizados hasta el espacio de tabla predeterminado, pg_default, en la instancia de destino. Por ejemplo, si tienes un espacio de tabla llamado dbspace, se ubica en /home/data. Después de la migración, todos los datos dentro de dbspace se migran a pg_default. Sin embargo, Cloud SQL no creará un espacio de tabla llamado “dbspace” en su disco.

    • Si intentas importar y exportar datos desde una base de datos grande (por ejemplo, una base de datos que tiene 500 GB de datos o más), las operaciones de importación y exportación pueden tardar mucho tiempo en completarse. Además, no puedes realizar otras operaciones (por ejemplo, la operación de copia de seguridad) mientras se realiza la importación o exportación. Una opción posible para mejorar el rendimiento del proceso de importación y exportación es restablecer una copia de seguridad anterior mediante gcloud o la API.

    Registros de transacciones y aumento de discos

    Los registros se borran definitivamente una vez al día, no de forma continua. Cuando la cantidad de días de retención de registros se configura para ser la misma que la cantidad de copias de seguridad, es posible que se pierda un día de registro, según el momento en que se realice la copia de seguridad. Por ejemplo, establecer la retención de registros en siete días y la retención de copias de seguridad en siete copias de seguridad implica que se conservarán entre seis y siete días de registros.

    Recomendamos configurar la cantidad de copias de seguridad en un día más que los días de retención de registros para garantizar un mínimo de días específicos de retención.

    Las instancias con los siguientes nombres de región se muestran de forma incorrecta en ciertos contextos, de la siguiente manera:

    • us-central1 se muestra como us-central
    • europe-west1 se muestra como europe
    • asia-east1 se muestra como asia

    Este problema ocurre en los siguientes contextos:

    • Alertas en Cloud Monitoring
    • Explorador de métricas
    • Cloud Logging

    Puedes mitigar el problema de las alertas en Cloud Monitoring y del explorador de métricas mediante etiquetas de metadatos de recursos. Usa la etiqueta de metadatos del sistema region en lugar de la etiqueta de recurso supervisado cloudsql_database region.