Usa el asesor de índices

AlloyDB para PostgreSQL ofrece un asesor de índices que realiza un seguimiento de las consultas que maneja tu base de datos con regularidad. Analiza estas consultas de forma periódica para recomendar índices nuevos que pueden aumentar el rendimiento de las consultas.

Puedes trabajar con las recomendaciones del asesor de índices de las siguientes maneras:

Para obtener más información sobre cómo funciona el asesor de índices, consulta Descripción general del asesor de índices.

Antes de comenzar

Antes de usar el asesor de índices, asegúrate de cumplir con los siguientes requisitos.

Habilita las extensiones requeridas

  1. En la consola de Google Cloud , ve a la página Clústeres.

    Ir a los clústeres

  2. Haz clic en un clúster en la columna Nombre del recurso.

  3. En la página Estadísticas de consultas, haz clic en Editar configuración de consultas.

  4. Haz clic en Habilitar asesor de índice.

Consulta las recomendaciones del asesor de índices

AlloyDB ejecuta de forma automática el análisis del asesor de índices de forma periódica. Puedes ver las recomendaciones de índices resultantes en el panel de Estadísticas de consultas de la consola de Google Cloud o consultando directamente las vistas de las tablas de la base de datos.

Visualiza las recomendaciones en las estadísticas de consultas

AlloyDB integra el asesor de índices con las Estadísticas de consultas y las Estadísticas de consultas avanzadas en la consola deGoogle Cloud .

Cuando el asesor de índices identifica índices de búsqueda de vectores de ScaNN o B-tree faltantes que pueden mejorar el rendimiento de las consultas, el panel de Estadísticas de consultas muestra las recomendaciones y sugerencias del asesor de índices en las siguientes vistas:

  • En la página Estadísticas de consultas, en la sección Dimensiones principales por carga de base de datos, selecciona la pestaña Consultas. En la tabla, la columna Recomendaciones muestra un vínculo Crear índices junto a cualquier consulta que tenga recomendaciones del asesor de índices. También puedes agregar un filtro para Recomendación: Crea índices y ver solo las consultas con recomendaciones de índices.

  • Si seleccionas una consulta de la tabla Consultas, se abrirá la página Detalles de la consulta, que muestra una tarjeta de Recomendación de índice en la vista del plan de consulta de muestra y una tabla de Índices recomendados. Estas vistas muestran el impacto estimado en el rendimiento (alto, medio o bajo), el tipo de índice recomendado y la tabla de destino, el almacenamiento adicional estimado necesario, la cantidad de tablas afectadas y la cantidad de consultas afectadas.

  • Si haces clic en Crear índices (o Ver detalles en una recomendación), se abrirá el panel Crea índices para mejorar el rendimiento de las consultas. En este panel, puedes inspeccionar las declaraciones de DDL de CREATE INDEX recomendadas, ver la mejora estimada del tiempo de ejecución, hacer clic en Mostrar consultas afectadas para inspeccionar todas las consultas de carga de trabajo que se benefician del índice recomendado y copiar los comandos o abrirlos directamente en AlloyDB Studio.

Para obtener instrucciones paso a paso sobre cómo configurar la frecuencia de actualización de las recomendaciones, filtrar las recomendaciones y crear índices recomendados en la consola deGoogle Cloud , consulta Usa el asesor de índices de AlloyDB para PostgreSQL con Estadísticas de consultas y Mejora el rendimiento de las consultas con las funciones avanzadas de Estadísticas de consultas.

Visualiza las recomendaciones con las vistas de la base de datos

También puedes leer los resultados del asesor de índices a través de dos vistas de tablas ubicadas en cada una de tus bases de datos:

  • google_db_advisor_recommended_indexes enumera los índices nuevos recomendados para su base de datos. También incluye estimaciones del almacenamiento requerido para cada índice y la cantidad de consultas que puede afectar cada índice.

  • google_db_advisor_workload_report: Muestra cada búsqueda para la que el asesor recomienda uno o más índices nuevos. Cada fila resume las recomendaciones para la consulta relevante.

Por ejemplo, para ver los resultados del análisis de recomendaciones de índices más reciente, con formato de tabla, ejecuta esta consulta:

SELECT * FROM google_db_advisor_recommended_indexes;

Si el análisis más reciente del asesor de índices no encuentra recomendaciones, esta consulta muestra una tabla sin filas.

Como todos estos informes existen como vistas de bases de datos ordinarias, puedes escribir consultas que filtren o presenten información de la manera que desees. Por ejemplo, para ver un informe que combine los índices recomendados con su consulta asociada completa, une las vistas google_db_advisor_workload_report y google_db_advisor_workload_statements en sus respectivas columnas query_id:

SELECT DISTINCT recommended_indexes, query
FROM google_db_advisor_workload_report r, google_db_advisor_workload_statements s
WHERE r.query_id = s.query_id;

Solicita un análisis de índices de forma manual

En lugar de esperar al próximo análisis programado del asesor de índice, puedes solicitar que AlloyDB ejecute un análisis de inmediato y muestre su informe. Para ello, ejecuta esta función de SQL:

SELECT * FROM google_db_advisor_recommend_indexes();

Una vez finalizado el análisis, AlloyDB muestra un informe con formato de tabla con la descripción y las necesidades de almacenamiento estimadas de los índices recomendados. Si el análisis no encuentra índices nuevos para recomendar, la vista no contiene filas.

Ten en cuenta que el rol del usuario de PostgreSQL que ejecuta este comando puede afectar las recomendaciones que se muestran. Si esta consulta la ejecuta postgres o algún otro usuario con el rol alloydbsuperuser, AlloyDB muestra todas las recomendaciones actuales del asesor de índices. De lo contrario, AlloyDB limita su visualización a las recomendaciones de índice en función de las consultas emitidas por el usuario actual de la base de datos.

Aplica las recomendaciones del asesor de índices

En el panel Estadísticas de consultas de la consola de Google Cloud , puedes hacer clic en Crear índices para una consulta, hacer clic en Copiar todos los comandos de índice (o Abrir comandos en Studio para abrir las declaraciones CREATE INDEX en AlloyDB Studio) y, luego, ejecutar los comandos en tu instancia principal. Para obtener instrucciones paso a paso, consulta Crea índices recomendados en Estadísticas de consultas.

Cuando consultas una vista de base de datos directamente, la columna index de la vista google_db_advisor_recommended_indexes contiene, en cada fila, una instrucción DDL CREATE INDEX completa de PostgreSQL para generar el índice recomendado en esa fila.

Para aplicar la recomendación de esa fila, ejecuta esa sentencia DDL, exactamente como se presenta. Esto incluye copiarlo en el portapapeles y pegarlo en una instrucción psql.

Por ejemplo, considera este resultado de la ejecución manual de un análisis mediante la consulta descrita en la sección anterior:

                    index                   | estimated_storage_size_in_mb
--------------------------------------------+------------------------------
 CREATE INDEX ON "School"."Students"("age") |                            3
(1 row)

Este informe contiene una sola recomendación: agregar un índice de una sola columna nuevo en la columna age de la tabla Students del esquema School. Para aplicar esta recomendación, ingresa una consulta de DDL exactamente como se representa en el informe:

CREATE INDEX ON "School"."Students"("age");

Visualiza las consultas con seguimiento del asesor de índices

La vista google_db_advisor_workload_statements contiene una lista de todas las consultas a las que realizó el asesor de índices, además de los metadatos importantes para cada una, como las siguientes métricas:

  • La cantidad de veces que la instancia ejecutó esta consulta
  • El tiempo total que la instancia dedica a procesar estas consultas
  • El ID del usuario de la base de datos que ejecuta estas consultas

Borra las consultas con seguimiento del asesor de índices

Para restablecer el comportamiento del asesor de índices en una instancia, borra las consultas con seguimiento. Para ello, ejecuta esta función de SQL:

SELECT google_db_advisor_reset();

AlloyDB vacía de inmediato la colección de consultas con seguimiento del asesor de índices.

Configura el asesor de índices

Si bien el asesor de índices funciona en la mayoría de los casos de uso con su configuración predeterminada, puedes ajustar su comportamiento con la configuración de varias marcas de base de datos.

Por ejemplo, puedes configurar la marca google_db_advisor.enable_vector_index_advisor para permitir que el asesor de índices recomiende índices para las consultas vectoriales. Esta marca está habilitada de forma predeterminada.

Para obtener más información, consulta Marcas de asesor de índices.

¿Qué sigue?