Las variables anidadas le permiten crear relaciones dinámicas y dependientes entre las variables de sus dashboards. Esto le permite:
- Reutilice las variables dashboard y cambie dinámicamente lo que se muestra, especialmente para filtrar según los datos de otras variables.
- Crea relaciones padre/hijo en las variables, formando una estructura de árbol donde podrás seleccionar diferentes niveles de filtros.
Caso de uso
Imagina que creaste una variable Env
para seleccionar un entorno (por ejemplo, producción y de prueba). Desea actualizar una variable Machine
con una lista de máquinas según el entorno seleccionado. La incrustación directa de la variable Env en una condición WHERE
para Machine
no se admite en una configuración estándar.
Ejemplo:
Variable Env
=production
ostaging
Variable Machine
=SELECT uniques(machine) FROM Table WHERE env in ({{Env}})
Este enfoque directo no es compatible sin variables anidadas. Las variables anidadas resuelven esto al permitir que la consulta de su variable Machine
haga referencia dinámicamente al valor de su variable Env
.
Cómo emplear variables anidadas
Para implementar variables anidadas, siga estos pasos:
- Vaya a un dashboard que pueda editar.
- Crea tu variable padre (por ejemplo,
env
) empleando la funciónAdd Variable
:FROM TransactionSELECT uniques(environment) - Crea otra variable (por ejemplo,
variable_cluster
) y, al definirla, coloca{{env}}
dentro del cuadro de texto:FROM TableSELECT uniques(machine)WHERE env IN ({{env}}) - Almacene ambas variables.
- Vaya a su dashboard e interactúe con los valores de las variables. Deberían cambiar automáticamente en función de la selección del valor de la variable anidada.
Ahora puedes usar tu variable secundaria dentro de cualquier widget en tu dashboard. Cuando tu variable_cluster
cambie, ¡tu widget también cambiará!
Limitaciones
Cuando emplee variables anidadas, tenga en cuenta las siguientes limitaciones:
- Se requiere selección de variable principal para la definición de variable secundaria: cerciorar de que su variable
env
tenga valores seleccionados cuando defina su variablemachine
. De lo contrario, la consultamachine
no devolverá ningún resultado. - Selección de variable requerida para el uso widget : cerciorar de que la variable tenga valores seleccionados cuando la use dentro del widget. De lo contrario, la consulta del widget no devolverá ningún resultado.
- Impacto de la eliminación: si se elimina su variable
env
, su variablemachine
puede mostrar errores al cargar. - Valores borrados: si se borran los valores de su variable
env
, su variablemachine
continuará mostrando valores basados en las selecciones anteriores deenv
.