Utilice información de consultas para mejorar el rendimiento de las consultas

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Esta página describe cómo utilizar el panel de información de consultas para detectar y analizar problemas de rendimiento con sus consultas.

Introducción

Query Insights le ayuda a detectar, diagnosticar y prevenir problemas de rendimiento de consultas en bases de datos de Cloud SQL. Permite una monitorización intuitiva y proporciona información de diagnóstico que le ayuda a ir más allá de la detección para identificar la causa raíz de los problemas de rendimiento.

Query Insights lo ayuda a mejorar el rendimiento de las consultas de Cloud SQL guiándolo a través de los siguientes pasos:

• Ver la carga de la base de datos para las consultas principales
• Identificar una consulta potencialmente problemática

Información de consultas para la edición Cloud SQL Enterprise Plus

Si usa Cloud SQL Enterprise Plus, puede acceder a funciones adicionales en Query Insights para realizar diagnósticos avanzados del rendimiento de las consultas. Además de las funciones estándar del panel de Query Insights, Query Insights para Cloud SQL Enterprise Plus le permite hacer lo siguiente:

• Captura texto de consulta más largo, de hasta 20 KB.
• Capturar planes de consulta para todas las consultas ejecutadas.
• Muestrear hasta 200 planes de consulta por minuto.
• Mantener una retención de métricas más prolongada de 30 días.
• Obtenga recomendaciones de índices del asesor de índices.
• Terminar una sesión o transacción de larga duración en consultas activas.
• Acceda a la resolución de problemas asistida por IA ( vista previa ).

La siguiente tabla compara los requisitos funcionales y las capacidades de Query Insights para la edición Cloud SQL Enterprise con Query Insights para la edición Cloud SQL Enterprise Plus.

Habilitar información de consultas para la edición Cloud SQL Enterprise Plus

Para habilitar información de consultas para la edición Cloud SQL Enterprise Plus, seleccione Habilitar funciones de Enterprise Plus cuando habilite información de consultas en su instancia de la edición Cloud SQL Enterprise Plus.

Precios

No hay ningún costo adicional por la información de consultas en las instancias de Cloud SQL Enterprise Edition o Cloud SQL Enterprise Plus Edition.

Requisitos de almacenamiento

Query Insights almacena datos de métricas en la instancia y requiere que mantenga activada la configuración de aumento automático de almacenamiento. Se aplican las tarifas de almacenamiento correspondientes .

Antes de empezar

Antes de utilizar Query Insights, haga lo siguiente.

1. Agregue los roles y permisos necesarios .
2. Habilitar la API de Cloud Trace .
3. Si está usando Query Insights para la edición Cloud SQL Enterprise o Query Insights para la edición Cloud SQL Enterprise Plus, asegúrese de que la opción Habilitar aumentos automáticos de almacenamiento esté habilitada para la instancia .

Roles y permisos necesarios

Para utilizar Query Insights, debe otorgar un rol predefinido, crear un rol personalizado o proporcionar una cuenta de usuario con los permisos de administración de identidad y acceso necesarios.

Para obtener más información sobre cómo otorgar roles, consulte Administrar acceso .

Para obtener los permisos que necesita para acceder a los datos históricos de ejecución de consultas en el panel de información de consultas, solicite a su administrador que le otorgue los siguientes roles de IAM en el proyecto que aloja la instancia de Cloud SQL:

• Visor de monitoreo de información de base de datos ( roles/databaseinsights.monitoringViewer )
• Visor de Cloud SQL ( roles/cloudsql.viewer )

Para obtener más información sobre cómo otorgar roles, consulte Administrar 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 información de consultas. Para ver los permisos exactos necesarios, expanda la sección " Permisos requeridos" :

También es posible que puedas obtener estos permisos con roles personalizados u otros roles predefinidos .

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

Habilitar la API de seguimiento

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

Para confirmar que la API de seguimiento está habilitada, siga estos pasos:

1. Desde Google Cloud consola, vaya a API y servicios :

   Ir a APIs y Servicios

2. Haga clic en Habilitar API y servicios .
3. En la barra de búsqueda, ingrese Trace API .
4. Si se muestra "API habilitada" , significa que esta API está habilitada y no hay nada que hacer. De lo contrario, haga clic en "Habilitar" .

Habilitar aumentos automáticos de almacenamiento

Si usa Query Insights para la edición Cloud SQL Enterprise Plus, asegúrese de que la configuración de la instancia para habilitar el aumento automático del almacenamiento permanezca activada. De forma predeterminada, esta opción está activada para las instancias de Cloud SQL.

Si desactivó previamente esta configuración de instancia y desea habilitar Query Insights para Cloud SQL Enterprise Plus Edition, primero vuelva a habilitar los aumentos automáticos de almacenamiento. No es posible desactivar los aumentos automáticos de almacenamiento y habilitar Query Insights para Cloud SQL Enterprise Plus Edition.

Habilitar información de consultas

Al habilitar la información de consultas, se suspenden temporalmente todas las demás operaciones, como las comprobaciones de estado, el registro, la monitorización y otras operaciones de instancia.

    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": "[email protected]",
  "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 los conocimientos de la consulta unos minutos después de completar la consulta.

Ver el panel de información de consultas

El panel de información de consultas muestra la carga de consultas según los factores que seleccione. La carga de consultas mide el trabajo total de todas las consultas de la instancia en el intervalo de tiempo seleccionado. El panel proporciona una serie de filtros que le ayudan a visualizar la carga de consultas.

Para abrir el panel de información de consultas , siga estos pasos:

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

Se abre el panel de información de consultas . Dependiendo de si usa información de consultas para Cloud SQL Enterprise Edition o Cloud SQL Enterprise Plus Edition, el panel de información de consultas muestra la siguiente información sobre su instancia:

• Bases de datos : filtra la carga de consultas en una base de datos específica o en todas las bases de datos.
• Rango de tiempo : filtra la carga de consultas por rangos de tiempo, como 1 hora, 6 horas, 1 día, 7 días, 30 días o un rango personalizado.
• Gráfico de carga de la base de datos : muestra el gráfico de carga de consultas, según los datos filtrados.
• Consultas y bases de datos : Filtra la carga de consultas según una consulta o base de datos seleccionada. Consulte Filtrar la carga de la base de datos .

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

La carga de consultas de la base de datos mide el trabajo (en segundos de CPU) que realizan las consultas ejecutadas en la base de datos seleccionada a lo largo del tiempo. Cada consulta en ejecución utiliza o espera recursos de CPU, E/S o bloqueos. La carga de consultas de la base de datos es la relación entre el tiempo empleado por todas las consultas completadas en un intervalo de tiempo determinado y el tiempo real.

El panel de información de consultas de nivel superior muestra el gráfico de carga de la base de datos por tiempo de ejecución . Los menús desplegables del panel permiten filtrar el gráfico por todas las bases de datos o por una específica.

Las líneas de color en el gráfico muestran la carga de la base de datos según el tiempo de ejecución. Revise el gráfico y utilice las opciones de filtrado para explorar estas preguntas:

• ¿La carga de la consulta es alta? ¿El gráfico presenta picos o se eleva con el tiempo? Si no observa una carga alta, el problema no está en la consulta.
• ¿Cuánto tiempo lleva la carga alta? ¿Es alta solo ahora o lleva mucho tiempo así? Utilice el selector de rango para seleccionar varios periodos de tiempo y averiguar cuánto tiempo lleva el problema. Amplía la vista para ver un intervalo de tiempo donde se observan picos de carga de consultas. Reduce la vista para ver hasta una semana de la cronología.
• ¿Qué base de datos está experimentando la carga? Seleccione diferentes bases de datos en el menú desplegable "Bases de datos" para encontrar las que tienen la mayor carga.

Filtrar 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, seleccione una dimensión del menú desplegable Carga de base de datos por tiempo de ejecución .

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

Para ver los principales contribuyentes a la carga de la base de datos, puede usar la tabla "Dimensiones principales por carga de la base de datos" . Esta tabla muestra los principales contribuyentes para el período y la dimensión seleccionados en el menú desplegable "Carga de la base de datos por tiempo de ejecución" . Puede modificar el período o la dimensión para ver los principales contribuyentes de una dimensión o un período diferente.

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

Filtrar por consultas

La tabla "Consultas principales" ofrece una descripción general de las consultas que generan la mayor carga de consultas. La tabla muestra todas las consultas normalizadas para el intervalo de tiempo y las opciones seleccionadas en el panel "Información de consultas". Ordena las consultas según el tiempo total de ejecución durante el intervalo de tiempo seleccionado.

Para ordenar la tabla, seleccione un encabezado de columna.

La tabla muestra las siguientes propiedades:

• Consulta : la cadena de consulta normalizada. De forma predeterminada, Query Insights muestra solo 1024 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 promedio de ejecución (ms) : el tiempo promedio que tarda la consulta en ejecutarse.
• Tiempo total de ejecución (ms) : el tiempo total que tarda la consulta en ejecutarse.
• Veces llamadas : la cantidad de veces que la aplicación llamó a la consulta.
• Promedio de filas devueltas : el número promedio de filas devueltas para la consulta.

Query Insights almacena y muestra únicamente consultas normalizadas.

Examinar operaciones en un plan de consulta muestreado

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

El gráfico de ejemplos de planes de consulta muestra todos los planes de consulta en ejecución en momentos específicos y el tiempo que tardó cada uno. Puede cambiar la velocidad a la que se capturan los ejemplos de planes de consulta por minuto. Consulte Habilitar Query Insights .

De forma predeterminada, el panel derecho muestra los detalles del plan de consulta de ejemplo que tarda más, como se puede ver en el gráfico " Ejemplos de planes de consulta" . Para ver los detalles de otro plan de consulta de ejemplo, haga clic en el círculo correspondiente en el gráfico. Los detalles expandidos muestran un modelo de todas las operaciones del plan de consulta.

Cada operación muestra las filas devueltas y, si está disponible, el coste de la operación. Utilice la vista de pantalla completa o la De extremo a extremo Pestaña para ver las estadísticas de ejecución estimadas para cada nodo (operación), así como las estadísticas de ejecución en tiempo de ejecución asociadas con el nodo raíz.

Intente limitar el problema analizando las siguientes preguntas:

1. ¿Cuál es el consumo de recursos?
2. ¿Cómo se relaciona 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, como el tiempo promedio de ejecución, el número de llamadas y el promedio de filas devueltas. También pueden ofrecer recomendaciones, como índices, para mejorar el rendimiento de la consulta.

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

• Ejemplos de planes de consulta : estos ejemplos ayudan a explicar y analizar su consulta al proporcionar un desglose de las diferentes operaciones en una muestra de la consulta.

  

• Recuento de ejecuciones de consultas a lo largo del tiempo : Muestra el número de veces que la consulta se ha completado durante un período específico. El gráfico ayuda a comprender mejor cuándo se ejecuta una consulta y a estimar su impacto en el rendimiento de la instancia.

  

• Promedio de filas devueltas a lo largo del tiempo : Muestra el promedio de filas devueltas por la consulta a lo largo del tiempo. Estos datos pueden ayudarle a correlacionar consultas más lentas de lo habitual con una mayor cantidad de datos devueltos por ellas.

  

• 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

  Puede utilizar métricas de E/S para ayudarle a correlacionar 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 el número de lecturas lógicas aumentó, podría indicar que la consulta comenzó a leer más datos de lo habitual. Si el número de lecturas físicas aumentó, 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. Si el número de escrituras lógicas aumentó, 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 para la consulta, incluidos los siguientes filtros:
  • Memoria ideal promedio
  • Memoria reservada promedio
  • Memoria promedio utilizada

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

  • Utilice esta métrica para detectar cuándo Cloud SQL predijo incorrectamente la cantidad de memoria necesaria para ejecutar la consulta y podría haber reservado más memoria de la utilizada por la consulta.
  • Utilice esta métrica para detectar cuándo Cloud SQL no pudo asignar suficiente memoria y reservó una concesión de memoria menor. Cuando esto sucede, Cloud SQL utiliza la base de datos tempdb , que es más lenta que usar memoria.
  • Utilice 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.
  • Utilice la métrica cuando observe un alto uso 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 tiempo de ejecución de la consulta. Puede usar la métrica de tiempo de CPU para investigar el alto uso de CPU en la instancia, incluyendo los siguientes ejemplos:
  • Puede utilizar una combinación de métricas de tiempo de CPU y recuento de ejecución para medir el impacto de la consulta en el consumo total de CPU en la instancia.
  • Puede utilizar una combinación de métricas de tiempo de CPU, tiempo de ejecución y paralelismo para medir el porcentaje de tiempo que la consulta estuvo esperando recursos.
  • Puede utilizar la métrica del 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
  • Derrames de memoria
  • Estadísticas de paralelismo

  

Deshabilitar la información 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": "[email protected]",
  "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"
}

Deshabilitar la información de consultas para la edición Cloud SQL Enterprise Plus

Para deshabilitar la información de consultas para la edición Cloud SQL Enterprise Plus, haga lo siguiente:

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

   Ir a Instancias de Cloud SQL

2. Para abrir la página Descripción general de una instancia, haga clic en el nombre de la instancia.
3. Haga clic en Editar .
4. En la sección Personaliza tu instancia , expande Información de consultas .
5. Desmarque la casilla de verificación Habilitar funciones Enterprise Plus .
6. Haga clic en Guardar .

¿Qué sigue?

• Blog de lanzamiento: Resuelva los cuellos de botella de la base de datos más rápido con los últimos conocimientos de consultas para la edición Cloud SQL Enterprise Plus
• Blog: Mejore sus habilidades para la resolución de problemas de rendimiento de consultas con Cloud SQL Insights
• Vídeo: Presentación de Cloud SQL Insights
• Podcast: Perspectivas de Cloud SQL
• Codelab de Insights
• Optimizar el uso elevado de la CPU
• Optimizar el uso elevado de memoria