Usa las Estadísticas de consultas para mejorar el rendimiento de las consultas

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En esta página, se describe cómo usar el panel de Estadísticas de consultas para detectar y analizar problemas de rendimiento con tus consultas.

Introducción

Estadísticas de consultas te ayuda a detectar, diagnosticar y prevenir problemas de rendimiento de las consultas para las bases de datos de Cloud SQL. Admite la supervisión intuitiva y proporciona información de diagnóstico que te ayuda a ir más allá de la detección para identificar la causa raíz de los problemas de rendimiento.

Estadísticas de consultas te ayuda a mejorar el rendimiento de las consultas de Cloud SQL mediante la orientación a través de los siguientes pasos:

• Visualiza la carga de la base de datos de las consultas más frecuentes
• Cómo identificar una búsqueda potencialmente problemática

Cómo consultar estadísticas de la edición Cloud SQL Enterprise Plus

Si usas la edición Cloud SQL Enterprise Plus, puedes acceder a funciones adicionales en las estadísticas de consultas para realizar diagnósticos avanzados del rendimiento de las consultas. Además de las funciones estándar del panel de Estadísticas de consulta, las estadísticas de consulta de la edición Enterprise Plus de Cloud SQL te permiten hacer lo siguiente:

• Captura texto de consulta más largo de hasta 20 KB.
• Captura los planes de consultas de todas las consultas ejecutadas.
• Genera muestras de hasta 200 planes de consulta por minuto.
• Mantén una retención de métricas de 30 días más prolongada.
• Obtén recomendaciones de índices del asesor de índices.
• Finaliza una sesión o una transacción de larga duración en consultas activas.

En la siguiente tabla, se comparan los requisitos funcionales y las capacidades de las estadísticas de consultas de la edición de Cloud SQL Enterprise con las de la edición de Cloud SQL Enterprise Plus.

Habilita las estadísticas de consultas para la edición Enterprise Plus de Cloud SQL

Para habilitar las estadísticas de consultas para la edición de Cloud SQL Enterprise Plus, selecciona Habilitar funciones de Enterprise Plus cuando habilitas las estadísticas de consultas en tu instancia de la edición de Cloud SQL Enterprise Plus.

Precios

No hay costos adicionales por las estadísticas de consultas en las instancias de la edición Enterprise de Cloud SQL o de la edición Enterprise Plus de Cloud SQL.

Requisitos de almacenamiento

Las estadísticas de consultas almacenan datos de métricas en la instancia y requieren que mantengas habilitado el parámetro de configuración de aumentos de almacenamiento automáticos. Se aplican las tarifas de almacenamiento correspondientes.

Antes de comenzar

Antes de usar las estadísticas de búsqueda, haz lo siguiente:

1. Agrega los roles y permisos necesarios.
2. Habilita la API de Cloud Trace.
3. Si usas las estadísticas de consultas de la edición de Cloud SQL Enterprise o de la edición de Cloud SQL Enterprise Plus, asegúrate de que la opción Habilitar aumentos automáticos de almacenamiento esté habilitada para la instancia.

Roles y permisos requeridos

Para usar las estadísticas de consultas, debes otorgar un rol predefinido, crear un rol personalizado o proporcionar una cuenta de usuario con los permisos de administración de identidades y accesos necesarios.

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

Para obtener los permisos que necesitas para acceder a los datos históricos de ejecución de consultas en el panel de estadísticas de consultas, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto que aloja la instancia de Cloud SQL:

• Visualizador de supervisión de estadísticas de bases de datos (roles/databaseinsights.monitoringViewer)
• Visualizador de Cloud SQL (roles/cloudsql.viewer)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para acceder a los datos históricos de ejecución de consultas en el panel de estadísticas de consultas. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

• Editor de Cloud SQL (roles/cloudsql.editor)
• Administrador de Cloud SQL (roles/cloudsql.admin)

Habilita la API de Trace

Para ver los planes de consulta y sus vistas de extremo a extremo, tu Google Cloud proyecto debe tener la API de Trace habilitada. Esta configuración permite que tu proyecto deGoogle Cloud reciba datos de seguimiento de fuentes autenticadas sin costo adicional. Estos datos pueden ayudarte a detectar y diagnosticar problemas de rendimiento en tu instancia.

Para confirmar que la API de Trace esté habilitada, sigue estos pasos:

1. En la consola de Google Cloud, ve a API y servicios:

   Ir a API y Services.

2. Haz clic en Habilitar APIs y servicios.
3. En la barra de búsqueda, ingresa Trace API.
4. Si se muestra API habilitada, esta API está habilitada y no necesitas hacer nada. De lo contrario, haz clic en Habilitar.

Habilitar los aumentos de almacenamiento automáticos

Si usas las estadísticas de consultas para la edición Cloud SQL Enterprise Plus, asegúrate de que el parámetro de configuración de la instancia para habilitar los aumentos de almacenamiento automáticos permanezca habilitado. De forma predeterminada, esta opción está habilitada para las instancias de Cloud SQL.

Si anteriormente inhabilitaste este parámetro de configuración de la instancia y deseas habilitar las estadísticas de consultas para la edición Cloud SQL Enterprise Plus, primero vuelve a habilitar los aumentos de almacenamiento automáticos. No puedes desactivar los aumentos de almacenamiento automáticos ni habilitar las estadísticas de consultas para la edición de Cloud SQL Enterprise Plus.

Habilitar las estadísticas de consultas

Cuando habilitas las estadísticas de consultas, se suspenden temporalmente todas las demás operaciones. Estas operaciones incluyen verificaciones de estado, registros, supervisión y otras operaciones de instancias.

    gcloud sql instances patch INSTANCE_ID \
    --insights-config-query-insights-enabled
  

gcloud sql instances patch INSTANCE_ID \
--insights-config-query-insights-enabled \
--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH \
--query_plans_per_minute=QUERY_PLANS_PER_MINUTE \
--tier=API_TIER_STRING \
--region=REGION
  

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

{
  "settings" : {
     "insightsConfig" : {
       "queryInsightsEnabled" : true,
       "recordClientAddress" : true,
       "queryStringLength" : 1024,
       "queryPlansPerMinute" : 20,
   }
  }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-03-28T22:43:40.009Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Se espera que las métricas estén disponibles en Estadísticas de consultas después de que se completan las consultas.

Visualiza el panel de Estadísticas de consultas

En el panel de Estadísticas de consultas, se muestra la carga de consultas según los factores que selecciones. La carga de consultas es una medición del trabajo total para todas las consultas en la instancia del intervalo de tiempo seleccionado. En el panel, se proporciona una serie de filtros que te ayudan a ver la carga de consultas.

Para abrir el panel Estadísticas de consultas, sigue estos pasos:

1. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
2. En el menú de navegación de Cloud SQL, haz clic en Estadísticas de consultas o en Ir a Estadísticas de consultas para obtener información más detallada sobre las consultas y el rendimiento en la página Resumen de la instancia.

Se abrirá el panel de Estadísticas de consultas. Según si usas las estadísticas de consultas de la edición de Cloud SQL Enterprise o de Cloud SQL Enterprise Plus, el panel de estadísticas de consultas muestra la siguiente información sobre tu instancia:

• Bases de datos: Filtra la carga de consultas en una base de datos específica o en todas las bases de datos.
• Intervalo de tiempo: Filtra la carga de consultas por intervalos de tiempo, como 1 hora, 6 horas, 1 día, 7 días, 30 días o un intervalo personalizado.
• Gráfico de carga de la base de datos: Muestra el gráfico de carga de consultas en función de los datos filtrados.
• Consultas y Bases de datos: Filtra la carga de consultas según una consulta o una base de datos seleccionada. Consulta Filtra la carga de la base de datos.

Visualiza la carga de la base de datos para todas las consultas

La carga de consultas de la base de datos es una medida del trabajo (en segundos de CPU) que ejecutó las consultas en la base de datos seleccionada a lo largo del tiempo. Cada consulta en ejecución utiliza o espera recursos de CPU, recursos de IO o recursos de bloqueo. La carga de consultas de la base de datos es la proporción de la cantidad de tiempo que tomaron todas las consultas completadas en un período determinado en comparación con las horas reales.

El panel de estadísticas de consultas de nivel superior muestra el grafo Carga de la base de datos por tiempo de ejecución. Los menús desplegables en el panel te permiten filtrar el gráfico para todas las bases de datos o una base de datos específica.

Las líneas de colores del gráfico muestran la carga de cada base de datos por tiempo de ejecución. Revisa el gráfico y usa las opciones de filtrado para explorar estas preguntas:

• ¿La carga de consultas es alta? ¿El grafo aumenta o se incrementa con el tiempo? Si no ves una carga alta, entonces el problema no está en tu consulta.
• ¿Cuánto tiempo ha estado alta la carga? ¿Está alta ahora o lo ha estado por mucho tiempo? Usa el selector de intervalo de tiempo para seleccionar varios períodos a fin de averiguar cuánto tiempo ha durado el problema. Acerca la vista para ver un período en el que se observan los aumentos repentinos de la carga de consultas. Aléjate para ver hasta una semana del cronograma.
• ¿Qué base de datos experimenta la carga? Selecciona bases de datos diferentes en el menú desplegable Bases de datos para encontrar las bases de datos con las cargas más altas.

Filtra la carga de la base de datos

• Todas las consultas

• Bases de datos

Para personalizar el gráfico de carga de la base de datos, selecciona una dimensión del menú desplegable Carga de la base de datos por tiempo de ejecución.

Consulta los principales contribuyentes a la carga de la base de datos

Para ver los principales contribuyentes a la carga de la base de datos, puedes usar la tabla Dimensiones principales por carga de base de datos. En la tabla Dimensiones principales por carga de base de datos, se muestran los factores más importantes para el período y la dimensión que selecciones en el menú desplegable del gráfico Carga de base de datos por tiempo de ejecución. Puedes modificar el período o la dimensión para ver los principales contribuyentes de una dimensión o un período diferentes.

En la tabla Dimensiones principales por carga de datos, puedes seleccionar las siguientes pestañas.

Filtra por consultas

La tabla Consultas principales proporciona una descripción general de las consultas que generan la mayor carga de consultas. En la tabla, se muestran todas las consultas normalizadas para el período y las opciones seleccionadas en el panel de Estadísticas de consultas. Ordena las consultas por tiempo total de ejecución durante el período que seleccionaste.

Para ordenar la tabla, selecciona el encabezado de una columna.

En la tabla, se muestran las siguientes propiedades:

• Consulta: La cadena de consulta normalizada. De forma predeterminada, las estadísticas de consultas solo muestran 1,024 caracteres en la cadena de consulta.
• Base de datos: La base de datos en la que se ejecutó la consulta.
• Recomendaciones: Las recomendaciones sugeridas, como Crear índices, para mejorar el rendimiento de las consultas.
• Tiempo de ejecución promedio (ms): Es el tiempo promedio en el que se ejecutará la consulta.
• Tiempo total de ejecución (ms): Es el tiempo total de ejecución de la consulta.
• Cantidad de llamadas: Es la cantidad de veces que la aplicación llamó a la consulta.
• Promedio de filas mostradas: Es la cantidad promedio de filas mostradas para la consulta.

Estadísticas de consultas almacena y muestra solo las consultas normalizadas.

Examina operaciones en un plan de consulta de muestra

Un plan de consultas toma una muestra de tu consulta y la divide en operaciones individuales. Explica y analiza cada operación en la consulta.

En el gráfico de Muestras de planes de consultas, se muestran todos los planes de consultas que se ejecutan en momentos específicos y el período que llevó ejecutar cada plan. Puedes cambiar la velocidad a la que se capturan las muestras del plan de consultas por minuto. Consulta Habilita las Estadísticas de consultas.

De forma predeterminada, el panel de la derecha muestra los detalles del plan de consulta de muestra que tarda más tiempo, como se puede ver en el gráfico Muestras del plan de consulta. Para ver los detalles de otro plan de consultas de muestra, haz clic en el círculo relevante en el gráfico. En los detalles expandidos, se muestra un modelo de todas las operaciones en el plan de consultas.

Cada operación muestra las filas mostradas y, si está disponible, el costo de la operación. Usa la vista de pantalla completa o la pestaña De extremo a extremo para ver las estadísticas de ejecución estimadas de cada nodo (operación), así como las estadísticas de ejecución del entorno de ejecución asociadas con el nodo raíz.

Revisa las siguientes preguntas para tratar de reducir el problema:

1. ¿Cuál es el consumo de recursos?
2. ¿Qué relación tiene con otras consultas?
3. ¿El consumo cambia con el tiempo?

Función de detalles de la consulta

Los detalles de la consulta pueden proporcionar más detalles sobre una consulta específica, incluido el tiempo de ejecución promedio, la cantidad de veces que se llamó y la cantidad promedio de filas que se muestran. También puede ofrecer recomendaciones, como índices, para ayudar a mejorar el rendimiento de las consultas.

Los detalles de la consulta también proporcionan las siguientes métricas:

• Muestras de planes de consultas: Estas muestras ayudan a explicar y analizar tu consulta, ya que proporcionan un desglose de las diferentes operaciones en una muestra de la consulta.

  

• Recuento de ejecuciones de consultas con el paso del tiempo: Muestra la cantidad de veces que se completó la consulta durante un período determinado. El gráfico te ayuda a comprender mejor cuándo se suele ejecutar una consulta y puede ayudarte a estimar el impacto de la consulta en el rendimiento de la instancia.

  

• Promedio de filas mostradas con el paso del tiempo: Muestra la cantidad promedio de filas que muestra la consulta con el paso del tiempo. Estos datos pueden ayudarte a correlacionar las consultas más lentas que las habituales con una mayor cantidad de datos que muestran esas consultas.

  

• Estadísticas de E/S: Muestra las estadísticas de entrada y salida de la consulta, incluidos los siguientes filtros:
  • Lecturas lógicas promedio
  • Lecturas físicas promedio
  • Escrituras lógicas promedio

  Puedes usar las métricas de E/S para correlacionar las consultas más lentas de lo habitual con un uso de E/S más intensivo o cambios en los patrones de E/S.

  Por ejemplo, si aumentó la cantidad de operaciones de lectura lógica, eso podría ser una indicación de que la consulta comenzó a leer más datos de lo habitual. Si la cantidad de lecturas físicas aumentó, eso podría indicar que Cloud SQL comenzó a leer más datos del disco en lugar de la caché del búfer. Por ejemplo, quizás no había suficiente memoria para almacenar en caché todos los datos o la instancia comenzó a leer demasiados datos. Si aumentó la cantidad de operaciones de escritura lógicas, eso podría indicar que la consulta comenzó a escribir más datos en el disco de datos.

  Este es un ejemplo de cómo esta métrica podría ayudar a medir el impacto de la consulta en la E/S de la instancia.

  

• Estadísticas de memoria: Muestra las estadísticas de uso de memoria de la consulta, incluidos los siguientes filtros:
  • Memoria ideal promedio
  • Memoria reservada promedio
  • Memoria en uso promedio

  Esta métrica puede ayudarte a detectar cambios en el consumo de memoria relacionados con la consulta, incluidos los siguientes ejemplos:

  • Usa esta métrica para detectar cuándo Cloud SQL predijo de forma incorrecta la cantidad de memoria necesaria para ejecutar la consulta y podría haber reservado más memoria de la que usa la consulta.
  • Usa esta métrica para detectar cuándo Cloud SQL no pudo asignar suficiente memoria y reservó una concesión de memoria más pequeña. Cuando esto sucede, Cloud SQL usa la base de datos tempdb, que es más lenta que usar la memoria.
  • Usa la métrica junto con la cantidad de ejecuciones de consultas para medir el impacto de la consulta en el consumo de memoria de la instancia.
  • Usa la métrica cuando veas un uso alto de memoria o presión de memoria.

  

• Estadísticas de CPU y tiempo de ejecución: Muestra una vista combinada de las estadísticas de tiempo de CPU y de ejecución de la consulta. Puedes usar la métrica de tiempo de CPU para investigar el alto uso de CPU en la instancia, incluidos los siguientes ejemplos:
  • Puedes usar una combinación de métricas de tiempo de CPU y recuento de ejecuciones para medir el impacto de la consulta en el consumo total de CPU en la instancia.
  • Puedes usar una combinación de tiempo de CPU, tiempo de ejecución y métricas de paralelismo para medir el porcentaje de tiempo que la consulta esperó recursos.
  • Puedes usar la métrica Tiempo de ejecución para detectar cuándo una consulta tardó más tiempo en ejecutarse de lo habitual.

  

• Estadísticas de consulta adicionales: Muestra estadísticas adicionales relacionadas con la consulta, incluidos los siguientes filtros:
  • Estadísticas de Common Language Runtime (CLR)
  • Estadísticas del almacén de columnas
  • Desbordamientos de memoria
  • Estadísticas de paralelismo

  

Inhabilita las estadísticas de consultas

gcloud sql instances patch INSTANCE_ID \
  --no-insights-config-query-insights-enabled

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

{
  "settings" : { "insightsConfig" : { "queryInsightsEnabled" : false } }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2021-01-28T22:43:40.009Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Inhabilita las estadísticas de consultas para la edición Enterprise Plus de Cloud SQL

Para inhabilitar las estadísticas de consultas en la edición Enterprise Plus de Cloud SQL, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

   Ir a Instancias de Cloud SQL

2. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
3. Haz clic en Editar.
4. En la sección Personaliza tu instancia, expande Estadísticas de consultas.
5. Desmarca la casilla de verificación Habilitar funciones de Enterprise Plus.
6. Haz clic en Guardar.

¿Qué sigue?

• Blog de lanzamiento: Solución de cuellos de botella de la base de datos más rápido con las estadísticas de consultas más recientes de la edición Enterprise Plus de Cloud SQL
• Blog: Boost your query performance troubleshooting skills with Cloud SQL Insights
• Video: Introducing Cloud SQL Insights
• Podcast: Cloud SQL Insights
• Codelab de Insights
• Optimiza el uso alto de CPU
• Optimiza el uso alto de memoria