Esta página analiza algunos de los mensajes de error encontrados en Cloud SQL.
Descripción general
Los mensajes de error en Cloud SQL provienen de diversas fuentes y aparecen en diversos lugares. Algunos mensajes de error provienen de los propios motores de base de datos, otros del servicio Cloud SQL, otros de las aplicaciones cliente y otros se devuelven mediante llamadas a la API de administración de Cloud SQL.
Esta página incluye algunos de los errores más comunes en Cloud SQL. Si no encuentra el código de error o el mensaje que busca, puede consultar el material de referencia aquí:
Si no encuentra el material de referencia para el mensaje de error que está viendo, también puede buscar en algunos de estos lugares donde otros usuarios pueden tener experiencia relevante:
- Preguntas sobre Cloud SQL en Stack Overflow
- Rastreador de problemas públicos para Cloud SQL
- Intercambio de pila de DBA
- Grupo de discusión sobre Cloud SQL
- Comunidad de Slack de Google Cloud
- Google Cloud en Reddit
Errores operativos
A | B | C | D | E | F | G | I | L | M | N | O | P | Q | R | S | T | U | O
Mensaje de error | Solución de problemas |
---|---|
Conexión abortada xxx a la base de datos: DB_NAME. | La aplicación no finaliza las conexiones correctamente. Verifique las siguientes condiciones:
|
Acceso denegado; necesita (al menos uno de) los privilegios SUPER para esta operación. | Podría haber una vista, una función o un procedimiento en la base de datos de origen que haga referencia DEFINER de una manera que no es compatible con Cloud SQL. Actualice el definidor en las bases de datos externas, por ejemplo, de |
Acceso denegado para el usuario 'XXX'@'XXX' (usando contraseña: XXX) | Podrían haber varias causas, entre ellas:
Prueba estas cosas...
|
No se encontró el rango de IP asignado en la red. | Los emparejamientos de VPC no se actualizaron después de que se modificó o eliminó un rango asignado. Necesita modificar la conexión privada . Use el siguiente comando y asegúrese de usar el argumento gcloud services vpc-peerings update \ --network=VPC_NETWORK \ --ranges=ALLOCATED_RANGES \ --service=servicenetworking.googleapis.com \ --force |
CUALQUIER comando denegado al usuario 'root'@'%' para la tabla ... | El usuario no tiene todos los permisos que necesita para esta operación. Prueba esto:
|
Mensaje de error | Solución de problemas |
---|---|
Solicitud incorrecta. | Este mensaje puede tener varias causas. Illegal Argument es una de las más comunes. En este caso, la solicitud utiliza un argumento incorrecto o un valor no válido. Para muchas otras causas, el mensaje de error puede contener una pista útil. En caso de |
Mensaje de error | Solución de problemas |
---|---|
No se pueden modificar los rangos asignados en CreateConnection. Utilice UpdateConnection. | Los emparejamientos de VPC no se actualizaron después de que se modificó o eliminó un rango asignado. Necesita modificar la conexión privada . Use el siguiente comando y asegúrese de usar el argumento gcloud services vpc-peerings update \ --network=VPC_NETWORK \ --ranges=ALLOCATED_RANGES \ --service=servicenetworking.googleapis.com \ --force |
Restricciones/sql.restrictAuthorizedNetworks. | La operación de clonación está bloqueada por la configuración Authorized Networks . Authorized Networks se configuran para direcciones IP públicas en la sección Conectividad del... Google Cloud consola y la clonación no está permitida debido a consideraciones de seguridad . Si es posible, elimine todas las entradas |
Mensaje de error | Solución de problemas |
---|---|
El disco está lleno. | El tamaño del disco de la instancia principal puede llenarse durante la creación de la réplica. Edite la instancia principal para actualizarla a un tamaño de disco más grande. |
Mensaje de error | Solución de problemas |
---|---|
Error al crear la subred. | No hay más direcciones disponibles en el rango de IP. No se encontraron bloques libres en los rangos de IP asignados. Por favor, asigne nuevos rangos a este proveedor de servicios. No hay más direcciones disponibles en el rango de IP asignado. Considere estos posibles escenarios:
Para cada uno de los escenarios anteriores, puede optar por ampliar el rango de IP existente o asignar un rango de IP adicional a la conexión de servicio privado. Si está asignando un nuevo rango, tenga cuidado de no crear una asignación que se superponga con ninguna asignación existente. Después de crear un nuevo rango de IP, actualice el emparejamiento de VPC con el siguiente comando: 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 Si amplía una asignación existente, asegúrese de aumentar únicamente el rango de asignación, no de reducirlo. Por ejemplo, si la asignación original era 10.0.10.0/24, la nueva asignación debe ser al menos 10.0.10.0/23. En general, si se parte de una asignación /24, una buena regla general es decrementar la máscara / en 1 por cada condición (grupo de tipos de instancia adicional, región adicional). Por ejemplo, si se intenta crear ambos grupos de tipos de instancia en la misma asignación, basta con pasar de /24 a /23. Después de expandir un rango de IP existente, actualice el emparejamiento de VPC con el siguiente comando: gcloud services vpc-peerings update \ --service=servicenetworking.googleapis.com --ranges=RESERVED_RANGE_NAME \ --network=VPC_NETWORK \ --project=PROJECT_ID \ --force |
Mensaje de error | Solución de problemas |
---|---|
(gcloud.sql.connect) Parece que su cliente no tiene conectividad IPv6 y la instancia de base de datos no tiene una dirección IPv4. | Estás intentando conectarte a tu instancia de IP privada mediante Cloud Shell. Actualmente no se admite la conexión desde Cloud Shell a una instancia con solo una dirección IP privada. |
Obtuve un paquete más grande que max_allowed_packet bytes al volcar la tabla. | El paquete era más grande de lo permitido por la configuración. Utilice Para obtener más información sobre el uso de indicadores |
Mensaje de error | Solución de problemas |
---|---|
InnoDB: La escritura en el archivo ./ibtmp1 falló en el desplazamiento XXXX, se deberían haber escrito YYYY bytes, solo se escribieron 0. | La instancia alcanzó un límite estricto al realizar una copia de seguridad automática. Comprueba que tu sistema operativo y sistema de archivos admitan archivos de este tamaño. Comprueba que el disco no esté lleno ni supere su cuota . Puedes solicitar un aumento de tus cuotas desde el Google Cloud consola o edite la instancia para actualizarla a un tamaño de disco más grande. |
Error interno. | Es posible que al proyecto le falte la cuenta de servicio de red de servicios requerida para esta función. Para reparar los permisos del servicio, deshabilite la |
Solicitud no válida: configuración de red de servicio incorrecta, por ejemplo. | Service Networking API no está habilitada en el proyecto. Habilite la |
Mensaje de error | Solución de problemas |
---|---|
Error en la asociación de red. | La Service Networking API no está habilitada en el proyecto. Habilite la |
Mensaje de error | Solución de problemas |
---|---|
La operación falló porque otra operación ya estaba en curso. | La mayoría de las operaciones en Cloud SQL son síncronas. Solo se puede ejecutar una a la vez. Espere a que finalice la operación anterior antes de comenzar otra. |
La operación no es válida para esta instancia. | Este error se devuelve desde una llamada API a instances.restoreBackup y significa que no se puede restaurar desde una copia de seguridad a una instancia con un tamaño de almacenamiento (XX GB) menor que el tamaño de la copia de seguridad (YY GB).Edite la instancia de destino para aumentar su tamaño de almacenamiento. |
Mensaje de error | Solución de problemas |
---|---|
Cuota excedida. | Has alcanzado el límite de tu cuota por minuto o diaria. Revisa las cuotas y los límites de Cloud SQL. Solicita un aumento a tus cuotas a la Google Cloud consola . |
Mensaje de error | Solución de problemas |
---|---|
Las ranuras de conexión restantes están reservadas. | Se han alcanzado las conexiones máximas permitidas. Aumente el valor del indicador |
A la solicitud le falta una clave API válida. | Es posible que no tenga un archivo JSON de clave de cuenta de servicio válido o que no esté almacenado en la ubicación esperada. Verifique que tenga un archivo JSON de clave de cuenta de servicio válido en la ubicación almacenada en la variable de entorno |
Mensaje de error | Solución de problemas |
---|---|
La clave especificada era demasiado larga; la longitud máxima de la clave es 767 bytes. | La instancia principal externa podría tener la variable innodb_large_prefix establecida. Establezca el indicador |
Error de SSL: relleno no válido. | Error de certificado del servidor. Cree un nuevo certificado de servidor y gírelo . |
Se produjo un error del sistema. |
Prueba estas cosas...
|
Mensaje de error | Solución de problemas |
---|---|
Se modificó la definición de la tabla. | Durante el proceso de exportación se produjo un cambio en la tabla. La transacción de volcado puede fallar si utiliza las siguientes declaraciones durante la operación de exportación:
Elimine cualquiera de estas declaraciones de la operación de volcado. |
La tabla db.table no existe | Si una o más tablas InnoDB desaparecieron después de reiniciar MySQL y el registro de errores de MySQL tiene las siguientes advertencias al mismo tiempo, se debe a que las columnas de clave externa y clave referenciada no están sincronizadas.[Warning] InnoDB: Load table db.table failed, the table has missing foreign key indexes. Turn off 'foreign_key_checks' and try again. [Warning] InnoDB: Cannot open table db/table from the internal data dictionary of InnoDB though the .frm file for the table exists. See InnoDB troubleshooting for more information. Tras reiniciar la base de datos, MySQL debe cargar las tablas en la caché del diccionario InnoDB en el primer acceso. Si detecta una discrepancia, bloquea el acceso a esa tabla. mysql> select * from db.table; ERROR 1146 (42S02): Table db.table doesn't exist Desactivar La falta de coincidencia de clave externa debe solucionarse para evitar problemas adicionales.
|
(Tiempo de espera) durante la exportación. | Los formatos CSV y SQL se exportan de forma diferente. El formato SQL incluye toda la base de datos y probablemente tarde más en completarse. Utilice el formato CSV y ejecute varios trabajos de exportación más pequeños para reducir el tamaño y la duración de cada operación. |
Demasiadas conexiones. | Configurar el indicador max_connections con un valor demasiado alto puede causar este error. Esto también puede deberse a la activación de un indicador fuera de secuencia. Reduzca el valor del indicador |
Mensaje de error | Solución de problemas | |
---|---|---|
x509: el certificado no es válido para ningún nombre. | Problema conocido: el marcador proxy de Cloud SQL no es compatible con Go 1.15 en este momento. Hasta que se solucione, consulte esta discusión en GitHub , que incluye una solución alternativa. |
Operación | El problema podría ser... | Cosas para probar... |
---|---|---|
Agregar usuario | Si el usuario ya existe en la base de datos, este error puede ocurrir cuando intenta agregarlo. | Verifique que el usuario no exista ya en la base de datos. |
Respaldo | Si ve esto durante las copias de seguridad automáticas o manuales, es probable que el disco de la instancia esté lleno. | Si el tamaño del archivo temporal ocupa demasiado espacio, puede reiniciar la instancia para eliminarlo y liberar espacio en disco. De lo contrario, podría necesitar ampliar el tamaño de disco de su instancia. |
Clon | Esto puede ocurrir cuando hay escasez de recursos en la zona seleccionada. | Pruebe en otra zona de la región o espere y vuelva a intentarlo más tarde. |
Crear instancia |
|
|
Crear réplica | Es probable que haya un error más específico en los archivos de registro. | Inspeccione los registros en Cloud Logging para encontrar el error real. Si el error indica que Si el error es |
Exportar | Si ve esto al intentar exportar una base de datos a un depósito de Cloud Storage, es posible que la transferencia falle debido a un problema de ancho de banda. | La instancia de Cloud SQL puede estar ubicada en una región distinta a la del bucket de Cloud Storage. Leer y escribir datos de un continente a otro implica un alto consumo de red y puede causar problemas intermitentes como este. |
Conmutación por error (heredada) | Si está utilizando la configuración de conmutación por error heredada, esto puede suceder cuando la máquina de réplica de conmutación por error no es lo suficientemente grande para manejar la conmutación por error. | La mejor solución es migrar a la configuración actual de alta disponibilidad . De lo contrario, deberá actualizar la réplica de conmutación por error a una máquina más grande. |
Conmutación por error (automática) | Una operación de conmutación por error automática puede producir este mensaje de error cuando el servicio detecta que la instancia principal aún responde. | En este caso, no hay nada que hacer. La conmutación por error no se producirá porque no es necesaria. |
Importar | El archivo de importación puede contener declaraciones que requieren el rol de superusuario. | Edite el archivo para eliminar cualquier declaración que requiera el rol de superusuario. |
Cloud SQL también utiliza binarios de terceros (por ejemplo, mysqld
), lo que puede generar mensajes de error desconocidos. Estos errores son internos a los binarios de terceros y quedan fuera del alcance de Cloud SQL. Sin embargo, a veces se puede encontrar un error más específico en los archivos de registro de Cloud SQL aproximadamente al mismo tiempo.
También, a veces se trata de un código de error desconocido. En este caso, el mensaje completo puede ser Unknown Error Code
.
A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-05-16 (UTC).