Paneles heredados

Puede usar el editor de SQL para crear un panel heredado que combine visualizaciones y cuadros de texto que proporcionen contexto con los datos.

Visualización y organización de paneles heredados

Puede acceder a los paneles desde el explorador del área de trabajo junto con otros objetos de Azure Databricks.

• Haga clic en Área de trabajo en la barra lateral para ver los paneles desde el explorador del área de trabajo. Los paneles se almacenan en el directorio /Workspace/Users/<username> de forma predeterminada. Los usuarios pueden organizar paneles en carpetas en el explorador del área de trabajo junto con otros objetos de Azure Databricks.

• Para ver la página de lista del panel, haga clic en Paneles en la barra lateral.

• Haga clic en la pestaña Paneles heredados para ver los paneles heredados.

  De forma predeterminada, la pestaña Mis paneles está seleccionada y muestra los paneles que posee ordenados en orden cronológico inverso. Para reordenar la lista, haga clic en el encabezado Creado en. O bien, use las pestañas situadas cerca de la parte superior de la página para ver Favoritos o Todos los paneles. Use la pestaña Etiquetas para filtrar por etiqueta.

Organización de paneles en carpetas en el explorador del área de trabajo

Organice paneles nuevos y existentes en carpetas en el explorador del área de trabajo junto con otros objetos de Azure Databricks. Consulte Explorador del área de trabajo.

Filtrado de la lista de paneles guardados

Filtre la lista de todos los paneles por paneles que creó (Mis paneles), por favoritos y por etiquetas.

Crear un panel heredado

Siga estos pasos para crear un panel heredado. Para clonar un panel existente, consulte Clonación de un panel heredado.

1. Haga clic en Panel en la barra lateral y, a continuación, haga clic en la pestaña Paneles heredados.
2. Haga clic en Crear panel heredado.
3. Escriba un nombre para el panel.
4. Al crear un panel, tiene la opción de especificar un almacén que se usará para la actualización manual. Si no selecciona y guarda un almacén en el panel, se revertirá al uso del almacén guardado en consultas individuales.

1. Para agregar contenido al panel, haga clic en Agregar y seleccione el tipo de contenido que se va a agregar:

   • Haga clic en Cuadro de texto para agregar comentarios.

     Escriba el texto. Estiliza los cuadros de texto 0tilizando Markdown.

     • Para agregar una imagen estática en un cuadro de texto, utilice la sintaxis de la imagen de Markdown con una descripción y una dirección URL disponible públicamente: ![description](url). Por ejemplo, el siguiente archivo Markdown inserta una imagen del logotipo de Databricks: ![The Databricks Logo](https://upload.wikimedia.org/wikipedia/commons/6/63/Databricks_Logo.png). Para cambiar el tamaño de la imagen, cambie el tamaño de las dimensiones del widget.
     • Para añadir una imagen desde DBFS, añade la sintaxis de imagen markdown con la descripción deseada y la ruta del Almacén de Archivos: ![description](files/path_to_dbfs_image). Para cambiar el tamaño de la imagen, cambie el tamaño de las dimensiones del widget.

     Importante

     Las imágenes usadas en un panel que se almacenan en DBFS no se representarán al realizar un pdf o una suscripción a petición

   • Haga clic en Visualización para agregar una visualización de consulta.

     1. Seleccione una consulta. Busque las consultas existentes o elija una reciente de la lista rellenada previamente. Si una consulta se ha guardado con la configuración Límite 1000, la consulta del panel limita los resultados a 1000 filas.

     2. En la lista desplegable Choose Visualization (Elegir visualización), seleccione el tipo de visualización.

        

2. Haga clic en Agregar al panel heredado.

3. Arrastre y coloque bloques de contenido en el panel.

4. Haga clic en Edición finalizada.

   

También puede crear un panel con el proveedor Terraform de Databricks y databricks_sql_dashboard. Puede crear un widget para heredar un panel con databricks_sql_widget. Puede crear un panel heredado de ejemplo con dbsql-nyc-taxi-trip-analysis.

Clonar un panel heredado

Puede clonar el panel heredado y todas las consultas ascendentes si tiene los permisos CAN RUN, CAN EDIT y CAN MANAGE en el panel y cada una de sus consultas ascendentes. Se convierte en el propietario del nuevo panel y de las consultas.

Para clonar un panel heredado:

1. Abra el menú kebab en la parte superior derecha del panel y seleccione Clonar.
2. Escriba un nombre para el nuevo panel y, después, haga clic en Confirmar.

Para más información sobre los parámetros de lista desplegable basada en consultas, consulte Lista desplegable basada en consultas.

Usar parámetros de consulta en paneles heredados

Opcionalmente, las consultas pueden aprovechar parámetros o valores estáticos. Cuando se agrega una visualización basada en una consulta con parámetros a un panel, la visualización se puede configurar para usar:

• Parámetros de widget: los parámetros de widget son específicos de una única visualización dentro de un panel, aparecen dentro del panel de visualización y los valores de los parámetros especificados solo se aplican a la consulta subyacente a la visualización.
• Parámetro de panel: los parámetros de panel heredados se pueden aplicar a varias visualizaciones. Al agregar una visualización basada en una consulta con parámetros a un panel, el parámetro se contará de manera predeterminada como parámetro de panel. Los parámetros del panel se configuran para una o varias visualizaciones dentro de un panel y aparecen en la parte superior del panel. Los valores de parámetro especificados para un parámetro de panel se aplican a las visualizaciones que reutilizan ese parámetro de panel determinado. Un panel puede tener varios parámetros, cada uno de los cuales puede aplicarse a algunas visualizaciones y no a otras.
• Valor estático: los valores estáticos se usan en lugar de un parámetro que responde a los cambios. Los valores estáticos permiten codificar de forma rígida un valor en lugar de un parámetro y harán que el parámetro "desaparezca" del panel o widget donde aparecía anteriormente.

Al agregar una visualización que contiene una consulta parametrizada, puede elegir el título y el origen del parámetro en la consulta de visualización si hace clic en el icono de lápiz adecuado . También puede seleccionar la palabra clave y un valor predeterminado. Consulte Propiedades de parámetro.

Después de agregar una visualización a un panel, puede acceder a la interfaz de asignación de parámetros haciendo clic en el menú kebab en la parte superior derecha de un widget de panel y, a continuación, haciendo clic en Cambiar configuración del widget.

Propiedades del parámetro

Las propiedades del parámetro del widget del panel son:

• Título: nombre para mostrar que aparece junto al selector de valores en el panel. El valor predeterminado es el título establecido en el editor de consultas. Para editar cómo aparece en el panel, haga clic en el icono de lápiz . Los títulos de los parámetros estáticos del panel no aparecen porque el selector de valores está oculto. Si selecciona Valor estático como Origen del valor, el campo Título aparece atenuado.

• Palabra clave: literal de cadena de este parámetro en la consulta subyacente. Esto resulta útil para depurar si el panel no devuelve los resultados esperados.

• Valor predeterminado: valor establecido para ese parámetro en la carga del panel hasta que se selecciona otro y se aplican los cambios. Para cambiar este valor predeterminado, abra la consulta subyacente en el editor de SQL, cambie el parámetro por el valor deseado y haga clic en el botón Guardar.

• Origen del valor: origen del valor del parámetro. Haga clic en el icono de lápiz para elegir un origen.

  • Nuevo parámetro de panel: cree un nuevo parámetro de nivel de panel. Esto le permite establecer un valor de parámetro en un solo lugar en el panel y asignarlo a una o más visualizaciones. Los parámetros deben tener nombres únicos en el panel.
  • Parámetro de panel existente: asigne este parámetro de visualización a un parámetro de panel existente. Debe especificar qué parámetro de panel ya existente.
  • Parámetro de widget: muestra un selector de valores dentro del widget de panel. Esto es útil para parámetros únicos que no se comparten entre widgets.
  • Valor estático: elija un valor estático para el widget, independientemente de los valores usados en otros widgets. Los valores de parámetro asignados estáticamente no muestran un selector de valores en ningún lugar del panel, que es más compacto. Esto le permite aprovechar la flexibilidad de los parámetros de consulta sin abarrotar la interfaz de usuario en un panel si no se espera que determinados parámetros cambien con frecuencia.

  

Editar un panel heredado

Para abrir el panel para su edición, abra el menú kebab en la parte superior derecha del panel y seleccione Editar.

Al realizar la edición, puede agregar y quitar contenido, editar las visualizaciones y aplicar filtros. Para cambiar el orden en que se muestran los parámetros, puede hacer clic y arrastrar cada parámetro a la posición deseada.

Filtrado entre varias consultas

Para filtrar entre varias consultas en un panel:

1. Vaya al panel heredado.
2. En el modo edición, haga clic en Agregar y, a continuación, haga clic en Filtrar.
3. Seleccione Nuevo filtro de panel y elija las consultas y columnas que desea filtrar. También puede optar por importar filtros de las consultas existentes seleccionando Filtros de consulta existentes y eligiendo importar un filtro desde un editor de consultas SQL. Las consultas que elija deben pertenecer al mismo catálogo y esquema.
4. Haga clic en Save(Guardar). Esto crea un filtro que contiene la unión de todas las opciones desplegables.

Edición de visualización de paneles

Para editar una visualización en el panel mientras está en modo de edición, selecciónela y haga clic en el menú kebab de la parte superior derecha de la visualización. En la lista mostrada, seleccione Editar visualización.

Adición de contenido a un panel

1. Abra el panel para editarlo.
2. Haga clic en Agregar cuadro de texto o Agregar widget.
3. Haga clic en Agregar al panel heredado.
4. Haga clic en Edición finalizada.

También puede agregar la visualización a un panel en el editor de SQL.

Eliminación de contenido de un panel

1. Haga clic en o mantenga el puntero sobre el objeto, haga clic en el menú kebab situado en la parte superior derecha del widget y seleccioneQuitar del panel.
2. Haga clic en Eliminar.

Filtros del panel

Cuando las consultas tienen filtros también debe aplicar filtros en el nivel de panel. Active la casilla Use Dashboard Level Filters (Usar filtros de nivel de panel) para aplicar el filtro a todas las consultas.

Colores de personalización del panel

Puede personalizar la paleta de colores del panel, incluida la creación de una paleta de colores.

Creación de una paleta de colores

Para crear una paleta de colores personalizada para un panel:

1. Haga clic en el menú kebab en la esquina superior derecha y haga clic en Editar.
2. Haga clic en Colores.
3. Para importar una paleta de colores existente, haga clic en Importar y seleccione la paleta. Puede personalizar la paleta importada.
4. Para crear una nueva paleta o personalizar una importada, haga lo siguiente:
   1. Para agregar un nuevo color, haga clic en Agregar.
   2. Para un color recién agregado o un color existente, especifique el color mediante una de las siguientes acciones:
      • Haga clic en el cuadrado y seleccione el nuevo color; para ello, haga clic en él en el selector de colores o con el cuentagotas.
      • Haga clic en el campo de texto situado junto al cuadrado y escriba un valor hexadecimal.
5. Haga clic en Aplicar.

Dejar de usar una paleta de colores personalizada

Para quitar una paleta de colores personalizada:

1. Haga clic en el menú kebab en la esquina superior derecha y haga clic en Editar.
2. Haga clic en Colors (Colores).
3. Haga clic en Clear (Borrar).
4. Haga clic en Aplicar.

Usar una paleta de colores diferente para una visualización

De manera predeterminada, si se ha aplicado una paleta de colores en un panel, todas las visualizaciones usarán esa paleta de colores. Si quiere usar colores diferentes para una visualización, puede invalidar este comportamiento:

1. Haga clic en el menú kebab para la visualización en el panel y haga clic en Editar.
2. Haga clic en la casilla situada junto a Conservar colores especificados en la visualización.
3. Haga clic en Aceptar.

Actualización de un panel

Los paneles heredados están diseñados para una carga eficaz a medida que recuperan datos de una caché que se renueva cada vez que se ejecuta una consulta. Sin embargo, los paneles pueden quedar obsoletos si no ejecuta periódicamente las consultas asociadas. Para evitar que los paneles se vuelvan obsoletos, puede actualizar el panel para volver a ejecutar las consultas asociadas.

Cada vez que se actualiza un panel, ya sea manualmente o según una programación, se actualizan todas las consultas a las que se hace referencia en el panel. Cuando se actualiza una visualización individual, se actualiza la consulta ascendente. La actualización manual del panel o la visualización individual no actualiza las consultas usadas en las listas desplegables basadas en consultas. Para obtener más información sobre las listas desplegables basadas en consultas, lea Lista desplegable basada en consultas.

Actualización del comportamiento y del contexto de ejecución

Cuando se “Ejecuta un panel como propietario” y se agrega una programación, se usa la credencial del propietario para su ejecución y cualquier persona con al menos el permiso CAN RUN ve los resultados de esas consultas actualizadas.

Cuando un panel es "Ejecutar como visor" y se agrega una programación, la credencial del propietario se usa para su ejecución, pero solo el propietario ve los resultados de las consultas actualizadas; todos los demás visores deben actualizarse manualmente para ver los resultados de la consulta actualizados.

Actualización manual de un panel

Para forzar una actualización, haga clic en Actualizar en la parte superior derecha del panel. Esto ejecuta todas las consultas del panel y actualiza sus visualizaciones.

Actualización automática de un panel

El propietario y los usuarios del panel con el permiso CAN EDIT pueden configurar un panel para actualizarse automáticamente según una programación. Para actualizar automáticamente un panel:

1. Haga clic en Programación en la esquina superior derecha del panel. A continuación, haga clic en Agregar programación.

2. Use los selectores desplegables para especificar la frecuencia, el período, la hora de inicio y la zona horaria. Opcionalmente, active la casilla Mostrar sintaxis de cron para editar la programación en Sintaxis Quartz de cron.

3. Elija Más opciones para mostrar la configuración opcional. Puede elegir:

   • Nombre de la programación.
   • Un almacén de SQL para impulsar la consulta. De manera predeterminada, el almacén de SQL que se usa para la ejecución de consultas ad hoc también se usa para un trabajo programado. Use esta configuración opcional para seleccionar otro almacenamiento para ejecutar la consulta programada.

   Nota:

   Este almacén puede ser diferente del utilizado para la actualización manual.

4. Opcional: en la pestaña Suscriptores, escriba una lista de direcciones de correo electrónico para notificar cuándo se actualiza automáticamente el panel. Cada dirección de correo electrónico debe estar asociada a una cuenta de Azure Databricks con acceso al área de trabajo o definida como destino de notificación en la configuración del área de trabajo. Un administrador del área de trabajo configura los destinos de notificación.

5. Haga clic en Crear. La etiqueta de Programación cambia a Programación(1).

6. Edite la configuración de uso compartido.

   Nota:

   Los permisos del panel no están vinculados a los permisos de programación. Después de crear el intervalo de actualización programado, edite los permisos de programación para proporcionar acceso a otros usuarios. Solo los usuarios con permiso CAN MANAGE pueden editar la programación o editar la lista de suscriptores.

   • Haga clic en el menú kebab .
   • Haga clic en Editar permisos de programación.
   • Elija un usuario o grupo en el menú desplegable del cuadro de diálogo.
   • Elija CAN VIEW (VER) para permitir que los usuarios seleccionados vean la configuración de programación.

EL permiso CAN VIEW o CAN RUN permite al destinatario asignado ver que existe una programación, así como otras propiedades, como la cadencia de informes y el número de suscriptores. CAN MANAGE permite al destinatario modificar la programación, la lista de suscriptores y el permiso de programación. El permiso CAN MANAGE también permite al destinatario pausar o despausar la programación.

Actualización del comportamiento en un panel abierto

Al abrir un panel establecido en Run as Owner, muestra los datos de la actualización del panel más reciente, con independencia de si se programó o actualizó manualmente. Si un panel está abierto en una ventana del explorador y se modifica una consulta o se modifican los resultados del panel de actualizaciones de ejecución programadas, los cambios no se reflejarán inmediatamente. Los resultados actualizados aparecerán la próxima vez que abra el panel o actualice la ventana del explorador abierto.

Suscripciones de instantáneas del panel

Puede exportar periódicamente y enviar por correo electrónico instantáneas del panel. Las instantáneas del panel se toman del estado predeterminado del panel, lo que significa que cualquier interacción con los filtros y visualizaciones no se incluye en la instantánea.

Si tiene al menos el permiso CAN EDIT, puede crear una programación de actualización y suscribirse a otros usuarios, que recibirán instantáneas de correo electrónico del panel cada vez que se actualice. Para agregar suscriptores, escriba usuarios o grupos en la pestaña Suscriptores, tal y como se ha descrito anteriormente. Los suscriptores aptos incluyen usuarios del área de trabajo y destinos de notificación.

Hay un límite de tamaño de archivo de 6 MB para los datos adjuntos de correo electrónico. Si un correo electrónico de suscripción de panel supera el límite de tamaño de 6 MB, el correo electrónico omitirá la instantánea del panel insertado e incluirá solo un PDF de la instantánea del panel.

Si el archivo de instantáneas PDF supera los 6 MB, el correo electrónico de suscripción omitirá el PDF e incluirá en su lugar un vínculo al panel actualizado. El correo electrónico tendrá una nota de advertencia que detalla el tamaño actual del panel. (Los usuarios pueden probar el tamaño de la instantánea PDF descargando manualmente un PDF del panel).

Pausa temporal de las actualizaciones programadas del panel

Si un panel está configurado para actualizaciones automáticas y tiene al menos el permiso CAN VIEW según la programación, la etiqueta del botón Programación lee Schedule(#), donde #es el número de eventos programados que son visibles para usted. Además, si tiene al menos el permiso CAN MANAGE según la programación, puede pausar temporalmente la programación. Esto resulta útil para evitar el envío de actualizaciones mientras se prueban los cambios en el panel. Para pausar temporalmente las actualizaciones programadas del panel sin modificar la lista de suscriptores:

1. Haga clic en Programación(#).
2. Haga clic en el menú kebab .
3. Haga clic en Pausar.

Detención de la actualización automática de un panel

Para detener la actualización automática del panel y quitar sus suscripciones:

1. Haga clic en Programación(#).
2. Haga clic en el menú kebab >Eliminar.

Límites de tamaño del panel para suscripciones

Los correos electrónicos de suscripción del panel heredado incluyen los siguientes archivos codificados en base64:

• PDF: archivo PDF que incluye el panel completo.
• DesktopImage: un archivo de imagen optimizado para su visualización en equipos de escritorio.

Se impone un límite máximo de 6 MB en el tamaño combinado de los dos archivos. En las descripciones siguientes se describe el comportamiento esperado cuando el tamaño de archivo combinado supera el límite:

• Si el archivo PDF es mayor que 6 MB: el correo electrónico de suscripción no incluye los datos adjuntos PDF ni las imágenes. Incluye una nota que indica que el panel ha superado el límite de tamaño y muestra el tamaño real del archivo del panel actual.
• Si el tamaño del archivo combinado es mayor que 6 MB: solo se adjunta el PDF al correo electrónico. El mensaje insertado incluye un vínculo al panel, pero no una imagen.

Descargar como PDF

Para descargar un panel como un archivo PDF, haga clic en el menú kebab situado en la parte superior derecha del panel y seleccione Descargar como PDF.

Mover un panel heredado a la papelera

Para mover un panel a la papelera, haga lo siguiente:

1. Haga clic en el menú kebab de la parte superior derecha del panel y seleccione Mover a la papelera.
2. Confirme la operación, para lo que debe hacer clic en Mover a la papelera.

Restauración de un panel heredado de la papelera

1. Haga clic en Área de trabajo en la barra lateral.
2. Haga clic en Papelera en el explorador del área de trabajo para ver los recursos incluidos.
3. Haga clic en el menú kebab situado junto al panel que desea restaurar.
4. Haga clic en Restaurar. Aparece un cuadro de diálogo Mover.
5. Use el cuadro de diálogo Mover para elegir una nueva ubicación para el panel restaurado.

Eliminación permanente de un panel heredado

1. Haga clic en Área de trabajo en la barra lateral.
2. Haga clic en Papelera en el explorador del área de trabajo para ver los recursos incluidos.
3. Haga clic en el menú kebab situado junto al panel que desea restaurar.
4. Haga clic en Eliminar de forma permanente.
5. Para confirmar, haga clic en Eliminar.

Apertura de una consulta

Para abrir la consulta que se muestra en un widget en el editor de SQL, haga clic en el menú kebab de la parte superior derecha del widget y seleccione Ver consulta.

Configuración de permisos y propiedad del panel heredado

Debe tener CAN MANAGE en un panel para configurar los permisos. Para los niveles de permisos del panel, consulte ACL del panel heredado.

1. En la barra lateral, haga clic en Paneles.
2. Haga clic en un panel.
3. Haga clic en el botón de la parte superior derecha para abrir el cuadro de diálogo Uso compartido.
4. Busque y seleccione los grupos o usuarios, y asigne el nivel de permisos.
   1. Establezca las credenciales en Ejecutar como visor para asignar los permisos CAN EDIT o CAN MANAGE.
5. Haga clic en Agregar.

Para compartir rápidamente todas las consultas asociadas al panel, haga clic en el icono de engranaje y seleccione Compartir todas las consultas. Las consultas a las que hace referencia el panel tienen permisos independientes y no se comparten de forma predeterminada al compartir el panel.

Transferencia de la propiedad de un panel heredado

Si se quita el propietario de un panel de un área de trabajo, el panel ya no tiene propietario. Un usuario administrador del área de trabajo puede transferir la propiedad de cualquier panel, incluido uno sin propietario, a otro usuario. A los grupos no se les puede asignar la propiedad de un panel. También puede transferir la propiedad mediante la API de permisos.

1. Como administrador del área de trabajo, inicie sesión en tu área de trabajo de Azure Databricks.

2. En la barra lateral, haga clic en Paneles.

3. Haga clic en un panel.

4. Haga clic en el botón Compartir de la parte superior derecha para abrir el cuadro de diálogo Uso compartido.

5. Haga clic en el icono de engranaje en la parte superior derecha y haga clic en Asignar nuevo propietario.

   

6. Seleccione el usuario al que asignar la propiedad.

7. Haga clic en Confirmar.

Acceso a la vista de administrador

Un usuario administrador del área de trabajo de Azure Databricks tiene acceso de visualización a todos los paneles del área de trabajo. En esta vista, un administrador del área de trabajo puede ver y eliminar cualquier tablero. Sin embargo, un administrador del área de trabajo no puede editar un panel al compartir las credenciales de configuración se establece en Ejecutar como propietario.

Para ver todos los paneles heredados:

1. Haga clic en Paneles en la barra lateral.
2. Haga clic en la pestaña Paneles heredados.
3. Haga clic en la pestaña Todos los paneles cerca de la parte superior de la pantalla.