Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En esta página, se describe el asesor de índices de Spanner y cómo puedes ver y aplicar sus recomendaciones de índices. El asesor de índices está disponible para bases de datos de dialecto Google SQL y de dialecto PostgreSQL.
El asesor de índices de Spanner analiza tus consultas para recomendar índices nuevos o alterados que pueden mejorar el rendimiento de tus consultas. Puedes ver las recomendaciones del asesor de índices en la consola de Google Cloud con cualquiera de los siguientes enfoques:
Para ver las recomendaciones de CREATE INDEX y ALTER INDEX, puedes usar la consola de Google Cloud .
Para obtener más información sobre los índices de Spanner, consulta Índices secundarios.
Limitaciones
El asesor de índices de Spanner tiene las siguientes limitaciones:
Solo proporciona recomendaciones de CREATE INDEX y ALTER INDEX. No proporciona recomendaciones de DROP INDEX para los índices existentes.
Una recomendación de índice solo se muestra si proporciona un beneficio de rendimiento perceptible.
Si eres un usuario de control de acceso detallado o si no
tienes acceso a DDL, no puedes ejecutar declaraciones DDL de recomendación de índice. Puedes copiar y guardar la recomendación.
Usa el plan de ejecución de consultas
Para ver y aplicar las recomendaciones del asesor de índices desde el plan de ejecución de una consulta,
sigue estos pasos.
Ver recomendaciones
Para ver el plan de ejecución de la consulta, ejecuta una consulta en la Google Cloud consola:
Ve a la página Instancias de Spanner en laGoogle Cloud consola.
Selecciona la instancia que contiene la base de datos que deseas consultar.
Selecciona el nombre de la base de datos que deseas consultar.
En el menú de navegación, haz clic en Spanner Studio.
Abre una nueva pestaña del editor de SQL.
En el panel del editor, ingresa tu consulta en SQL.
Haz clic en Ejecutar.
Cuando se termine de ejecutar la consulta, haz clic en la pestaña Explicación para ver el plan de ejecución de la consulta.
En el panel de información, se muestra información detallada sobre la consulta. Si Spanner determina que un índice nuevo o alterado puede mejorar el rendimiento de tus consultas, se mostrará una tarjeta de recomendaciones de índices.
Para ver la sentencia DDL de la recomendación de índice, en la tarjeta Recomendación de índice, haz clic en Ver detalles para ver el índice.
Aplicar recomendaciones
La recomendación de índices de Spanner proporciona instrucciones DDL CREATE INDEX y ALTER INDEX completas para los índices recomendados.
Para aplicar la recomendación del asesor de índices, copia y ejecuta la sentencia DDL del asesor de índices en el editor de Spanner Studio exactamente como se presenta.
En el panel Recomendación de índice, selecciona la casilla de verificación junto a las instrucciones de DDL que deseas copiar.
Haz clic en Copiar en una pestaña nueva.
En la nueva pestaña del editor de Spanner Studio, ejecuta la sentencia DDL copiada.
Usa el panel de Estadísticas de consultas
Para ver y aplicar las recomendaciones del asesor de índices desde el panel de Estadísticas de consultas, sigue estos pasos.
Ver recomendaciones
Ve a la página Instancias de Spanner en laGoogle Cloud consola.
Selecciona el nombre de la instancia que contiene la base de datos que deseas consultar.
Selecciona el nombre de la base de datos que deseas consultar.
En el menú de navegación, haz clic en Estadísticas de consultas.
Consulta la tabla Consultas y etiquetas de TopN.
La tabla muestra una columna Recommendation. Si Spanner determina que un índice nuevo o alterado puede mejorar el rendimiento de tus consultas, se muestra una recomendación de índice. Para ver cómo se ve esto en la consola de Google Cloud , consulta Cómo identificar una búsqueda o etiqueta de solicitud potencialmente problemática.
Para ver la sentencia DDL de la recomendación de índice, haz clic en Recomendación de índice.
Aplicar recomendaciones
La recomendación de índices de Spanner proporciona instrucciones DDL CREATE INDEX y ALTER INDEX completas para los índices recomendados.
Para aplicar la recomendación del asesor de índices, copia y ejecuta la sentencia DDL del asesor de índices en el editor de Spanner Studio exactamente como se presenta.
En el panel Recomendación de índice, selecciona las instrucciones de DDL que deseas copiar.
Spanner genera recomendaciones para las consultas TopN cada 12 horas para las consultas TopN ejecutadas en las 12 horas anteriores. En el panel Recomendación de índice, se muestra un registro de hace cuánto tiempo se actualizó por última vez.
Haz clic en Copiar en Spanner Studio.
La consola deGoogle Cloud muestra el editor de Spanner Studio.
Si eres un usuario del control de acceso detallado, no verás el botón Copy to
Spanner Studio y no podrás ejecutar la sentencia DDL.
En el editor de Spanner Studio, ejecuta la sentencia DDL copiada.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-05 (UTC)"],[],[],null,["# Use the Spanner index advisor\n\nThis page describes the Spanner index advisor and how you can view and\napply its index recommendations. The index advisor is available for\nGoogleSQL-dialect databases and PostgreSQL-dialect databases.\n\nThe Spanner index advisor analyzes your queries to recommend new\nor altered indexes that can improve your query performance. You can view the\nindex advisor's recommendations in the Google Cloud console using either of the\nfollowing approaches:\n\n- Run a query and view its [query execution plan](/spanner/docs/query-execution-plans)\n- Use the Spanner [Query insights dashboard](/spanner/docs/using-query-insights)\n\nTo view the `CREATE INDEX` and `ALTER INDEX` recommendations, you can\nuse the Google Cloud console.\n\nFor more information about Spanner indexes, see\n[Secondary indexes](/spanner/docs/secondary-indexes).\n\nLimitations\n-----------\n\nSpanner index advisor has the following limitations:\n\n- Only provides `CREATE INDEX` and `ALTER INDEX` recommendations. Doesn't\n provide `DROP INDEX` recommendations for existing indexes.\n\n- An index recommendation is only shown if it provides a noticeable performance\n benefit.\n\n- If you are a [fine-grained access control](/spanner/docs/fgac-about) user or if you don't\n have DDL access, you can't execute index recommendation DDL statements. You\n can copy and save the recommendation.\n\nUse the query execution plan\n----------------------------\n\nTo view and apply index advisor recommendations from a query's execution plan,\nfollow these steps.\n\n### View recommendations\n\nTo view the query execution plan, run a query in the Google Cloud console:\n\n1. Go to the Spanner **Instances** page in\n Google Cloud console.\n\n [Go to Instances](https://console.cloud.google.com/spanner/instances)\n2. Select the instance that contains the database that you want to query.\n\n3. Select the name of the database you want to query.\n\n4. In the navigation menu, click **Spanner Studio**.\n\n5. Open a new SQL editor tab.\n\n6. In the editor pane, enter your SQL query.\n\n7. Click **Run**.\n\n8. After the query has finished running, to see the query execution plan, click\n the **Explanation** tab.\n\n The information panel shows detailed information about the query. If\n Spanner determines that a new or altered index can improve\n your query performance, then an index recommendations card is displayed.\n9. To view the index recommendation DDL statement, in the **Index recommendation**\n card, click **View details** to view the index.\n\n### Apply recommendations\n\nThe Spanner index recommendation provides complete `CREATE INDEX`\nand `ALTER INDEX` DDL statements for recommended indexes.\n\nTo apply the index advisor's recommendation, copy and run the index advisor's\nDDL statement into the Spanner Studio editor exactly as presented.\n\n1. In the **Index recommendation** pane, select the checkbox next to the DDL\n statements that you want to copy.\n\n2. Click **Copy to new tab**.\n\n3. In the new Spanner Studio editor tab, run the copied DDL statement.\n\nUse the Query insights dashboard\n--------------------------------\n\nTo view and apply index advisor recommendations from the Query insights\ndashboard, follow these steps.\n\n### View recommendations\n\n1. Go to the Spanner **Instances** page in\n Google Cloud console.\n\n [Go to Instances](https://console.cloud.google.com/spanner/instances)\n2. Select the name of the instance containing the database you want to query.\n\n3. Select the name of the database you want to query.\n\n4. In the navigation menu, click **Query insights**.\n\n5. View the **TopN queries and tags** table.\n\n The table shows a **Recommendation** column. If Spanner\n determines that a new or altered index can improve your query performance,\n then an index recommendation is displayed. To view what this looks\n like in the Google Cloud console, see\n [Identify a potentially problematic query or request tag](/spanner/docs/using-query-insights#filter-db-load).\n6. To view the index recommendation DDL statement, click **Index recommendation**.\n\n### Apply recommendations\n\nThe Spanner index recommendation provides complete `CREATE INDEX`\nand `ALTER INDEX` DDL statements for recommended indexes.\n\nTo apply the index advisor's recommendation, copy and run the index advisor's\nDDL statement into the Spanner Studio editor exactly as presented.\n\n1. In the **Index recommendation** pane, select the DDL statements you want to\n copy.\n\n Spanner generates recommendations for TopN queries every 12\n hours for the TopN queries executed in the preceding 12 hours. The\n **Index recommendation** pane displays a record of how long ago it was last\n refreshed.\n\n2. Click **Copy to Spanner Studio** .\n Google Cloud console displays the **Spanner Studio** editor.\n\n If you are a fine-grained access control user, you don't see the **Copy to\n Spanner Studio** button, and you can't run the DDL statement.\n3. In the Spanner Studio editor, run the copied DDL statement.\n\nWhat's next\n-----------\n\n- Learn more about Spanner [secondary indexes](/spanner/docs/secondary-indexes).\n\n- Learn more [SQL best practices](/spanner/docs/sql-best-practices).\n\n- Learn how to [Troubleshoot performance regressions](/spanner/docs/troubleshooting-performance-regressions)."]]
