Esta página contiene una lista de los problemas más frecuentes que pueden surgir al trabajar con instancias de Cloud SQL y los pasos a seguir para solucionarlos. Consulte también las páginas "Problemas conocidos" , "Solución de problemas" y "Soporte" .
Ver registros
Para ver información sobre operaciones recientes, puede ver los registros de operaciones de la instancia de Cloud SQL o los registros de errores de PostgreSQL .
Problemas de conexión
Consulte la página de problemas de conexión de depuración o la sección Conectividad en la página de solución de problemas para obtener ayuda con los problemas de conexión.
Problemas de instancia
Copias de seguridad
Para obtener el mejor rendimiento de las copias de seguridad , mantenga la cantidad de tablas en un número razonable.
Para otros problemas de copias de seguridad, consulte la sección Copias de seguridad en la página de solución de problemas.
Importación y exportación
Las importaciones a Cloud SQL y las exportaciones desde Cloud SQL pueden tardar bastante tiempo en completarse, dependiendo del tamaño de los datos procesados. Esto puede tener las siguientes consecuencias:
- No se puede detener una operación de instancia de Cloud SQL de ejecución prolongada.
- Solo se puede realizar una operación de importación o exportación a la vez para cada instancia, y una importación o exportación de larga duración bloquea otras operaciones, como las copias de seguridad automáticas diarias. Las exportaciones sin servidor permiten ejecutar otras operaciones, como la edición de instancias, la importación, la conmutación por error y el desbloqueo de las copias de seguridad automáticas diarias.
Puede reducir la cantidad de tiempo que lleva completar cada operación utilizando la funcionalidad de importación o exportación de Cloud SQL con lotes de datos más pequeños.
Para las exportaciones, puede realizar la exportación desde una réplica de lectura o usar la exportación sin servidor para minimizar el impacto en el rendimiento de la base de datos y permitir que otras operaciones se ejecuten en su instancia mientras se ejecuta una exportación.
Para otros problemas de importación y exportación, consulte la sección Importación y exportación en la página de solución de problemas.
Espacio en disco
Si su instancia alcanza el almacenamiento máximo permitido, las operaciones de escritura en la base de datos fallarán. Si elimina datos, por ejemplo, borrando una tabla, el espacio se libera, pero no se refleja en el almacenamiento utilizado de la instancia. Puede ejecutar el comandoVACUUM FULL para recuperar el espacio no utilizado; tenga en cuenta que las operaciones de escritura se bloquean mientras se ejecuta el comando. Más información .Estado suspendido
Hay varias razones por las que Cloud SQL puede suspender una instancia, entre ellas:
Problemas de facturación
Por ejemplo, si la tarjeta de crédito de la cuenta de facturación del proyecto ha caducado, la instancia podría suspenderse. Puede consultar la información de facturación de un proyecto en Google Cloud Página de facturación de la consola, donde se selecciona el proyecto y se visualiza la información de la cuenta de facturación utilizada para el proyecto. Tras resolver el problema de facturación, la instancia vuelve a estar en estado ejecutable en pocas horas.
Problemas clave con el servicio de administración de claves en la nube
Por ejemplo, si la versión de la clave de Cloud KMS utilizada para cifrar los datos del usuario en la instancia de Cloud SQL no está presente, se revoca el acceso a la clave o esta se desactiva o elimina. Para obtener más información, consulte Uso de claves de cifrado administradas por el cliente (CMEK) .
Cuestiones jurídicas
Por ejemplo, una violación de la Google Cloud La Política de Uso Aceptable puede provocar la suspensión de la instancia. Para más información, consulte "Suspensiones y Eliminaciones" en Google Cloud Condiciones de servicio .
Problemas operativos
Por ejemplo, si una instancia queda atrapada en un bucle de fallos (se bloquea al iniciarse o justo después de iniciarse), Cloud SQL puede suspenderla.
Mientras una instancia está suspendida, puedes seguir viendo información sobre ella o puedes eliminarla, si problemas de facturación desencadenaron la suspensión.
Los usuarios de Cloud SQL con paquetes de soporte Platinum, Gold o Silver pueden contactar directamente con nuestro equipo de soporte si tienen instancias suspendidas. Todos los usuarios pueden usar la guía anterior y el foro de Google Cloud SQL .
Actuación
Descripción general
Cloud SQL admite cargas de trabajo de alto rendimiento con hasta 60 000 IOPS sin coste adicional por E/S. El rendimiento de IOPS y el rendimiento dependen del tamaño del disco, la cantidad de vCPU de la instancia y el tamaño del bloque de E/S, entre otros factores.
El rendimiento de su instancia también depende de su elección de tipo de almacenamiento y carga de trabajo.
Obtenga más información sobre:
- Discos persistentes y rendimiento .
- Métricas de rendimiento y limitación .
- Optimización del rendimiento del disco .
- Otros factores que afectan el rendimiento .
Mantenga un número razonable de tablas de base de datos
Las tablas de base de datos consumen recursos del sistema. Un número elevado puede afectar el rendimiento y la disponibilidad de la instancia, y hacer que esta pierda su cobertura del SLA. Más información .
Habilitar registros de consultas
Puede registrar consultas lentas de Cloud SQL para PostgreSQL configurando el indicador log_min_duration_statement . Se registrarán las consultas que se hayan ejecutado durante al menos el tiempo especificado. Si este valor se especifica sin unidades, se tomará en milisegundos. Vaya a Registro de Operaciones para ver los registros.
Consejos generales de rendimiento
Asegúrese de que su instancia no tenga limitaciones de memoria ni CPU. Para cargas de trabajo con alto rendimiento, asegúrese de que su instancia tenga al menos 60 GB de memoria. Para inserciones, actualizaciones o eliminaciones lentas de la base de datos, verifique las ubicaciones del escritor y la base de datos; enviar datos a larga distancia genera latencia.Mejore el rendimiento de las consultas mediante el uso de Query Insights .
Para selecciones de bases de datos lentas, considere lo siguiente:
- El almacenamiento en caché es importante para el rendimiento de lectura. Verifique las distintas proporciones de
blks_hit / (blks_hit + blks_read)en el Recopilador de Estadísticas de PostgreSQL . Idealmente, la proporción es superior al 99 %. De lo contrario, considere aumentar la RAM de su instancia. - Si su carga de trabajo consiste en consultas que hacen un uso intensivo de la CPU (ordenación, expresiones regulares, otras funciones complejas), su instancia podría verse limitada; agregue vCPU.
- Verifique la ubicación del lector y la base de datos: la latencia afecta el rendimiento de lectura incluso más que el rendimiento de escritura.
- Investigar mejoras de rendimiento que no sean específicas de Cloud SQL, como agregar indexación adecuada, reducir los datos escaneados y evitar viajes de ida y vuelta adicionales.
EXPLAIN para identificar dónde agregar índices a las tablas y mejorar el rendimiento. Por ejemplo, asegúrese de que cada campo que utilice como clave JOIN tenga un índice en ambas tablas.Solucionar problemas
Para otros problemas de Cloud SQL, consulte la página de solución de problemas .
Mensajes de error
Para conocer mensajes de error de API específicos, consulte la página de referencia de mensajes de error .
Solucionar problemas de claves de cifrado administradas por el cliente (CMEK)
Las operaciones del administrador de Cloud SQL, como crear, clonar o actualizar, podrían fallar debido a errores de Cloud KMS y a la falta de roles o permisos. Entre los motivos comunes de fallo se incluyen la falta de una versión de la clave de Cloud KMS, una versión de la clave de Cloud KMS deshabilitada o destruida, permisos de IAM insuficientes para acceder a la versión de la clave de Cloud KMS o que la versión de la clave de Cloud KMS se encuentre en una región diferente a la de la instancia de Cloud SQL. Utilice la siguiente tabla de solución de problemas para diagnosticar y resolver problemas comunes.
Tabla de resolución de problemas de claves de cifrado administradas por el cliente
| Para este error... | El problema podría ser... | Prueba esto... |
|---|---|---|
| No se encontró ninguna cuenta de servicio por producto y por proyecto | El nombre de la cuenta de servicio es incorrecto. | Asegúrese de haber creado una cuenta de servicio para el proyecto de usuario correcto. |
| No se puede conceder acceso a la cuenta de servicio | La cuenta de usuario no tiene permiso para otorgar acceso a esta versión de clave. | Agregue el rol de Administrador de la organización a su cuenta de usuario o servicio. |
| La versión de la clave de Cloud KMS está destruida | La versión clave está destruida. | Si se destruye la versión de la clave, no podrás usarla para cifrar o descifrar datos. |
| La versión de la clave Cloud KMS está deshabilitada | La versión clave está deshabilitada. | Vuelva a habilitar la versión de la clave Cloud KMS. |
| Permiso insuficiente para utilizar la clave Cloud KMS | Falta la función cloudkms.cryptoKeyEncrypterDecrypter en la cuenta de usuario o servicio que está utilizando para ejecutar operaciones en instancias de Cloud SQL, o la versión de la clave de Cloud KMS no existe. | En el Google Cloud proyecto que aloja la clave, agregue la función cloudkms.cryptoKeyEncrypterDecrypter a su cuenta de usuario o servicio.Si el rol ya está asignado a su cuenta, consulte "Crear una clave" para saber cómo crear una nueva versión de clave. Consulte la nota. |
| No se encuentra la clave KMS de Cloud | La versión clave no existe. | Cree una nueva versión de clave. Consulte "Crear una clave" . Consulte la nota. |
| La instancia de Cloud SQL y la versión de la clave de Cloud KMS están en diferentes regiones | La versión de la clave de Cloud KMS y la instancia de Cloud SQL deben estar en la misma región. Esto no funciona si la versión de la clave de Cloud KMS está en una región global o multirregional. | Cree una versión de clave en la misma región donde desea crear instancias. Consulte "Crear una clave" . Consulte la nota. |
| La versión de la clave de Cloud KMS se restauró, pero la instancia aún está suspendida | La versión clave está deshabilitada o no otorga los permisos adecuados. | Vuelva a habilitar la versión de la clave y otorgue la función cloudkms.cryptoKeyEncrypterDecrypter a su cuenta de usuario o servicio en el Google Cloud proyecto que alberga la clave. |
Tabla de solución de problemas de reencriptación
| Para este error... | El problema podría ser... | Prueba esto... |
|---|---|---|
| El recifrado del recurso CMEK falló porque la clave de Cloud KMS es inaccesible. Asegúrese de que la versión de la clave principal esté habilitada y de que el permiso se haya otorgado correctamente. | La versión clave está deshabilitada o no otorga los permisos adecuados. | Vuelva a habilitar la versión de la clave Cloud KMS: IR A LA PÁGINA DE CLAVES CRIPTO En el Google Cloud proyecto que aloja la clave, confirme que la función |
| El reencriptado del recurso CMEK falló debido a un error interno del servidor. Vuelva a intentarlo más tarde. | Hay un error interno del servidor. | Vuelva a intentar el reencriptado. Para obtener más información, consulte Volver a encriptar una instancia o réplica existente con CMEK habilitado. |