Patrones de mapas de calor para las claves de índice
En esta página, se muestran ejemplos de los patrones que podrías ver en un mapa de calor de Key Visualizer. Estos patrones pueden ayudarte a solucionar problemas de rendimiento específicos.
Uso distribuido de manera uniforme
Si en un mapa de calor se muestra una mezcla detallada de colores oscuros y brillantes, se realizan operaciones de escritura y eliminación de y las claves de índice se distribuyen de manera uniforme en toda la base de datos. Este mapa de calor probablemente representa un patrón de uso efectivo para Firestore.
Índices sobre teclas secuenciales
Un mapa de calor con una sola línea diagonal brillante puede indicar un índice que se encuentra en una que está aumentando o disminuyendo de forma estricta, como la marca de tiempo. Índices activados no se recomiendan, ya que pueden crear hotspots. Cuando se establece un hotspot, es posible que observes las latencias elevadas correspondientes.
Los siguientes son algunos ejemplos de hotspots comunes en el índice:
Generación de hotspots debido a una marca de tiempo en aumento
En este ejemplo, un mapa de calor con una sola línea diagonal brillante puede indicar una base de datos que usa operaciones de escritura o eliminación de índices estrictamente crecientes o decrecientes en un nombre de campo de marca de tiempo.
Hotspots debido al aumento de nombres de campos
En este ejemplo, un mapa de calor con una sola línea diagonal brillante puede indicar una que usa operaciones de escritura/eliminación de índice que aumentan o disminuyen de forma estricta en un como los números de factura generados automáticamente.
Para identificar el problema de generación de hotspots, usa la herramienta Key Visualizer y comprende la clave de índice estructura para determinar qué índice causa el problema y eximir esos índices con las prácticas recomendadas.
Comprende la estructura de la clave del índice
Antes de comprender la estructura de las claves de índice que ves en la herramienta Key Visualizer, obtén información sobre los índices en Firestore.
El siguiente código muestra un ejemplo de formato de clave de índice que ves cuando colocas el cursor sobre sobre el rango de teclas afectado en el mapa de calor.
COLLECTION: projects/PROJECT_ID/databases/(default)/documents/Users
PROPERTIES: (Timestamp: DESC)
VALUES: (16500000000000001)
DOCUMENT: projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001
Aquí:
- COLECCIÓN: ubicación de la colección en tu base de datos. Según el scope, puede ser una ruta de recopilación para el alcance o el nombre de la colección de alcance del grupo de colecciones.
- PROPERTIES: campos que se usan para crear el índice La propiedad de ordenamiento
__name__
solo se muestra para las definiciones de índice que modifican el orden predeterminado. - VALUES: Es el valor de cada propiedad.
- DOCUMENT: Es el ID del documento actualizado en una operación.
Del ejemplo anterior, identifica los campos de PROPERTIES. de salida para encontrar el índice afectado.
Para encontrar el índice, completa los siguientes pasos:
En la consola de Google Cloud, ve a la página Bases de datos.
Selecciona la base de datos requerida de la lista.
En el menú de navegación, haz clic en Índices.
Ve a la pestaña Compuestos o De campo único.
Para identificar el tipo de índice, analiza el campo PROPERTIES. Consulta ejemplos de claves de índice para obtener más información.
Haz clic en Filtro, selecciona Campos y, luego, ingresa el nombre del campo.
Usa el operador OR para agregar más campos en caso de índices compuestos.
Una vez que hayas identificado el índice que genera los problemas, puedes usar las siguientes soluciones:
Índice compuesto: modifica el índice para asegurarte de que el campo cuyo valor aumenta o disminuye monótonamente no se selecciona como el primer campo para o borrarlo.
Índice de campo único: Agrega una exención para el campo y el orden de clasificación que que deseas excluir. Consulta Agrega una exención de campo único para obtener más información.
Ejemplos de entradas de clave de índice en el mapa de calor
Tipo | Descripción | Ejemplo |
---|---|---|
Índices de campo único ASC, DESC del alcance de la colección | Según la configuración predeterminada, Firestore crea índices con alcance de colección. Entrada de índice para el índice de campo único en el campo Timestamp , en orden descendente para el documento Users/5000000000000001 . |
COLLECTION: projects/PROJECT_ID/databases/(default)/documents/Users PROPERTIES: (Timestamp: DESC) VALUES: (16500000000000001) DOCUMENT: projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001 |
Índices de campo único del alcance de la colección para campos de array | Para cada campo de array de un documento, Firestore crea y mantiene un índice de contenido de array de alcance de colección. Entrada de índice para los índices de campo único del modo de contenido del array que se crearán cuando se agregue un campo Country: [USA, Japan] al documento. Ten en cuenta que los índices ASC,DESC también se crearán de forma predeterminada para este campo. En el ejemplo, se muestra el índice ASC para el campo Country . |
COLLECTION: projects/PROJECT_ID/databases/(default)/documents/Users PROPERTIES:(Country: ASC) VALUES:([USA, Japan]) DOCUMENT:(projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001) |
Índices de campo único del grupo de colecciones ASC, DESC, ARRAY | Un grupo de colecciones incluye todas las colecciones con el mismo ID. Entrada del índice de campo único del grupo de colecciones en el campo Timestamp , en orden descendente. |
COLLECTION GROUP: Users PROPERTIES: (Timestamp: DESC) VALUES: (16500000000000001L) DOCUMENT: projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001 |
Índices de campo único del grupo de colecciones ASC, DESC, ARRAY | Entrada de índice para el índice de campo único del grupo de colecciones en el campo Country en el modo array-contains |
COLLECTION GROUP: Users PROPERTIES: (Country: ARRAY ASC) VALUES: (USA) DOCUMENT: projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001 |
Entrada de índice compuesto de la colección con propiedades ASC, ASC y ARRAY | Las entradas de índice compuesto con un elemento superior se crean cuando se crean documentos anidados con la definición del índice del alcance de la colección. Entrada del índice del índice compuesto con los campos Timestamp y Name en orden ascendente, y Country en modo array-contains . |
COLLECTION: projects/PROJECT_ID/databases/(default)/documents/Users PROPERTIES: (Timestamp: ASC, Name: ASC,Country: ARRAY) VALUES: (16500000000000001L, 'Alice', 'USA') DOCUMENT: (projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001) |
Entrada de índice compuesto con el alcance del grupo de colecciones con propiedades ASC, ASC | Entrada del índice compuesto en el campo Timestamp , en orden ascendente, y en el campo Name en orden ascendente |
COLLECTION GROUP: Users PROPERTIES: (Timestamp: ASC, Name: ASC) VALUES: (16500000000000001L, 'Alice') DOCUMENT: (projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001) |
Entrada de índice compuesto con el alcance de la colección con propiedades ASC y __name__ |
Entrada del índice compuesto en el campo Timestamp en orden ascendente y con la clasificación __name__ en orden descendente para el documento Users/5000000000000001 . Puedes usar __name__ como el campo final en una definición de índice para cambiar el orden predeterminado de los resultados. |
COLLECTION: projects/PROJECT_ID/databases/(default)/documents/Users PROPERTIES: (Timestamp: ASC, __name__ DESC) VALUES: (16500000000000001) DOCUMENT: projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001 |
¿Qué sigue?
- Aprende cómo comenzar a usar Key Visualizer.
- Descubre cómo analizar un mapa de calor en detalle.
- Obtén información sobre las métricas que puedes ver en un mapa de calor.