Trabalhar com variáveis aninhadas

Variáveis aninhadas permitem que você crie relacionamentos dinâmicos e dependentes entre variáveis no seu dashboard. Isso permite que você:

• Reutilize variáveis dashboard e altere dinamicamente o que é mostrado, especialmente para filtragem com base em dados de outras variáveis.
• Crie relacionamentos pai/filho em variáveis, formando uma estrutura de árvore onde você pode selecionar diferentes níveis de filtros.

Caso de uso

Imagine que você criou uma variável Env para selecionar um ambiente (por exemplo, produção e preparação). Você deseja atualizar uma variável Machine com uma lista de máquinas com base no ambiente selecionado. A incorporação direta da variável Env em uma condição WHERE para Machine não é suportada em uma configuração padrão.

Exemplo:

• Variable Env = production ou staging
• Variable Machine = SELECT uniques(machine) FROM Table WHERE env IN ({{Env}})

Essa abordagem direta não é suportada sem variáveis aninhadas. Variáveis aninhadas resolvem isso permitindo que a consulta da sua variável Machine referencie dinamicamente o valor da sua variável Env.

Como usar variáveis aninhadas

Para implementar variáveis aninhadas, siga estas etapas:

1. Acesse um dashboard que você pode editar.
2. Crie sua variável pai (por exemplo, env) usando a função Add Variable :

   FROM Transaction
   SELECT uniques(environment)

   Copiar
3. Crie outra variável (por exemplo, variable_cluster) e, ao defini-la, coloque {{env}} dentro da caixa de texto:

   FROM Table
   SELECT uniques(machine)
   WHERE env IN ({{env}})

   Copiar
4. Salve ambas as variáveis.
5. Acesse seu dashboard e interaja com os valores das variáveis. Eles devem mudar automaticamente com base na seleção do valor da variável aninhada.

Agora você pode usar sua variável filha dentro de qualquer widget no seu dashboard. Quando seu variable_cluster muda, seu widget também muda!

Limitações

Ao usar variáveis aninhadas, esteja ciente das seguintes limitações:

• Seleção de variável pai necessária para definição de filho: certifique-se de que sua variável env tenha valores selecionados ao definir sua variável machine. Caso contrário, a consulta machine não retornará resultados.
• Seleção de variável necessária para uso widget : certifique-se de que a variável tenha valores selecionados quando você usá-la dentro do widget. Caso contrário, a consulta do widget não retornará resultados.
• Impacto da exclusão: se sua variável env for excluída, sua variável machine poderá mostrar erros ao carregar.
• Valores apagados: se os valores da sua variável env forem apagados, sua variável machine continuará mostrando valores com base nas seleções anteriores de env.