Uso de parámetros basados en consultas

El artículo le guía por los pasos necesarios para crear un panel interactivo que use parámetros basados en consultas. Asume que tiene un conocimiento básico de la creación de paneles en Azure Databricks. Consulte Introducción para obtener instrucciones básicas sobre la creación de paneles.

Requisitos

• Ha iniciado sesión en un área de trabajo de Azure Databricks.
• Tiene el derecho de SQL en esa área de trabajo.
• Tiene al menos acceso CAN USE a uno o más almacenes SQL.

Crear un conjunto de datos de panel

Este tutorial usa datos generados del catálogo de muestras en Azure Databricks.

1. Haga clic en Nuevo en la barra lateral y seleccione Panel en el menú.

2. Haga clic en la pestaña Datos .

3. Haga clic en Crear a partir de SQL y pegue la siguiente consulta en el editor. A continuación, haga clic en Ejecutar para devolver los resultados.

   SELECT
     *
   FROM
     samples.tpch.customer
   

4. El conjunto de datos recién definido se guarda automáticamente con el nombre Conjunto de datos sin título. Haga doble clic en el título y cámbiele el nombre a Segmento de marketing.

Agregar un parámetro

Puede agregar un parámetro a este conjunto de datos para filtrar los valores devueltos. El parámetro de este ejemplo es :segment. Consulte Trabajar con parámetros del panel para obtener más información sobre la sintaxis de parámetros.

1. Pegue la siguiente cláusula WHERE en la parte inferior de la consulta. Un campo de texto con el nombre del parámetro segment aparece debajo de la consulta.

   WHERE
     c_mktsegment = :segment
   

2. Escriba BUILDING en el campo de texto situado debajo de la consulta para establecer el valor predeterminado del parámetro.

3. Vuelva a ejecutar la consulta para inspeccionar los resultados.

Configurar un widget de visualización

Agregue una visualización para su conjunto de datos en el lienzo completando los siguientes pasos:

1. Haga clic en la pestaña Canvas.
2. Haga clic en Agregar una visualización para agregar un widget de visualización y use el mouse para colocarlo en el lienzo.

Configuración del eje X

1. Si es necesario, seleccione barra en el menú desplegable Visualización.
2. Haga clic en para elegir los datos presentados a lo largo del eje X. Puede usar la barra de búsqueda para buscar un campo por nombre. Seleccione c_nationkey.
3. Haga clic en el nombre del campo seleccionado para ver opciones de configuración adicionales.
   • Como Tipo de escala, seleccione Categórico.
   • Para la selección Transformar, elija Ninguno.

Configuración del eje Y

1. Haga clic junto al eje Y y seleccione c_acctbal.
2. Haga clic en el nombre del campo seleccionado para ver opciones de configuración adicionales.
   • Como Tipo de escala, seleccione cuantitativa.
   • Para la selección Transformar, elija SUM.

La visualización se actualiza automáticamente a medida que la configura. Los datos que se muestran solo incluyen registros donde segment es BUILDING.

Agregar un filtro

Configure un filtro para que los espectadores del panel puedan controlar en qué segmento de marketing centrarse.

1. Haga clic en Agregar un filtro (campo o parámetro) para agregar un widget de filtro. Colóquelo en el lienzo.
2. En el menú desplegable Filtro del panel de configuración, seleccione Valor único.
3. Seleccione la casilla Título para mostrar un campo de título en su widget de filtro.
4. Haga clic en el título del marcador de posición en el widget y escriba Segmento para cambiar el título del filtro.
5. Haga clic en , junto a Parámetros, en el panel de configuración.
6. Elija segmento en el conjunto de datos de Segmento de marketing.

El widget de filtro configurado muestra el valor predeterminado del parámetro para el conjunto de datos.

Definir una selección de valores

El filtro que ha creado es funcional, pero requiere que el espectador conozca el rango disponible de opciones antes de que pueda escribir una selección. También requiere que los usuarios respeten las mayúsculas y minúsculas y la ortografía al escribir el valor del parámetro deseado.

Para crear una lista desplegable de modo que el espectador pueda seleccionar un parámetro de una lista de opciones disponibles, cree un nuevo conjunto de datos para definir la lista de valores posibles.

1. Haga clic en la pestaña Datos .

2. Haga clic en Crear desde SQL para crear un nuevo conjunto de datos.

3. Copie y pegue lo siguiente en el editor:

   SELECT
     DISTINCT c_mktsegment
   FROM
     samples.tpch.customer
   

4. Ejecute la consulta e inspeccione los resultados. Los cinco segmentos de marketing de la tabla aparecen en los resultados.

5. Haga doble clic en el título generado automáticamente y luego cambie el nombre de este conjunto de datos por Selección de segmento.

Actualización del filtro

Actualice el filtro existente para utilizar el conjunto de datos que acaba de crear para rellenar una lista desplegable de valores que los usuarios pueden seleccionar.

1. Haga clic en Lienzo. A continuación, haga clic en el widget de filtro que creó en un paso anterior.
2. Haga clic en junto a Campos.
3. Haga clic en Selección de segmento y luego haga clic en el nombre del campo c_mktsegment.

El widget de filtro se actualiza a medida que cambia la configuración. Haga clic en el campo del widget de filtro para ver las opciones disponibles en el menú desplegable.

Nota:

Este tutorial contiene un caso de uso simplificado diseñado para demostrar cómo usar parámetros basados en consultas. Un enfoque alternativo para crear este panel es aplicar un filtro al campo c_mktsegment.

Pasos siguientes

Siga aprendiendo sobre cómo trabajar con paneles con los siguientes artículos:

• Obtenga más información sobre cómo aplicar filtros. Consulte Filtros.
• Obtenga más información sobre los parámetros del panel. Consulte Trabajar con parámetros del panel.
• Publique y comparta su panel. Consulte Habilitar un espacio de Genie desde el panel.