Padrões de mapa de calor para chaves de índice

Nesta página, mostramos exemplos de padrões que podem ser vistos em um mapa de calor do Key Visualizer. Esses padrões podem ajudar você a resolver problemas de desempenho específicos.

Uso distribuído de modo uniforme

Mapa de calor que mostra leituras e gravações distribuídas uniformemente

Se um mapa de calor mostrar uma mistura refinada de cores escuras e claras, as operações de gravação/exclusão para chaves de índice estarão distribuídas uniformemente pelo banco de dados. Esse mapa de calor provavelmente representa um padrão de uso eficaz para o modo Datastore.

Índices em chaves sequenciais

Um mapa de calor com uma única linha diagonal brilhante pode indicar um índice em uma chave que aumenta ou diminui, como um carimbo de data/hora. Não é recomendável usar índices em chaves sequenciais, porque eles podem criar pontos de acesso. Ao usar o ponto de acesso, você pode observar latências elevadas correspondentes.

Alguns exemplos de hotspots comuns no índice são:

Hotspotting devido ao aumento da marcação de tempo

Mapa de calor mostrando pontos de concentração devido ao aumento da marcação de tempo

Neste exemplo, um mapa de calor com uma única linha diagonal brilhante pode indicar um banco de dados que usa operações de gravação/exclusão de índice estritamente crescentes ou decrescentes em uma propriedade de carimbo de data/hora.

Hotspotting devido ao aumento dos nomes de propriedades

Mapa de calor mostrando pontos de concentração devido ao aumento da propriedade

Neste exemplo, um mapa de calor com uma única linha diagonal brilhante pode indicar um banco de dados que usa operações de gravação/exclusão de índice estritamente crescentes ou decrescentes em uma propriedade incremental, como números de faturas gerados automaticamente.

Para identificar o problema de uso excessivo do ponto de acesso, use a ferramenta Key Visualizer e entenda a estrutura da chave de índice para determinar qual índice causa o problema e isentar esses índices com práticas recomendadas.

Entender a estrutura da chave de índice

Antes de entender a estrutura das chaves de índice que aparecem na ferramenta Key Visualizer, saiba mais sobre os índices no modo Datastore.

O código a seguir mostra um exemplo de formato de chave de índice que aparece quando você passa o cursor sobre o intervalo de chaves afetado no mapa de calor.

NAMESPACE: NS KIND: Users 
PROPERTIES: (Timestamp: DESC, Name: DESC)
ANCESTOR: KEY(PROJECT('PROJECT_ID'),NAMESPACE('NS'),`UserList`,1)
VALUES: (16500000000000001,'Alice')
ENTITY:KEY(PROJECT('PROJECT_ID'),NAMESPACE(''),`UserList`,1,`User`,5000000000000001)

Em que:

  • NAMESPACE: namespace da entidade.
  • KIND: tipo de entidade que categoriza as entidades.
  • PROPRIEDADES: propriedades relacionadas à entidade. A propriedade de ordenação __key__ só é mostrada para definições de índice que modificam a ordenação padrão.
  • ANCESTOR: caminho ancestral opcional para localizar a entidade na hierarquia do banco de dados.
  • VALUES: valor de cada propriedade.
  • ENTITY: ID da entidade atualizada em uma operação.

No exemplo anterior, identifique as propriedades do valor PROPERTIES para encontrar o índice afetado.

Para encontrar o índice, siga estas etapas:

  1. Acesse a página Índices do modo Datastore em Google Cloud console.

    Acessar "Índices do modo Datastore"

    Para identificar o tipo de índice, analise o campo PROPERTIES. Consulte exemplos de chaves de índice para mais informações.

  2. Clique em Filtrar, selecione Campos e insira o nome do campo.

    Use o operador OR para adicionar mais propriedades em caso de índices compostos.

Depois de identificar o índice que está causando problemas, use as seguintes soluções:

  • Índice integrado: exclua a propriedade para que o índice não mantenha entradas de índice para ela. Consulte Propriedades excluídas para mais informações.
  • Índice composto: modifique o índice no arquivo index.yaml para garantir que o campo cujo valor aumenta ou diminui monotonicamente não seja selecionado como o primeiro campo para indexação ou exclua o índice. Consulte Sobre index.yaml para mais informações.

Exemplos de entradas de chave de índice no mapa de calor

Tipo Descrição Exemplo
Entrada de índice integrada Entrada de índice para o índice de propriedade única na propriedade Timestamp, em ordem decrescente para o namespace NS. NAMESPACE: NS
KIND: Users
PROPERTIES: (Timestamp: DESC)
ANCESTOR: NONE
VALUES: (16500000000000001)
ENTITY: KEY(PROJECT('PROJECT_ID'), NAMESPACE('NS'),Usuários, 5000000000000001)
Entrada de índice integrada Entrada de índice para o índice de propriedade única no namespace padrão. NAMESPACE: ' '
KIND: Users
PROPERTIES: (Timestamp: DESC)
ANCESTOR: NONE
VALUES: (16500000000000001)
ENTITY: KEY(PROJECT('PROJECT_ID'), NAMESPACE('NS'),Usuários, 5000000000000001)
Entrada de índice composto Entrada de índice para o índice composto nas propriedades Timestamp e Name em ordem decrescente sem ancestral ativado. NAMESPACE: NS
KIND: Users
PROPERTIES: (Timestamp: DESC, Name: DESC)
ANCESTOR: NONE
VALUES: (16500000000000001, 'Alice')
ENTITY: KEY(PROJECT('PROJECT_ID'),NAMESPACE('NS'),Usuários,5000000000000001)
Entrada de índice composto com ancestral Entrada de índice para o índice composto na propriedade Timestamp em ordem decrescente e na propriedade Name em ordem decrescente com ancestral ativado. NAMESPACE: NS
KIND: Users
PROPERTIES: (Timestamp: DESC, Name: ASC)
ANCESTOR: KEY(PROJECT('PROJECT_ID'),NAMESPACE('NS'),UserList,1,User,5000000000000001
VALUES: (16500000000000001, 'Alice')
ENTITY: KEY(PROJECT('PROJECT_ID'),NAMESPACE('NS'),UserList,1,User,5000000000000001)
Entrada de índice composto com __key__ Entrada de índice para o índice composto na propriedade Timestamp em ordem crescente e __key__ em ordem decrescente sem ancestral ativado. Você pode usar __key__ como a propriedade final em uma definição de índice para mudar a ordenação padrão dos resultados. NAMESPACE: NS
KIND: Users
PROPERTIES: (Timestamp: ASC, __key__ DESC)
ANCESTOR: NONE
VALUES: (16500000000000001)
ENTITY: KEY(PROJECT('PROJECT_ID'),NAMESPACE('NS'),UserList,1,User,5000000000000001)

A seguir