Uso de parámetros en los paneles de Azure Data Explorer

Los parámetros se usan como bloques de creación para filtros en los paneles de Azure Data Explorer. Se administran en el ámbito del panel y se pueden agregar a las consultas para filtrar los datos que presentan los objetos visuales subyacentes. Una consulta puede utilizar uno o varios parámetros.

En este documento se describe la creación y el uso de parámetros y filtros vinculados en los paneles. Los parámetros se pueden usar para filtrar los objetos visuales del panel mediante la selección de valores de parámetro en la barra de filtro o mediante filtros cruzados.

Los ejemplos de consulta que se usan en este artículo se basan en la StormEvents tabla de la galería de ejemplos.

Nota

La administración de parámetros está disponible en modo de edición en los editores de paneles.

Requisitos previos

Visualización de la lista de parámetros

Para ver la lista de todos los parámetros del panel, seleccione el botón Parámetros en la parte superior del panel.

Captura de pantalla del botón parámetros en la parte superior del panel.

Creación de un parámetro

Para crear un parámetro:

  1. Cambie de Ver al modo de edición .

    Captura de pantalla del botón de edición en la parte superior del panel.

  2. Seleccione el botón Parámetros en la parte superior del panel.

    Captura de pantalla del botón parámetros en la parte superior del panel.

  3. Seleccione el botón + Nuevo parámetro en la parte superior del panel derecho.

  4. Rellene las propiedades pertinentes para el parámetro.

Propiedades admitidas

En el panel Agregar parámetro , configure las siguientes propiedades:

Campo Description
Label Nombre del parámetro que se muestra en el panel o en la tarjeta de edición.
Parameter type (Tipo de parámetro) Uno de los siguientes parámetros:
  • Single selection (Selección única): solo se puede seleccionar un valor en el filtro como entrada para el parámetro.
  • Multiple selection (Selección múltiple): se pueden seleccionar uno o varios valores en el filtro como entradas para el parámetro.
  • Intervalo de tiempo: permite crear parámetros adicionales para filtrar las consultas y los paneles de acuerdo con criterios temporales. De forma predeterminada, cada panel tiene un selector de intervalo de tiempo.
  • Free text (Texto libre): no tiene ningún valor rellenado en el filtro. El usuario puede escribir un valor o copiar y pegar un valor en el campo de texto. El filtro guarda los valores utilizados recientemente.
Nombre de la variable Nombre del parámetro que se va a utilizar en la consulta. Sugerencia: El prefijo de nombres de variables con un carácter distintivo, como un carácter de subrayado (_), hace que sean más fáciles de encontrar al escribir consultas.
Tipo de datos Tipo de datos del valor del parámetro.
Mostrar en páginas Seleccione las páginas donde se mostrará este parámetro. La opción Seleccionar todo muestra el parámetro en todas las páginas.
Origen Origen de los valores valor del parámetro:
  • Fixed values (Valores fijos): valores del filtro estático especificados manualmente.
  • Consultar valores especificados de forma dinámica mediante una consulta de KQL.
Valor predeterminado Valor predeterminado del filtro. El filtro se iniciará siempre con el valor predeterminado tras la representación inicial del panel.
Agregar un valor "Seleccionar todo" Solo se aplica a los tipos de parámetro de selección única y selección múltiple. Se utiliza para recuperar los datos de todos los valores de los parámetros. Este valor debe estar integrado en la consulta para ofrecer la funcionalidad. Para obtener más ejemplos de creación de estas consultas, consulte Uso del parámetro basado en consultas de selección múltiple.

Administrar parámetros

Después de seleccionar Parámetros en la barra superior, puede ver la lista de parámetros existentes. En cada tarjeta de parámetros, seleccione el widget de lápiz para editar el parámetro o seleccione el menú Más [...] para Duplicar, Eliminar o mover el parámetro.

En la tarjeta de parámetros, se pueden ver los siguientes indicadores:

  • Nombre para mostrar del parámetro
  • Nombres de variables
  • Número de consultas en las que se usó el parámetro
  • Páginas a las que está anclado el parámetro

Las tarjetas de parámetro se pueden ordenar mediante arrastrar y colocar o mediante la opción Mover a > y seleccionar la nueva ubicación.

Captura de pantalla de las tarjetas de parámetros de ejemplo.

Uso de parámetros en su consulta

Es necesario usar un parámetro en una consulta para que el filtro se aplique a los objetos visuales de esa consulta. Una vez definidos, los parámetros pueden verse en la página Consulta> filtro, en la barra superior, y en la consulta de IntelliSense.

Nota

Si el parámetro no se usa en la consulta, el filtro permanece inactivo. Una vez que el parámetro se agrega a la consulta, el filtro se activa.

Tipos de parámetro

Se admiten varios tipos de parámetros de panel, como se indica a continuación:

En los ejemplos siguientes, se describe cómo usar los parámetros en una consulta para varios tipos de parámetros.

Parámetro de intervalo de tiempo predeterminado

Cada panel tiene un parámetro de intervalo de tiempo predeterminado. Se muestra en el panel como un filtro únicamente cuando se usa en una consulta. Utilice las palabras clave _startTime y _endTime de parámetro para usar el parámetro de intervalo de tiempo predeterminado en una consulta, tal y como se muestra en el ejemplo siguiente:

StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

Una vez guardado, el filtro de intervalo de tiempo se muestra en el panel. Ahora, se puede usar para filtrar los datos de la tarjeta. Puede filtrar el panel; para ello, seleccione en la lista desplegable: Intervalo de tiempo (últimos x minutos, horas o días) o Intervalo de tiempo personalizado.

Captura de pantalla que muestra cómo filtrar mediante el intervalo de tiempo personalizado.

Parámetros de valores fijos de selección única

Los parámetros de valor fijo se basan en valores predefinidos que especifica el usuario. En el ejemplo siguiente, se muestra cómo crear un parámetro de valor fijo de selección única.

Creación de un parámetro de valores fijos de selección única

  1. Seleccione Parameters (Parámetros) para abrir el panel Parameters (Parámetros) y, a continuación, New parameter (Parámetro nuevo).

  2. Especifique los detalles siguientes:

    • Etiqueta: tipo de evento

    • Parameter type (Tipo de parámetro): Selección única

    • Variable name Nombre de la variable: _eventType

    • Data type Tipo de datos: String

    • Pin as dashboard filter (Anclar como filtro del panel): activado

    • Origen: Valores fijos

      En este ejemplo, se usan los siguientes valores:

      Value Nombre para mostrar del parámetro
      Viento de tormenta Viento de tormenta
      Granizo Granizo
      Riada Inundación
      Sequía Sequía
      Clima de invierno Clima de invierno
    • Agregue un valor Select all (Seleccionar todo): No activado

    • Valor predeterminado: Thunderstorm Wind

  3. Seleccione Done (Listo) para crear el parámetro.

El parámetro se puede ver en el panel lateral Parámetros , pero actualmente no se usan en ningún objeto visual.

Uso de un parámetro de valores fijos de selección única

  1. Ejecute una consulta de ejemplo con el nuevo parámetro Event TypTope mediante el nombre de variable _eventType :

    StormEvents
    | where StartTime between (_startTime.._endTime)
    | where EventType == _eventType
    | summarize TotalEvents = count() by State
    | top 5 by TotalEvents
    

    El nuevo parámetro se muestra en la lista de parámetros de la parte superior del panel.

  2. Seleccione valores diferentes para actualizar los objetos visuales.

    Pantallas que muestran el resultado de los cinco estados principales.

Parámetros de valores fijos de selección múltiple

Los parámetros de valor fijo se basan en valores predefinidos que especifica el usuario. En el ejemplo siguiente, se muestra cómo crear y utilizar un parámetro de valor fijo de selección múltiple.

Creación de parámetros de valores fijos de selección múltiple

  1. Seleccione Parameters (Parámetros) para abrir el panel Parameters (Parámetros) y, a continuación, New parameter (Parámetro nuevo).

  2. Rellene los detalles como se mencionó en Uso de un parámetro de valores fijos de selección única con los siguientes cambios:

    • Etiqueta: tipo de evento
    • Parameter type (Tipo de parámetro): Selección múltiple
    • Variable name (Nombre de la variable): _eventType
  3. Seleccione Done (Listo) para crear el parámetro.

Los nuevos parámetros se pueden ver en el panel lateral Parameters (Parámetros), pero no se utilizan en ningún objeto visual.

Uso de un parámetro de valores fijos de selección múltiple

  1. Ejecute una consulta de ejemplo mediante el nuevo parámetro Event Type mediante la _eventType variable .

    StormEvents
    | where StartTime between (_startTime.._endTime)
    | where EventType in (_eventType) or isempty(_eventType)
    | summarize TotalEvents = count() by State
    | top 5 by TotalEvents
    

    El nuevo parámetro se muestra en la lista de parámetros de la parte superior del panel.

  2. Seleccione uno o más valores diferentes para actualizar los objetos visuales.

    Captura de pantalla que muestra cómo seleccionar varios tipos de eventos.

Parámetros basados en consultas de selección única

Los valores de parámetros basados en consulta se obtienen durante la carga del panel al hacer la consulta con parámetros. En el ejemplo siguiente, se muestra cómo crear un parámetro de selección única basado en consulta.

Creación de un parámetro basado en consultas de selección única

  1. Seleccione Parameters (Parámetros) para abrir el panel Parameters (Parámetros) y, a continuación, New parameter (Parámetro nuevo).

  2. Rellene los detalles como se mencionó en Uso de un parámetro de valores fijos de selección única con los siguientes cambios:

    • Etiqueta: estado

    • Variable name (Nombre de la variable): _state

    • Origen: Consultar

    • Origen de datos: StormEventsSample

    • Seleccione Editar consulta y escriba la siguiente consulta. Seleccione Listo.

      StormEvents
      | where StartTime between (_startTime.._endTime)
      | where EventType in (_eventType) or isempty(_eventType)
      | summarize TotalEvents = count() by State
      | top 5 by TotalEvents
      | project State
      
    • Valor: estado

    • Nombre para mostrar: Estado

    • Valor predeterminado: elija un valor predeterminado.

  3. Seleccione Done (Listo) para crear el parámetro.

Uso de un parámetro basado en consultas de selección única

  1. La siguiente consulta de ejemplo con el nuevo parámetro State usa la _state variable :

    StormEvents
    | where StartTime between (_startTime.._endTime)
    | where EventType in (_eventType) or isempty(_eventType)
    | where State == _state
    | summarize TotalEvents = count() by State
    | top 5 by TotalEvents
    

    El nuevo parámetro se muestra en la lista de parámetros de la parte superior del panel.

  2. Seleccione valores diferentes para actualizar los objetos visuales.

Parámetros basados en consultas de selección múltiple

Los valores de parámetros basados en consulta se obtienen en el tiempo de carga del panel al ejecutar la consulta especificada por el usuario. En el ejemplo siguiente, se muestra cómo crear un parámetro de selección múltiple basado en consulta.

Creación de un parámetro basado en consultas de selección múltiple

  1. Seleccione Parámetros para abrir el panel Parámetros y seleccione + Nuevo parámetro.

    1. Rellene los detalles como se mencionó en Uso de un parámetro de valores fijos de selección única con los siguientes cambios:
    • Etiqueta: estado
    • Parameter type (Tipo de parámetro): Selección múltiple
    • Variable name (Nombre de la variable): _state
  2. Seleccione Done (Listo) para crear el parámetro.

Uso de un parámetro basado en consultas de selección múltiple

  1. En la consulta de ejemplo siguiente se usa el nuevo parámetro State mediante la _state variable .

    StormEvents
    | where StartTime between (_startTime.._endTime)
    | where EventType in (_eventType) or isempty(_eventType)
    | where State in (_state) or isempty(_state)
    | summarize TotalEvents = count() by State
    | top 5 by TotalEvents
    

    Nota:

    En este ejemplo se usa la opción Seleccionar todo al comprobar si hay valores vacíos mediante la función isempty().

    El nuevo parámetro se muestra en la lista de parámetros de la parte superior del panel.

  2. Seleccione uno o más valores diferentes para actualizar los objetos visuales.

Parámetros de texto libre

Los parámetros de texto libre no contienen ningún valor. Le permiten introducir su propio valor.

Creación de un parámetro de texto libre

  1. Seleccione Parámetros para abrir el panel Parámetros y seleccione + Nuevo parámetro.

  2. Especifique los detalles siguientes:

    • Etiqueta: estado
    • Parameter type (Tipo de parámetro): Free text (Texto libre)
    • Nombre de variable: _state
    • Data type Tipo de datos: String
    • Valor predeterminado: Ningún valor predeterminado.

Uso de un parámetro de texto libre

  1. Ejecute una consulta de ejemplo con el nuevo parámetro State mediante el nombre de la _state variable:

    StormEvents
    | where StartTime between (_startTime.._endTime)
    | where EventType in (_eventType) or isempty(_eventType)
    | where State contains _state
    | summarize TotalEvents = count() by State
    | top 5 by TotalEvents
    

Parámetros del origen de datos

Una vez que haya agregado orígenes de datos al panel, puede crear un parámetro que seleccione uno o varios de los orígenes de datos disponibles. Este parámetro se puede usar en iconos y otros parámetros.

Creación de un parámetro de origen de datos

  1. Seleccione Parámetros para abrir el panel Parámetros y seleccione + Nuevo parámetro.

  2. Especifique los detalles siguientes:

    • Etiqueta: Origen
    • Tipo de parámetro: Origen de datos
    • Mostrar en páginas: Seleccionar todo
    • Valores: seleccione todos
    • Valor predeterminado: StormEventsSample
  3. Seleccione Listo.

El nuevo parámetro ahora está visible en la lista de parámetros de la parte superior del panel.

Uso de un parámetro de origen de datos

  1. Vaya a la consulta de un icono nuevo o existente.

  2. En Origen, seleccione el nombre del nuevo parámetro en Parámetros de origen de datos. Para el parámetro creado anteriormente, seleccione Clúster.

  3. Seleccione Aplicar cambios.

  4. Use el parámetro Cluster para cambiar el origen de datos de esta consulta conectada.

Parámetros de filtros cruzados

Los filtros cruzados permiten seleccionar un valor en un objeto visual y todos los objetos visuales de los paneles, como los gráficos de líneas o de dispersión, se filtran para que muestren solo los datos relacionados. El uso de filtros cruzados consigue el mismo resultado que si se selecciona el valor equivalente del parámetro en la lista de parámetros de la parte superior del panel.

Definición de filtros cruzados

Para crear un filtro cruzado, debe activar la opción en el objeto visual y, a continuación, especificar el parámetro que se usa para filtrar los datos.

  1. Vaya a la consulta del icono donde desea agregar filtros cruzados.

  2. Seleccione Objeto visual.

  3. En el panel derecho, seleccione Interacciones y active los filtros cruzados.

  4. Opcionalmente, especifique el tipo de interacción . El valor predeterminado es Point (Punto ), donde puede seleccionar un valor en el objeto visual. Para seleccionar un intervalo de valores, como en un gráfico de tiempo, seleccione Arrastrar.

  5. Especifique la columna que se usa para proporcionar el valor y un parámetro usado para filtrar la consulta.

    Importante

    La columna y el parámetro deben ser del mismo tipo de datos.

Captura de pantalla de la página editar objeto visual, en la que se muestra la pestaña interacciones.

Interacción con los datos mediante filtros cruzados

Una vez definido el filtro cruzado, puede usarlo para interactuar con los datos. En los objetos visuales en los que ha definido filtros cruzados, puede seleccionar puntos de datos y usar sus valores para filtrar la página actual del panel. En el caso de los objetos visuales de tabla, seleccione puntos de datos haciendo clic con el botón derecho en la celda correspondiente y, a continuación, en el menú contextual, seleccione Filtro cruzado.

Captura de pantalla de un objeto visual de tabla que muestra la opción de menú contextual de filtro cruzado.

Para restablecer el filtro cruzado, seleccione Restablecer en la parte superior del objeto visual donde se seleccionó.

Captura de pantalla de un objeto visual de tabla que muestra el botón Restablecer.

Uso de obtenciones de detalles como parámetros de panel

Con la obtención de detalles, puede seleccionar un valor en un objeto visual y usarlo para filtrar los objetos visuales de una página de destino del mismo panel. Cuando se abre la página de destino, el valor se preselecciona en los filtros pertinentes. Los objetos visuales de la página, como los gráficos de líneas o de dispersión, se filtran para mostrar solo los datos relacionados.

Definición de una obtención de detalles

Para crear una obtención de detalles, primero debe activarla en el objeto visual y, a continuación, agregar una o varias obtenciones de detalles según sea necesario.

  1. Edite el objeto visual en el que desea agregar una obtención de detalles. Asegúrese de que la pestaña Objeto visual está seleccionada.

  2. En el panel derecho, seleccione Interacciones y active la obtención de detalles.

    Captura de pantalla de la página de obtención de detalles, en la que se muestra la opción Activar.

  3. En Obtención de detalles, seleccione Crear nueva y especifique la siguiente información. Opcionalmente, seleccione Agregar otro par para agregar varios parámetros para una página de destino. Repita este paso para agregar obtenciones de detalles a otras páginas del panel actual mediante parámetros diferentes.

    Campo Descripción
    Página de destino Una o varias páginas de destino para explorar en profundidad el uso de los parámetros definidos.
    Columna Columna del resultado de la consulta que se va a usar como valor para un parámetro en la página de destino.
    Parámetro Parámetro que se usa para filtrar objetos visuales en la página de destino mediante el valor de columna.
    Notas Descripción breve opcional.

    Importante

    Los pares de columna y parámetro deben ser del mismo tipo de datos.

Interacción con los datos mediante obtenciones de detalles

Una vez definidas las obtenciones de detalles, puede utilizarlas para interactuar con los datos. Para ello, en los objetos visuales o tablas en las que ha definido una obtención de detalles, haga clic con el botón derecho en un punto de datos y seleccione Obtención de detalles para>página de destino. Los valores del punto de datos se usarán como parámetros para filtrar los objetos visuales en la página de destino.

Captura de pantalla de un objeto visual de panel que muestra la interacción de obtención de detalles.

Para volver a la página de origen, en la parte superior derecha de la página de destino, seleccione Restablecer. Se restablecerán todos los filtros asignados por la obtención de detalles.

Uso de la búsqueda de filtro para filtros de selección única y múltiple

En los filtros de selección única y múltiple, escriba el valor que desee. El filtro se actualiza para mostrar solo los valores que coinciden con el término de búsqueda.