Solucionar problemas

Comprueba si tu pregunta o problema ya se ha tratado en alguna de las siguientes páginas:

En esta página se incluyen los temas siguientes:

Copia de seguridad y sistema de recuperación

Problema Solución de problemas
No puedes ver el estado de la operación actual. La consola Google Cloud solo informa si la operación se ha realizado correctamente o no. No está diseñado para mostrar advertencias ni otras actualizaciones.

Ejecuta el comando gcloud sql operations list para enumerar todas las operaciones de la instancia de Cloud SQL especificada.
Quieres saber quién ha emitido una operación de copia de seguridad bajo demanda. La interfaz de usuario no muestra el usuario que ha iniciado una operación.

Consulta los registros y filtra por texto para encontrar al usuario. Es posible que tengas que usar registros de auditoría para información privada. Entre los archivos de registro pertinentes se incluyen los siguientes:

  • cloudsql.googleapis.com/postgres.log
  • Si Registros de auditoría de Cloud está habilitado y tienes los permisos necesarios para verlos, también puede estar disponible cloudaudit.googleapis.com/activity.
Una vez que se elimina una instancia, no se puede crear una copia de seguridad de ella.

Si eliminas una instancia sin crear una copia de seguridad final de los datos, no podrás recuperarlos. Sin embargo, si restauras la instancia, Cloud SQL también restaurará las copias de seguridad. Para obtener más información sobre cómo recuperar una instancia eliminada, consulta Conservar copias de seguridad después de eliminar una instancia.

Si has realizado una operación de exportación, crea una instancia y, a continuación, realiza una operación de importación para volver a crear la base de datos. Las exportaciones se escriben en Cloud Storage y las importaciones se leen desde allí.
Una copia de seguridad automática se queda bloqueada durante muchas horas y no se puede cancelar. Las copias de seguridad pueden tardar mucho tiempo en función del tamaño de la base de datos.

Si realmente necesitas cancelar la operación, puedes pedir al servicio de asistencia que force restart la instancia.
Una operación de restauración puede fallar si no existen uno o varios de los usuarios a los que se hace referencia en el archivo de volcado SQL. Antes de restaurar un volcado de SQL, todos los usuarios de bases de datos que sean propietarios de objetos o a los que se les hayan concedido permisos sobre objetos de la base de datos de volcado deben existir en la base de datos de destino. Si no es así, la operación de restauración no podrá recrear los objetos con la propiedad o los permisos originales.

Crea los usuarios de la base de datos antes de restaurar el volcado de SQL.
Quieres aumentar el número de días que puedes conservar las copias de seguridad automáticas de 7 a 30 días o más. Puedes configurar el número de copias de seguridad automatizadas que se conservarán, de 1 a 365. Las copias de seguridad automáticas se eliminan periódicamente en función del valor de conservación configurado. Por desgracia, esto significa que las copias de seguridad que se muestran son las únicas copias de seguridad automáticas que puedes restaurar.

Para conservar las copias de seguridad indefinidamente, puedes crear una copia de seguridad bajo demanda, ya que no se eliminan de la misma forma que las copias de seguridad automatizadas. Las copias de seguridad bajo demanda se conservan indefinidamente. Es decir, permanecen hasta que se eliminan o se elimina la instancia a la que pertenecen. Como este tipo de copia de seguridad no se elimina automáticamente, puede afectar a la facturación.
Se ha producido un error en una copia de seguridad automática y no has recibido ninguna notificación por correo electrónico. Para que Cloud SQL te notifique el estado de la copia de seguridad, configura una alerta basada en registros.
Una instancia falla repetidamente porque alterna entre los estados de error y de restauración de la copia de seguridad. Los intentos de conexión y uso de la base de datos después de la restauración fallan.
  • Puede que haya demasiadas conexiones abiertas. Si hay demasiadas conexiones, puede deberse a errores que se producen en medio de una conexión en la que no hay ajustes de autovacuum para limpiar las conexiones inactivas.
  • Los ciclos pueden producirse si algún código personalizado usa una lógica de reintento que no se detiene después de varios errores.
  • Puede que haya demasiado tráfico. Usa la agrupación de conexiones y otras prácticas recomendadas para la conectividad.

Puedes probar a realizar lo siguiente:

  1. Verifica que la base de datos esté configurada para autovacuum.
  2. Comprueba si hay alguna lógica de reintento de conexión configurada en el código personalizado.
  3. Reduce el tráfico hasta que la base de datos se recupere y, a continuación, aumenta el tráfico lentamente.
Faltan datos al realizar una operación de copia de seguridad o restauración. Las tablas se han creado sin registrar. Por ejemplo:

CREATE UNLOGGED TABLE ....

Estas tablas no se incluyen en una restauración a partir de una copia de seguridad:

  • El contenido de las tablas sin registrar no se conserva en caso de conmutación por error en una instancia de alta disponibilidad.
  • Las tablas sin registrar no sobreviven a los fallos de PostgreSQL.
  • Las tablas sin registrar no se replican en las réplicas de lectura.
  • Las tablas sin registrar se borran automáticamente durante la restauración de la copia de seguridad.

La solución es evitar el uso de tablas sin registrar si quieres restaurarlas a partir de una copia de seguridad. Si vas a restaurar una base de datos que ya tiene tablas sin registrar, puedes volcar la base de datos en un archivo y volver a cargar los datos después de modificar el archivo volcado de ALTER TABLE a SET LOGGED en esas tablas.
No se puede eliminar una instancia cuando se elige hacer una copia de seguridad final al eliminar la instancia. Cuando eliminas una instancia, debes confirmar si quieres hacer una copia de seguridad final de la instancia antes de eliminarla. Si has habilitado la copia de seguridad final mediante el ajuste de instancia final-backup, la selección que hagas al eliminar la instancia debe coincidir con la configuración de la instancia de copia de seguridad final que hayas definido al habilitar la copia de seguridad final de la instancia. Para mitigar este problema, haz una de las siguientes acciones:
  • Define el valor de la copia de seguridad final para que coincida con la configuración de la copia de seguridad de la instancia.
  • Deja vacío el campo de copia de seguridad final cuando elimines la instancia. Si dejas el campo vacío, Cloud SQL tomará la configuración final de la copia de seguridad establecida en los ajustes de la instancia para crear una copia de seguridad final y definir su retención.
Para ver la configuración final de la instancia de copia de seguridad de tu instancia, consulta Ver información de instancias.
No se puede crear una instancia réplica después de crear correctamente una instancia principal con la configuración de copia de seguridad final. Si creas una instancia con el ajuste de instancia de copia de seguridad final habilitado, debes actualizar la política de organización de copia de seguridad final para aplicar las configuraciones de copia de seguridad solo a la instancia principal. Las copias de seguridad finales no se admiten en las instancias réplica.
Para obtener más información, consulta las políticas de organización de Cloud SQL.

Cancelar importaciones y exportaciones

Problema Solución de problemas
Mensaje de error: You can't cancel operation [operation-ID] because this operation isn't in progress.

Estás intentando cancelar una operación de importación o exportación que se ha completado, ha fallado o se ha cancelado. Si la operación está en curso, puedes cancelarla.
Mensaje de error: You can't cancel operation [operation-ID] because Cloud SQL doesn't support the cancellation of an [operation-type] operation.

Cloud SQL no admite la cancelación de la operación porque tiene un tipo de operación distinto de IMPORT o EXPORT.
Mensaje de error: The [operation-type] operation isn't cancelled. Wait and retry in a few seconds.

Cloud SQL no puede cancelar la operación de importación o exportación en este momento. Inténtalo de nuevo en unos segundos. Si el problema persiste, ponte en contacto con el equipo de Google Cloud Asistencia.

Clonar

Problema Solución de problemas
La clonación falla y se produce el error constraints/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 de la consola Google Cloud y no se permite la clonación por motivos de seguridad.

Elimina todas las entradas Authorized Networks de la instancia de Cloud SQL, si es posible. De lo contrario, crea una réplica sin ninguna entrada Authorized Networks.
Mensaje de error: Failed to create subnetwork. Couldn't find free blocks in allocated IP ranges. Please allocate new ranges for this service provider. Help Token: [help-token-id].

Estás intentando usar la consola Google Cloud para clonar una instancia con una dirección IP privada, pero no has especificado el intervalo de IP asignado que quieres usar y la instancia de origen no se ha creado con el intervalo especificado. Por lo tanto, la instancia clonada se crea en un intervalo aleatorio.

Usa gcloud para clonar la instancia y proporciona un valor para el parámetro
--allocated-ip-range-name. Para obtener más información, consulta Clonar una instancia con una IP privada.

Conectar

Problema Solución de problemas
Aborted connection. El problema puede deberse a lo siguiente:
  • Inestabilidad de la red.
  • No se ha recibido ninguna respuesta a los comandos de mantenimiento activo de TCP (el cliente o el servidor no responden, posiblemente porque están sobrecargados).
  • Se ha superado el tiempo de vida de la conexión del motor de la base de datos y el servidor finaliza la conexión.

Las aplicaciones deben tolerar los fallos de red y seguir las prácticas recomendadas, como la agrupación de conexiones y los reintentos. La mayoría de los agrupadores de conexiones detectan estos errores cuando es posible. De lo contrario, la aplicación debe volver a intentarlo o fallar correctamente.

Para reintentar la conexión, te recomendamos los siguientes métodos:

  1. Tiempo de espera exponencial. Aumenta el intervalo de tiempo entre cada reintento de forma exponencial.
  2. Añade también un retroceso aleatorio.

La combinación de estos métodos ayuda a reducir la limitación.
Certificate verify failed.

Los certificados de cliente han caducado o la ruta a los certificados no es correcta.

Vuelve a crear los certificados.
FATAL: database 'user' does not exist. gcloud sql connect --user solo funciona con el usuario postgres predeterminado.

Conéctate con el usuario predeterminado y, a continuación, cambia de usuario.
Quieres saber quién está conectado. Inicia sesión en la base de datos y ejecuta este comando: 

SELECT datname,
usename,
application_name as appname,
client_addr,
state,
now() - backend_start as conn_age,
now() - state_change as last_activity_age
FROM pg_stat_activity
WHERE backend_type = 'client backend'
ORDER BY 6 DESC
LIMIT 20

Hostname/IP does not match certificate's altnames: Host: localhost. is not in the cert's altnames.

La dirección del host no coincide con la dirección de los nombres alternativos del certificado del servidor.

Si usas Node.js con verify-full o su equivalente, utiliza el nombre DNS del parámetro servername. El nombre de DNS se puede encontrar en el certificado del servidor mediante openssl. Por ejemplo, openssl x509 -in server-cert.pem -noout -text |grep 'DNS:'.

 ssl: {
  rejectUnauthorized: true,
  ca: fs.readFileSync("/path/to/server/CA"),
  servername: 'N-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx.us-central1.sql.goog'
}

Crear instancias

Problema Solución de problemas
Mensaje de error: Failed to create subnetwork. Couldn't find free blocks in allocated IP ranges. Please allocate new ranges for this service provider. No hay más direcciones disponibles en el intervalo de IP asignado. Puede haber varios casos posibles:

  • El tamaño del intervalo de IPs asignado a la conexión de servicio privada es inferior a /24.
  • El tamaño del intervalo de IPs asignado a la conexión de servicio privada es demasiado pequeño para el número de instancias de Cloud SQL.
  • El requisito sobre el tamaño del intervalo de IPs asignado será mayor si se crean instancias en varias regiones. Consulta el tamaño del intervalo asignado.

Para solucionar este problema, puedes ampliar el intervalo de IP asignado o asignar un intervalo de IP adicional a la conexión de servicio privada. Para obtener más información, consulta Asignar un intervalo de direcciones IP.

Si has usado la marca --allocated-ip-range-name al crear la instancia de Cloud SQL, solo podrás ampliar el intervalo de direcciones IP especificado.

Si asignas un intervalo nuevo, asegúrate de que no se solape con ninguna asignación.

Después de crear un intervalo de IP, actualiza el peering 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, asegúrese de aumentar solo el intervalo de asignación y 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.

Por lo general, si empiezas con una asignación /24, es recomendable reducir la /máscara en 1 por cada condición (grupo de tipos de instancia adicional o región adicional). Por ejemplo, si intentas crear dos grupos de tipos de instancia en la misma asignación, es suficiente con pasar de /24 a /23.

Después de ampliar un intervalo de IPs, actualiza el peering 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
Mensaje de error: Failed to create subnetwork. Router status is temporarily unavailable. Please try again later. Help Token: [token-ID]. Intenta crear de nuevo la instancia de Cloud SQL.
Mensaje de error: HTTPError 400: Invalid request: Incorrect Service Networking config for instance: PROJECT_ID:INSTANCE_NAME:SERVICE_NETWORKING_NOT_ENABLED.

Habilita la API Service Networking con el siguiente comando e intenta crear la instancia de Cloud SQL de nuevo.

gcloud services enable servicenetworking.googleapis.com \
--project=PROJECT_ID
Mensaje de error: Failed to create subnetwork. Required 'compute.projects.get' permission for PROJECT_ID. Cuando creas una instancia con una dirección IP privada, se crea una cuenta de servicio en el momento oportuno mediante la API Service Networking. Si has habilitado la API Service Networking hace poco, es posible que no se cree la cuenta de servicio y que falle la creación de la instancia. En este caso, debes esperar a que la cuenta de servicio se propague por todo el sistema o añadirla manualmente con los permisos necesarios.
Mensaje de error: More than 3 subject alternative names are not allowed. Estás intentando usar un SAN personalizado para añadir más de tres nombres DNS al certificado de servidor de una instancia de Cloud SQL. No puedes añadir más de tres nombres de DNS a la instancia.
Mensaje de error: Subject alternative names %s is too long. The maximum length is 253 characters. Asegúrate de que los nombres DNS que quieras añadir al certificado de servidor de una instancia de Cloud SQL no tengan más de 253 caracteres.
Mensaje de error: Subject alternative name %s is invalid.

Comprueba que los nombres DNS que quieres añadir al certificado de servidor de una instancia de Cloud SQL cumplen los siguientes criterios:

  • No tienen caracteres comodín.
  • No tienen puntos finales.
  • Cumplen las especificaciones de RFC 1034.

Exportar

Problema Solución de problemas
HTTP Error 409: Operation failed because another operation was already in progress. Ya hay una operación pendiente en tu instancia. Solo se puede realizar una operación a la vez. Prueba a enviar la solicitud después de que se complete la operación en curso.
HTTP Error 403: The service account does not have the required permissions for the bucket. Asegúrate de que el segmento exista y de que la cuenta de servicio de la instancia de Cloud SQL (que realiza la exportación) tenga el rol Storage Object Creator (roles/storage.objectCreator) para permitir la exportación al segmento. Consulta los roles de gestión de identidades y accesos para Cloud Storage.
La exportación a CSV ha funcionado, pero la exportación a SQL ha fallado. Los formatos CSV y SQL se exportan de forma diferente. El formato SQL exporta toda la base de datos y es probable que tarde más en completarse. El formato CSV te permite definir qué elementos de la base de datos quieres incluir en la exportación.

Usa las exportaciones de CSV para exportar solo lo que necesites.
La exportación tarda demasiado. Cloud SQL no admite operaciones síncronas simultáneas.

Usa la transferencia de exportación. A grandes rasgos, en la descarga de exportaciones, en lugar de emitir una exportación en la instancia de origen, Cloud SQL crea una instancia de descarga para realizar la exportación. La descarga de exportaciones tiene varias ventajas, como un mayor rendimiento en la instancia de origen y la posibilidad de realizar operaciones administrativas mientras se ejecuta la exportación. Con la transferencia de la exportación, la latencia total puede aumentar en el tiempo que se tarda en activar la instancia de transferencia. Por lo general, en el caso de las exportaciones de tamaño razonable, la latencia no es significativa. Sin embargo, si la exportación es lo suficientemente pequeña, es posible que notes el aumento de la latencia.
Error al crear la extensión. El archivo de volcado contiene referencias a una extensión no admitida.

Edita el archivo de volcado para quitar las referencias.
Error al usar pg_dumpall. Para usar la utilidad pg_dumpall con la marca --global, se necesita el rol de superusuario, pero este rol no se admite en Cloud SQL para PostgreSQL. Para evitar que se produzcan errores al realizar operaciones de exportación que incluyan nombres de usuario, usa también la marca --no-role-passwords.
La operación de exportación se agota antes de exportar nada y aparece el mensaje de error Could not receive data from client: Connection reset by peer. Si Cloud Storage no recibe ningún dato en un periodo determinado (normalmente, unos siete minutos), la conexión se restablece. Es posible que la consulta de exportación inicial tarde demasiado en ejecutarse.

Haz una exportación manual con la pg_dump.
Quieres que las exportaciones se automaticen. Cloud SQL no ofrece ninguna forma de automatizar las exportaciones.

Puedes crear tu propio sistema de exportación automatizado con productos como Cloud Scheduler, Pub/Sub y funciones de Cloud Run, de forma similar a lo que se explica en este artículo sobre la automatización de copias de seguridad. Google Cloud

Banderas

Problema Solución de problemas
Defines la zona horaria de una sesión, pero caduca cuando cierras sesión.

Conéctate a la base de datos y define la zona horaria que quieras, ya sea por usuario o por base de datos.

En Cloud SQL para PostgreSQL, puede especificar lo siguiente. Estos ajustes se conservan después de cerrar una sesión, lo que simula una configuración de .conf:

ALTER DATABASE dbname SET TIMEZONE TO 'timezone';
ALTER USER username SET TIMEZONE TO 'timezone';

Estos ajustes solo se aplican a las nuevas conexiones a la base de datos. Para ver el cambio de zona horaria, desconéctate de la instancia y vuelve a conectarte.

Alta disponibilidad

Problema Solución de problemas
No encuentras las métricas de una conmutación por error manual. Solo se incluyen en las métricas las conmutaciones por error automáticas.
Los recursos de la instancia de Cloud SQL (CPU y RAM) están cerca del 100% de uso, lo que provoca que la instancia de alta disponibilidad deje de funcionar. El tamaño de la máquina de la instancia es demasiado pequeño para la carga.

Edita la instancia para cambiar a un tamaño de máquina mayor y obtener más CPUs y memoria.

Importar

Problema Solución de problemas
Mensaje de error: permission denied for schema public En las versiones 15 y posteriores de PostgreSQL, si la base de datos de destino se crea a partir de template0, es posible que no se puedan importar datos. Para solucionar este problema, proporcione privilegios de esquema público al usuario cloudsqlsuperuser ejecutando el comando SQL GRANT ALL ON SCHEMA public TO cloudsqlsuperuser.
HTTP Error 409: Operation failed because another operation was already in progress. Ya hay una operación pendiente en tu instancia. Solo se puede realizar una operación a la vez. Prueba a enviar la solicitud después de que se complete la operación en curso.
La operación de importación está tardando demasiado. Demasiadas conexiones activas pueden interferir en las operaciones de importación.

Cierra las operaciones que no se utilicen. Comprueba el uso de CPU y memoria de tu instancia de Cloud SQL para asegurarte de que hay suficientes recursos disponibles. La mejor forma de asegurarte de que dispones del número máximo de recursos para llevar a cabo la importación es reiniciar la instancia antes de comenzar la operación.

Reiniciar:

  • Cierra todas las conexiones.
  • Finaliza las tareas que puedan estar consumiendo recursos.
Una operación de importación puede fallar cuando no existen uno o varios de los usuarios a los que se hace referencia en el archivo de volcado. Antes de importar un archivo de volcado, todos los usuarios de bases de datos que sean propietarios de objetos o a los que se les hayan concedido permisos sobre objetos de la base de datos de volcado deben existir en la base de datos de destino. Si no lo hacen, la operación de importación no podrá volver a crear los objetos con la propiedad o los permisos originales.

Crea los usuarios de la base de datos antes de importar.
Después de importar datos, el tamaño del uso del disco de datos es mucho mayor.

Puede que se produzca un uso de disco inesperado después de importar datos. Este uso puede deberse a que se ha usado la recuperación a un momento dado.

Para solucionar este problema, después de importar los datos, inhabilita la recuperación a un momento dado si quieres eliminar los registros y recuperar el almacenamiento. Ten en cuenta que, al reducir el almacenamiento utilizado, no se reduce el tamaño del almacenamiento aprovisionado para la instancia.
Mensaje de error: GRANT stderr: ERROR: must be member of role ROLE_NAME

Este mensaje de error aparece si intentas importar un archivo de volcado de SQL que se ha subido a Cloud Storage a una base de datos de Cloud SQL y la tarea de importación se ha ejecutado durante unos cuatro días.

ROLE_NAME es un rol de base de datos personalizado definido en la base de datos de origen de PostgreSQL. El usuario cloudsqlsuperuser predeterminado importa el archivo de volcado de SQL. Sin embargo, es posible que este usuario no tenga el rol ROLE_NAME.

Para solucionar este problema, siga estos pasos:

  1. Crea el rol ROLE_NAME en la base de datos de destino a la que vas a importar el archivo de volcado de SQL.

  2. No uses el usuario cloudsqlsuperuser para importar el archivo. En su lugar, en la base de datos de destino, especifica un usuario que sea miembro del rol ROLE_NAME. Para especificar el usuario, ejecuta el siguiente comando:

    gcloud sql import sql INSTANCE URI [--async]
    [--database=DATABASE, -d DATABASE] [--user=USER] [GCLOUD_WIDE_FLAG …]

Integración con Vertex AI

Problema Solución de problemas
Mensaje de error: Google ML integration API is supported only on Postgres version 12 or above. Para habilitar la integración de Vertex AI en Cloud SQL, debes tener una base de datos de Cloud SQL para PostgreSQL con la versión 12 o posterior. Para actualizar tu base de datos a esta versión, consulta Actualizar la versión principal de la base de datos in situ.
Mensaje de error: Google ML Integration API is not supported on shared core instance. Please upsize your machine type. Si has seleccionado un núcleo compartido para el tipo de máquina de tu instancia, no podrás habilitar la integración de Vertex AI en Cloud SQL. Cambia el tipo de máquina a núcleo dedicado. Para obtener más información, consulta Tipo de máquina.
Mensaje de error: Google ML Integration is unsupported for this maintenance version. Please follow https://cloud.google.com/sql/docs/postgres/self-service-maintenance to update the maintenance version of the instance. Para habilitar la integración de Vertex AI en Cloud SQL, la versión de mantenimiento de tu instancia debe ser R20240130 o posterior. Para actualizar tu instancia a esta versión, consulta Mantenimiento de autoservicio.
Mensaje de error: Cannot invoke ml_predict_row if 'cloudsql.enable_google_ml_integration' is off. La cloudsql.enable_google_ml_integration marca de base de datos está desactivada. Cloud SQL no se puede integrar con Vertex AI.

Para activar esta marca, usa el comando gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME --database-flags cloudsql.enable_google_ml_integration=on

Sustituye INSTANCE_NAME por el nombre de la instancia principal de Cloud SQL.
Mensaje de error: Failed to connect to remote host: Connection refused. La integración entre Cloud SQL y Vertex AI no está habilitada. Para habilitar esta integración, usa el comando gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME
--enable-google-ml-integration

Sustituye INSTANCE_NAME por el nombre de la instancia principal de Cloud SQL.
Mensaje de error: Vertex AI API has not been used in project PROJECT_ID before or it is disabled. Enable it by visiting /apis/api/aiplatform.googleapis.com/overview?project=PROJECT_ID then retry. La API de Vertex AI no está habilitada. Para obtener más información sobre cómo habilitar esta API, consulta Habilitar la integración de bases de datos con Vertex AI.
Mensaje de error: Permission 'aiplatform.endpoints.predict' denied on resource. Los permisos de Vertex AI no se añaden a la cuenta de servicio de Cloud SQL del proyecto en el que se encuentra la instancia de Cloud SQL. Para obtener más información sobre cómo añadir estos permisos a la cuenta de servicio, consulta Habilitar la integración de la base de datos con Vertex AI.
Mensaje de error: Publisher Model `projects/PROJECT_ID/locations/REGION_NAME/publishers/google/models/MODEL_NAME` not found. El modelo de aprendizaje automático o el LLM no existen en Vertex AI.
Mensaje de error: Resource exhausted: grpc: received message larger than max. El tamaño de la solicitud que Cloud SQL envía a Vertex AI supera el límite de gRPC de 4 MB por solicitud.
Mensaje de error: Cloud SQL attempts to send a request to Vertex AI. However, the instance is in the %s region, but the Vertex AI endpoint is in the %s region. Make sure the instance and endpoint are in the same region. Cloud SQL intenta enviar una solicitud a Vertex AI. Sin embargo, la instancia está en una región, pero el endpoint de Vertex AI está en otra. Para solucionar este problema, tanto la instancia como el endpoint deben estar en la misma región.
Mensaje de error: The Vertex AI endpoint isn't formatted properly. El endpoint de Vertex AI no tiene el formato correcto. Para obtener más información, consulta Usar puntos finales privados para la predicción online.
Mensaje de error: Quota exceeded for aiplatform.googleapis.com/online_prediction_requests_per_base_model with base model: textembedding-gecko. El número de solicitudes que Cloud SQL envía a Vertex AI supera el límite de 1500 solicitudes por minuto, región, modelo y proyecto.

Almacenamiento de registros

Problema Solución de problemas
El registro usa mucha CPU y memoria en tu instancia de Cloud SQL. Es necesario ajustar el registro.

La marca log_statement se puede definir como none y la marca logging_collector se puede definir como off. Si sigue registrándose información, puede que haya otras marcas relacionadas con los registros que se puedan ajustar. Puedes editar la instancia para modificar estas marcas.
No se encuentran los registros de auditoría. Los registros de acceso a datos solo se escriben si la operación es una llamada a la API autenticada por el usuario que crea, modifica o lee datos creados por el usuario, o si la operación accede a archivos de configuración o metadatos de recursos.
No se encuentra información de las operaciones en los registros. Quieres obtener más información sobre una operación.

Por ejemplo, se ha eliminado un usuario, pero no sabes quién lo ha hecho. Los registros muestran que la operación se ha iniciado, pero no proporcionan más información. Para registrar información personal identificable (IPI) detallada como esta, debes habilitar el registro de auditoría.
Los archivos de registro son difíciles de leer. Prefieres ver los registros como JSON o texto.Puedes usar el comando gcloud logging read junto con los comandos de posprocesamiento de Linux para descargar los registros.

Para descargar los registros como JSON, sigue estos pasos:

gcloud logging read \
"resource.type=cloudsql_database \
AND logName=projects/PROJECT_ID \
/logs/cloudsql.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d" \
> downloaded-log.json

Para descargar los registros como TEXTO:

gcloud logging read \
"resource.type=cloudsql_database \
AND logName=projects/PROJECT_ID \
/logs/cloudsql.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d"| jq -rnc --stream 'fromstream(1|truncate_stream(inputs)) \
| .textPayload' \
--order=asc
> downloaded-log.txt
Los registros de consultas no se encuentran en los registros de PostgreSQL. Debes habilitar las marcas pgaudit.
  1. Desde un terminal, conéctate a tu base de datos: 
    gcloud sql connect INSTANCE_NAME
  2. Ejecuta este comando para crear la extensión: 
    CREATE EXTENSION pgaudit;
  3. Sal de la base de datos y, desde un terminal, ejecuta el siguiente comando: 
    gcloud sql instances patch INSTANCE_NAME \
--database-flags=cloudsql.enable_pgaudit=on,pgaudit.log=all

Gestionar instancias

Problema Solución de problemas
Quieres saber qué consultas se están ejecutando ahora. Conéctate a la base de datos y ejecuta la siguiente consulta:

SELECT datname, usename, application_name as appname, client_addr, state, now() - backend_start as conn_age, now() - xact_start as xact_age, now() - query_start as query_age, now() - state_change as last_activity_age, wait_event_type, wait_event, query FROM pg_stat_activity WHERE state <> 'idle' ORDER BY 8 DESC LIMIT 20;

Quieres saber qué unidades se están usando en un campo específico. Conéctate a la base de datos y ejecuta la siguiente consulta (con tu propio FIELD_NAME):

SELECT name, setting, unit FROM pg_settings WHERE name = 'FIELD_NAME'.
Quieres encontrar el valor actual de un ajuste de la base de datos. Conéctate a la base de datos y ejecuta la siguiente consulta (con tu propio SETTING_NAME):

SHOW SETTING_NAME;

Ejecuta SHOW ALL; para ver todos los ajustes.
Quieres detener un proceso en segundo plano bloqueado. El usuario debe tener el rol pg_signal_backend.

Ejecuta estos comandos:

  1.       GRANT pg_signal_backend TO USERNAME;
  2. Busca el ID del proceso bloqueado o atascado: 
          SELECT pid, usename, state, query FROM pg_stat_activity;
  3. Detén un proceso en ejecución o inactivo con estos comandos: 
          SELECT pg_cancel_backend(pid)
            FROM pg_stat_activity
            WHERE usename = 'USERNAME';
      
      
          SELECT pg_terminate_backend(pid)
            FROM pg_stat_activity
            WHERE usename = 'USERNAME';
La instancia está a punto de consumir el 100% de los IDs de transacción. Tu monitorización interna te avisa de que la instancia se acerca al 100 % del consumo de IDs de transacción. Quieres evitar que las transacciones se repitan, lo que puede bloquear las escrituras.

Es posible que el trabajo de autovacuum esté bloqueado o que no esté reclamando los IDs de transacción lo suficientemente rápido como para mantener el ritmo de la carga de trabajo.

Para evitar interrupciones debido al problema de la envoltura de transacciones, puedes consultar estos consejos de autoservicio para solucionar la envoltura del TXID.

Para obtener consejos generales sobre la optimización, consulta Optimizar, monitorizar y solucionar problemas de operaciones VACUUM en PostgreSQL.
El almacenamiento temporal ha aumentado el almacenamiento automático. El almacenamiento automático está habilitado.

Al reiniciar, se eliminan los archivos temporales, pero no se reduce el almacenamiento. Solo el equipo de Asistencia puede restablecer el tamaño de la instancia.
Los datos se están eliminando automáticamente. Lo más probable es que se esté ejecutando una secuencia de comandos en algún lugar de tu entorno.

Busca en los registros la hora en la que se produjo la eliminación y comprueba si hay una secuencia de comandos no autorizada que se esté ejecutando desde un panel de control u otro proceso automatizado.
No se puede eliminar la instancia. Es posible que veas el mensaje de error ERROR: (gcloud.sql.instances.delete) HTTP Error 409: The instance or operation is not in an appropriate state to handle the request o que la instancia tenga el estado de la marca INSTANCE_RISKY_FLAG_CONFIG.

Algunas explicaciones posibles son las siguientes:

  • Hay otra operación en curso. Las operaciones de Cloud SQL no se ejecutan simultáneamente. Espera a que se complete la otra operación.
  • La advertencia INSTANCE_RISKY_FLAG_CONFIG se activa siempre que se utilice al menos una marca beta. Quita la configuración de la marca peligrosa y reinicia la instancia.
La instancia se ha bloqueado debido al gran tamaño de los datos temporales. El sistema puede crear muchas tablas temporales a la vez, en función de las consultas y la carga.

Lamentablemente, no puedes reducir el tamaño del archivo ibtmp1 de ninguna otra forma que no sea reiniciando el servicio.

Una opción de mitigación es crear la tabla temporal con ROW_FORMAT=COMPRESSED para que se almacene en espacios de tablas de archivo por tabla en el directorio de archivos temporales. Sin embargo, el inconveniente es el coste de rendimiento asociado a la creación y eliminación de un espacio de tabla por archivo para cada tabla temporal.
Error fatal durante la actualización. Los registros pueden revelar más información, pero, en cualquier caso, es posible que necesites la ayuda del servicio de asistencia para forzar la recreación de la instancia.
La instancia se queda bloqueada al reiniciarse después de quedarse sin espacio en disco. La función de aumento automático del almacenamiento no está habilitada.

Si tu instancia se queda sin almacenamiento y la función de aumento automático del almacenamiento no está habilitada, la instancia se desconectará. Para evitar este problema, puedes editar la instancia para habilitar el aumento automático del almacenamiento.
Tu instancia principal local está bloqueada. Google Cloud no puede ayudarte con las instancias que no están en Cloud SQL.
El dispositivo se apaga lentamente al reiniciarse. Cuando una instancia se cierra, las conexiones pendientes que no finalicen en un plazo de 60 segundos hacen que el cierre no sea limpio.

Si las conexiones duran menos de 60 segundos, se pueden evitar la mayoría de los cierres incorrectos, incluidas las conexiones desde el símbolo del sistema de la base de datos. Si mantienes estas conexiones abiertas durante horas o días, los cierres pueden no ser limpios.
No se puede eliminar un usuario. Es probable que el usuario tenga objetos en la base de datos que dependan de ella. Debes eliminar esos objetos o reasignarlos a otro usuario.

Averigua qué objetos dependen del usuario y, a continuación, elimina o reasigna esos objetos a otro usuario.

En este hilo de Stack Exchange se explica cómo encontrar los objetos que pertenecen al usuario.
Algunas consultas concretas se ejecutan con lentitud. Las consultas pueden ser lentas por muchos motivos, principalmente debido a aspectos específicos de la base de datos. Una de las razones que pueden implicar a Cloud SQL es la latencia de la red, cuando el recurso de origen (escritor o lector) y el recurso de destino (Cloud SQL) están en regiones diferentes.

Consulta en concreto los consejos generales sobre el rendimiento.

Si las inserciones, actualizaciones o eliminaciones de bases de datos son lentas, puedes probar lo siguiente:

  • Comprueba las ubicaciones del escritor y de la base de datos. Si los datos se envían a una distancia larga, se produce latencia.
  • Comprueba la ubicación del lector y de la base de datos, ya que la latencia afecta al rendimiento de lectura incluso más que al de escritura.

Para reducir la latencia, se recomienda ubicar los recursos de origen y de destino en la misma región.
Se indica que no hay memoria suficiente, pero los gráficos de monitorización no lo muestran. Una instancia puede fallar e informar de Out of memory, pero los gráficos de la consola Google Cloud o de Cloud Monitoring pueden mostrar que aún queda memoria.

Además de la carga de trabajo, hay otros factores que pueden influir en el uso de la memoria, como el número de conexiones activas y los procesos internos. Estas no siempre se reflejan en los gráficos de monitorización.

Asegúrate de que la instancia tenga suficiente margen para tu carga de trabajo, además de un margen adicional.
Recuperar una instancia eliminada. Todos los datos de una instancia, incluidas las copias de seguridad, se pierden de forma permanente cuando se elimina esa instancia.

Para conservar tus datos, expórtalos a Cloud Storage antes de eliminar una instancia.

El rol Administrador de Cloud SQL incluye el permiso para eliminar la instancia. Para evitar que se eliminen por error, asigna este rol solo cuando sea necesario.
Quieres cambiar el nombre de una instancia de Cloud SQL. No se puede cambiar el nombre de una instancia.

Hay otras formas de conseguir el objetivo creando una instancia.

  • Puedes clonar la instancia cuyo nombre quieras cambiar y asignarle un nombre nuevo a la instancia clonada. De esta forma, puede crear la nueva instancia sin tener que importar datos manualmente. Al igual que cuando se crea una instancia, la instancia clonada tiene una dirección IP nueva.
  • Puedes exportar datos de tu instancia a un segmento de Cloud Storage, crear una instancia con el nombre que quieras y, a continuación, importar los datos a la nueva instancia.

En ambos casos, puedes eliminar la instancia antigua una vez que se haya completado la operación. Te recomendamos que elijas la opción de clonación, ya que no afecta al rendimiento y no requiere que vuelvas a configurar los ajustes de la instancia, como las marcas, el tipo de máquina, el tamaño del almacenamiento y la memoria.
Error al eliminar una instancia. Si la protección contra la eliminación está habilitada en una instancia, confirma que quieres eliminarla. A continuación, inhabilitar la protección contra la eliminación antes de eliminar la instancia.

Private Service Connect
Problema Solución de problemas
La vinculación de servicio de la instancia no acepta el endpoint de Private Service Connect.
  1. Comprueba el estado del endpoint.

    gcloud

    Para comprobar el estado, usa el comando
    gcloud compute forwarding-rules describe.

    gcloud compute forwarding-rules describe ENDPOINT_NAME \
--project=PROJECT_ID \
--region=REGION_NAME \
| grep pscConnectionStatus

    Haz las siguientes sustituciones:

    • ENDPOINT_NAME: el nombre del endpoint
    • PROJECT_ID: el ID o el número de proyecto del Google Cloud proyecto que contiene el endpoint.
    • REGION_NAME: nombre de la región del endpoint

    REST

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID o el número de proyecto del Google Cloud proyecto que contiene el endpoint de Private Service Connect
    • REGION_NAME: el nombre de la región
    • ENDPOINT_NAME: el nombre del endpoint

    Método HTTP y URL: 

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/forwardingRules/ENDPOINT_NAME

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

    {
  "kind": "compute#forwardingRule",
  "id": "ENDPOINT_ID",
  "creationTimestamp": "2024-05-09T12:03:21.383-07:00",
  "name": "ENDPOINT_NAME",
  "region": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME",
  "IPAddress": "IP_ADDRESS",
  "target": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_NAME",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/forwardingRules/ENDPOINT_NAME",
  "network": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/default",
  "serviceDirectoryRegistrations": [
    {
      "namespace": "goog-psc-default"
    }
  ],
  "networkTier": "PREMIUM",
  "labelFingerprint": "LABEL_FINGERPRINT_ID",
  "fingerprint": "FINGERPRINT_ID",
  "pscConnectionId": "CONNECTION_ID",
  "pscConnectionStatus": "ACCEPTED",
  "allowPscGlobalAccess": true
}
  2. Verifica que el estado del endpoint sea ACCEPTED. Si el estado es PENDING, significa que la instancia no permite el proyecto Google Cloud que contiene el endpoint. Asegúrate de que el proyecto de red en el que se crea el endpoint esté permitido. Para obtener más información, consulta Editar una instancia con Private Service Connect habilitado.
ERROR: (gcloud.compute.forwarding-rules.create) Could not fetch resource: The resource 'projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME' was not found Este mensaje de error puede producirse al reservar una dirección IP interna estática para el punto final de Private Service Connect. Asegúrate de que la subred especificada exista en el proyecto indicado en el URI. Si quieres crear un endpoint en un proyecto de servicio, pero usar una subred de una red de VPC compartida, debes especificar la subred por su URI y usar el ID del proyecto host en el URI. Para obtener más información, consulta Crear el endpoint manualmente.
ERROR: (gcloud.compute.forwarding-rules.create) Could not fetch resource: - The resource 'projects/PROJECT_ID/global/networks/NETWORK_NAME' was not found Este mensaje de error puede producirse cuando creas un punto final de Private Service Connect manualmente. Asegúrate de que la red especificada exista en el proyecto indicado en el URI. Si quieres crear un endpoint en un proyecto de servicio, pero usar una red de VPC compartida, debes especificar la red por su URI y usar el ID del proyecto del host en el URI. Para obtener más información, consulta Crear el endpoint manualmente.
Invalid consumer network status for PSC auto connection.

La red de consumo no está configurada correctamente o no está configurada en absoluto y, por lo tanto, no hay ningún endpoint disponible al que conectarse. Para conectarte al endpoint, tendrás que comprobar su estado y corregir el error antes de volver a intentarlo.
Para comprobar el estado de un endpoint, consulta Recuperar el endpoint. El estado del endpoint puede ser uno de los siguientes:

  • CONNECTION_POLICY_MISSING: no hay ninguna política de conexión de servicio coincidente en la red del consumidor. Las políticas de conexión de servicio se configuran por red y por región. Para volver a configurar la red, consulta Actualizar una política de conexión de servicio.
  • CONSUMER_INSTANCE_PROJECT_NOT_ALLOWLISTED: hay una política de conexión de servicio coincidente, pero la instancia de servicio no está configurada para permitir la conexión a esta instancia. Para volver a configurar la política de conexión de servicio, consulta Actualizar una política de conexión de servicio.
  • POLICY_LIMIT_REACHED: la política de conexión de servicio ha alcanzado su límite de endpoints. Para solucionar este problema, debes aumentar el límite de endpoints actualizando la política de conexión de servicio.

No permission to create a service connection policy.

No tienes los permisos necesarios para crear una política de conexión de servicio. Para crear una política de conexión de servicio, necesitas el rol Compute Network Admin IAM. Para obtener más información, consulta Roles y permisos.

La vinculación de red no puede aceptar conexiones desde la interfaz de Private Service Connect cuando se usa la conectividad saliente de Private Service Connect.

Si tu red externa no puede aceptar conexiones desde la interfaz de Private Service Connect, es posible que las políticas de conexión de tu vinculación de red no estén configuradas correctamente.

Las vinculaciones de red deben configurarse para aceptar todas las conexiones automáticamente o configurarse manualmente con una lista de conexiones aceptadas. Para obtener más información, consulta las políticas de conexión.

Usa el siguiente comando para verificar las conexiones aceptadas en tu adjunto de red:

      gcloud compute network-attachments describe default
      --region=REGION_ID
 Si la interfaz de Private Service Connect no está en la lista de interfaces aceptadas, actualiza tu vinculación de red. Para obtener más información, consulta Gestionar archivos adjuntos de red.

Replicación

Problema Solución de problemas
La réplica de lectura no ha empezado a replicarse al crearse. Probablemente haya un error más específico en los archivos de registro. Inspecciona los registros en Cloud Logging para encontrar el error real.
No se puede crear una réplica de lectura: error invalidFlagValue. Una de las marcas de la solicitud no es válida. Puede ser una marca que hayas proporcionado explícitamente o una que se haya definido con un valor predeterminado.

En primer lugar, comprueba que el valor de la marca max_connections sea mayor o igual que el del elemento principal.

Si la marca max_connections está configurada correctamente, inspecciona los registros en Cloud Logging para encontrar el error real.
No se ha podido crear la réplica de lectura debido a un error desconocido. Probablemente haya un error más específico en los archivos de registro. Inspecciona los registros en Cloud Logging para encontrar el error real.

Si el error es set Service Networking service account as servicenetworking.serviceAgent role on consumer project, inhabilita y vuelve a habilitar Service Networking API. Esta acción crea la cuenta de servicio necesaria para continuar con el proceso.
El disco está lleno. El disco de la instancia principal puede llenarse durante la creación de la réplica. Edita la instancia principal para actualizarla a un tamaño de disco mayor.
El espacio en disco aumenta considerablemente. Si una ranura no se usa de forma activa para monitorizar datos, PostgreSQL conservará los segmentos WAL indefinidamente, lo que provocará que el espacio en disco aumente indefinidamente. Si usas las funciones de replicación lógica y decodificación en Cloud SQL, las ranuras de replicación se crean y se eliminan automáticamente. Puedes detectar las ranuras de replicación no utilizadas consultando la vista del sistema pg_replication_slots y filtrando por la columna active. Los espacios sin usar se pueden eliminar para quitar segmentos WAL con el comando pg_drop_replication_slot.
La instancia de réplica está usando demasiada memoria. La réplica usa memoria temporal para almacenar en caché las operaciones de lectura solicitadas con frecuencia, lo que puede hacer que use más memoria que la instancia principal.

Reinicia la instancia de réplica para recuperar el espacio de memoria temporal.
Replicación detenida. Se ha alcanzado el límite máximo de almacenamiento y el aumento automático del almacenamiento no está habilitado.

Edita la instancia para habilitar automatic storage increase.
La latencia de replicación es constantemente alta. La carga de escritura es demasiado alta para que la réplica pueda gestionarla. El retraso de la réplica se produce cuando el subproceso SQL de una réplica no puede seguir el ritmo del subproceso de E/S. Algunos tipos de consultas o cargas de trabajo pueden provocar una latencia de replicación alta temporal o permanente en un esquema determinado. Estas son algunas de las causas habituales del retraso de la réplica:
  • Consultas lentas en la réplica. Identifícalos y corrígelos.
  • Todas las tablas deben tener una clave principal o única. Cada actualización de una tabla de este tipo sin una clave única o principal provoca análisis completos de la tabla en la réplica.
  • Las consultas como DELETE ... WHERE field < 50000000 provocan un retraso en la replicación basada en filas, ya que se acumula un gran número de actualizaciones en la réplica.

Estas son algunas posibles soluciones:

  • Edita la instancia para aumentar el tamaño de la réplica.
  • Reducir la carga de la base de datos.
  • Envía el tráfico de lectura a la réplica de lectura.
  • Indexa las tablas.
  • Identifica y corrige las consultas de escritura lentas.
  • Vuelve a crear la réplica.
Errores al reconstruir índices en PostgreSQL 9.6. PostgreSQL te informa de que debes volver a generar un índice concreto. Esto solo se puede hacer en la instancia principal. Si creas una nueva instancia de réplica, pronto volverá a aparecer el mismo error. Los índices hash no se propagan a las réplicas en las versiones de PostgreSQL anteriores a la 10.

Si debes usar índices hash, actualiza a PostgreSQL 10 o una versión posterior. De lo contrario, si también quieres usar réplicas, no uses índices hash en PostgreSQL 9.6.
La consulta en la instancia principal siempre está en ejecución. Después de crear una réplica, se espera que la consulta SELECT * from pg_stat_activity where state = 'active' and pid = XXXX and username = 'cloudsqlreplica' se ejecute continuamente en tu instancia principal.
La creación de réplicas falla por tiempo de espera agotado. Las transacciones sin confirmar de larga duración en la instancia principal pueden provocar que falle la creación de réplicas de lectura.

Vuelve a crear la réplica después de detener todas las consultas en ejecución.
Si la instancia principal y la réplica tienen tamaños de vCPU diferentes, puede haber problemas de rendimiento de las consultas porque el optimizador de consultas tiene en cuenta los tamaños de las vCPU.

Para solucionar este problema, siga estos pasos:

  1. Activa la marca log_duration y asigna el valor ddl al parámetro log_statement. De esta forma, obtendrás tanto las consultas como el tiempo de ejecución en la base de datos. Sin embargo, en función de tu carga de trabajo, esto podría provocar problemas de rendimiento.
  2. Ejecuta explain analyze en la instancia principal y en la réplica de lectura para las consultas.
  3. Compara el plan de consulta y comprueba si hay diferencias.

Si se trata de una consulta específica, modifícala. Por ejemplo, puedes cambiar el orden de las combinaciones para ver si obtienes un mejor rendimiento.