Paneles

Puede usar paneles para compilar visualizaciones de datos y compartir información informativa de datos con su equipo. Los paneles de IA/BI cuentan con creación asistida por IA, una biblioteca de visualización mejorada y una experiencia de configuración optimizada para que pueda transformar rápidamente los datos en conclusiones compartibles. Cuando se publica, los paneles se pueden compartir con cualquier persona registrada en la cuenta de Azure Databricks, incluso si no tienen acceso al área de trabajo. Consulte Uso compartido de un panel.

Nota:

Los paneles de IA/BI (anteriormente paneles de Lakeview) ahora están disponibles con carácter general.

• Los paneles originales de Databricks SQL ahora se denominan paneles heredados. Seguirán siendo admitidos y actualizados con correcciones de errores críticas, pero la nueva funcionalidad será limitada. Puede seguir usando paneles heredados para la creación y el consumo.
• Convierta paneles heredados mediante la herramienta de migración o la API de REST. Consulte Clonar un panel heredado en un panel de IA/BI para obtener instrucciones sobre cómo usar la herramienta de migración integrada. Consulte Tutoriales del panel para ver tutoriales sobre la creación y la administración de paneles mediante la API de REST.

Los paneles de IA/BI tienen los siguientes componentes:

• Datos: la pestaña Datos permite a los usuarios definir conjuntos de datos para usar en el panel. Los conjuntos de datos se agrupan con paneles al compartir, importar o exportarlos mediante la interfaz de usuario o la API.
• Lienzo: la pestaña Lienzo permite a los usuarios crear visualizaciones y construir sus paneles. El lienzo contiene widgets que se pueden configurar para mostrar visualizaciones, filtros, texto o imágenes.

Nota:

Puede definir hasta 100 conjuntos de datos por panel. El Canvas puede contener hasta 100 widgets por panel.

Visualización y organización de paneles

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. Consulte Explorador del área de trabajo.

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

  De forma predeterminada, la página de descripción de paneles muestra los paneles a los que tiene acceso ordenados en orden cronológico inverso. Para filtrar la lista, escriba un título en la barra de búsqueda, filtre por la fecha de la última modificación en un período de tiempo, o filtre por propietario.

• Haga clic en un título del panel para abrirlo. Si el panel se ha publicado antes, se abre la versión publicada. De lo contrario, se abre el panel borrador.

Creación de un panel

Para crear un nuevo panel en la página de descripción del panel, haga clic en Crear cerca de la esquina superior derecha de la página.

Redactar y colaborar en un panel

Los nuevos paneles comienzan como un borrador. Puede compartir el borrador con otros usuarios del área de trabajo para colaborar. No puede compartir paneles de borrador con usuarios fuera del área de trabajo. Todos los usuarios usan sus credenciales para interactuar con los datos y las visualizaciones en borradores de panel.

Para más información sobre los niveles de permiso consulte ACL del panel de IA/BI.

Defina los conjuntos de datos

Use la pestaña Datos para definir los conjuntos de datos subyacentes del panel.

Puede definir conjuntos de datos como cualquiera de los siguientes:

• Una nueva consulta en una o varias tablas o vistas.
• Una tabla o una vista de Unity Catalog existente.

Puede definir conjuntos de datos en cualquier tipo de tabla o vista. Puede definir varios conjuntos de datos escribiendo consultas adicionales o seleccionando tablas o vistas adicionales. Después de definir un conjunto de datos, puede usar el menú de kebab a la derecha del nombre del conjunto de datos para cambiar el nombre, clonar o eliminarlo. También puede descargar el conjunto de datos como un archivo CSV, TSV o Excel.

Limitar el acceso a datos con SQL

Todos los datos de un conjunto de datos de panel pueden ser accesibles para los visores de paneles, incluso si no se muestran en una visualización. Para evitar que se envíen datos confidenciales al explorador, limite las columnas especificadas en la consulta SQL que define el conjunto de datos. Por ejemplo, en lugar de seleccionar todas las columnas de una tabla, elija solo las columnas específicas necesarias para las visualizaciones de la instrucción SQL en lugar de la configuración de tabla.

Adición o eliminación de visualizaciones, texto y widgets de filtro en el lienzo

Use la pestaña Lienzo para crear el panel. Use la barra de herramientas de la parte inferior del lienzo para agregar widgets como visualizaciones, cuadros de texto y filtros.

Visualizaciones

Cree una visualización agregando un widget de visualización al lienzo. Las visualizaciones admitidas incluyen los tipos de gráfico de área, de barras, de cuadros, combinado, de contador, de mapa térmico, histograma, de línea, circular, dinámico, de dispersión y de tabla.

Nota:

Las consultas que usan las visualizaciones no siempre se corresponden exactamente con el conjunto de datos. Por ejemplo, si aplica agregaciones a una visualización, la visualización muestra los valores agregados.

Para crear una visualización, use uno de los métodos siguientes:

• Visualizaciones asistidas por IA: describa el gráfico que quiere ver en lenguaje natural y deje que Databricks Assistant genere un gráfico. Una vez creado, puede modificar el gráfico generado mediante el panel de configuración. No se puede usar Assistant para crear tipos de gráficos de tabla o tabla dinámica.
• Use el panel de configuración: aplique agregaciones adicionales o enlaces de tiempo en la configuración de visualización, sin modificar el conjunto de datos directamente. Puede elegir un conjunto de datos, valores de eje X, valores del eje Y y colores. Consulte Tipos de visualización del panel para obtener detalles de configuración y ejemplos de cada tipo de visualización admitido. Consulte Opciones de tabla para obtener información sobre cómo puede controlar la presentación de datos en visualizaciones de tablas.

Nota:

Al aplicar transformaciones temporales en la configuración de la visualización, la fecha que se muestra en la visualización representa el inicio de ese período.

Parámetros de widget estáticos

Los parámetros le permiten sustituir valores diferentes en consultas de conjunto de datos en tiempo de ejecución. Para obtener información sobre cómo configurar parámetros en las consultas, vea Trabajar con parámetros del panel.

Los parámetros de widget estáticos se configuran directamente en un widget de visualización, lo que permite a los autores reutilizar conjuntos de datos mientras se presentan vistas diferentes del mismo conjunto de resultados en otros widgets de visualización. Por ejemplo, considere un conjunto de datos en el que se muestran las tendencias de ventas en el tiempo de todas las regiones empresariales. Para comparar las tendencias entre la región A y la región B, puede crear dos visualizaciones con el mismo tipo de gráfico que hace referencia al mismo conjunto de datos. Al agregar un parámetro a cada visualización y seleccionar el valor específico que se va a mostrar, puede mostrar la comparación en el panel. Los parámetros de widget estáticos no son interactivos, por lo que las vistas del panel no pueden ajustar sus valores.

Vea Parámetros de widget estáticos para obtener un ejemplo.

Para obtener información sobre cómo establecer parámetros en widgets de filtro, vea Filtro en parámetros.

Widgets de texto

Markdown es un lenguaje de marcado para dar formato al texto en un editor de texto sin formato. Puede usar Markdown en widgets de texto para dar formato a texto, insertar vínculos y agregar imágenes al panel.

Agregar imágenes a widgets de texto

Use uno de los métodos siguientes para agregar imágenes al panel. Cada método incluye la sintaxis markdown de ejemplo que edita para mostrar la imagen. Para cambiar el tamaño de una imagen, cambie el tamaño de las dimensiones del widget.

• Desde un volumen:

  <WorkspaceURL>/ajax-api/2.0/fs/files/<Volumes/path/to/image>
  

  Reemplace el texto de ejemplo de este ejemplo por la dirección URL del área de trabajo y la ruta de acceso a la imagen almacenada en un volumen.

  Siga estos pasos para obtener la ruta de acceso a la imagen:

  1. Haga clic en Catálogo en la barra lateral para abrir la interfaz de usuario del Explorador de catálogos.
  2. Haga clic en el archivo de imagen en el explorador de esquemas.
  3. Haga clic en el menú kebab situado a la derecha del nombre de archivo. A continuación, haga clic en Copiar ruta de acceso.

  Consulte ¿Qué son los volúmenes de Unity Catalog? para obtener más información sobre cómo almacenar datos en volúmenes.

• Imágenes hospedadas públicamente:

  ![description](URL)` where the URL publicly hosted on the internet.
  

Reemplace el texto de ejemplo por la descripción y la dirección URL de la imagen que desea mostrar. Por ejemplo, el siguiente markdown insertará una imagen del logotipo de Databricks: ![The Databricks Logo](https://upload.wikimedia.org/wikipedia/commons/6/63/Databricks_Logo.png).

Para obtener más información sobre la sintaxis de Markdown, consulte esta guía.

Nota:

Al publicar el panel con credenciales insertadas, los espectadores usan sus credenciales para acceder a las imágenes incluidas. Si los paneles no se publican con credenciales insertadas, debe conceder explícitamente acceso a los usuarios para los archivos de imagen almacenados en Azure Databricks. Use el Explorador de catálogos para comprobar, conceder y revocar permisos en los archivos de imagen que desea incluir. Haga clic en Catálogo en la barra lateral para abrir la interfaz de usuario del Explorador de catálogos.

Filters

Los filtros son widgets de panel que ayudan a los espectadores a reducir los resultados y ajustar los datos en visualizaciones, de forma similar a las segmentaciones de otras herramientas de BI. Puedes configurarlos para filtrar valores basados en una o varias columnas de conjuntos de datos (también denominadas campos) o en parámetros definidos en las consultas SQL que crean conjuntos de datos. Los filtros de campo y los parámetros pueden combinarse en un único widget cuando se usan parámetros basados en consultas. Consulte Uso de parámetros basados en consultas para obtener información sobre cómo aplicar un parámetro basado en consultas.

Establecimiento de valores predeterminados

Puedes establecer un valor predeterminado en un widget para la mayoría de tipos de filtro, como se indica en las siguientes listas de tipos de filtro. Para ello, seleccione un valor en la lista desplegable Valor predeterminado en los valores de configuración del widget de filtro. Los filtros siempre se aplican a todo el conjunto de datos. Si el conjunto de datos es pequeño, el filtro se aplica directamente en el explorador para mejorar el rendimiento. Si el conjunto de datos es mayor, el filtro se agrega a la consulta que se ejecuta en el almacén SQL. Consulte Optimización y almacenamiento en caché del conjunto de datos.

Filtrar en campos

Los filtros de campo ajustan los datos presentados en las visualizaciones mediante el filtrado de campos de conjuntos de datos específicos. Por ejemplo, un filtro de campo podría limitar los datos a un intervalo de fechas determinado basado en un campo de fecha de un conjunto de datos. Los filtros se pueden aplicar a los campos de uno o varios conjuntos de datos. Para conectar un filtro a campos de más de un conjunto de datos, agregue varios Campos, hasta uno por conjunto de datos. El filtro se aplica a todas las visualizaciones basadas en los conjuntos de datos seleccionados. Al seleccionar un valor para un filtro, puede cambiar de manera dinámica los valores disponibles que se muestran en los menús desplegables de otros filtros. En la imagen siguiente se muestra un panel de configuración de filtro establecido para filtrar en dos campos.

Los paneles admiten los siguientes tipos de filtro para filtrar en un campo:

• Un solo valor
• Varios valores
• Selector de fecha
• Selector de intervalos de fechas
• Entrada de texto
• Control deslizante de rango (no acepta valores predeterminados)

Filtrar por parámetros

A diferencia de los filtros de campo, que filtran directamente los campos de datos, los filtros de parámetros modifican la propia consulta SQL, lo que permite realizar ajustes dinámicos a la consulta en función de la entrada del usuario. Un filtro se puede aplicar a uno o varios parámetros. Para conectar un filtro a más de un parámetro, agregue varios Parámetros en el panel de configuración del filtro.

Para los tipos de filtro que aceptan establecer un valor predeterminado en el widget, el valor predeterminado invalida el valor predeterminado establecido en el editor de consultas de la pestaña Datos. Si un filtro está conectado a un parámetro, ejecuta una consulta contra la SQL warehouse, independientemente del tamaño del conjunto de datos. Consulte Trabajar con parámetros del panel.

Los paneles admiten los siguientes tipos de filtro para filtrar en un parámetro:

• Un solo valor
• Selector de fecha

Puede establecer valores de parámetro para aceptar uno de los siguientes tipos de datos:

• Cadena
• Date
• Fecha y hora
• Decimal
• Entero

Nota:

No se admite el uso de parámetros para especificar intervalos de fechas. Para especificar un intervalo de fechas, aplique filtros en los campos que incluyen las fechas de inicio y finalización del intervalo deseado.

Filtros y parámetros en las direcciones URL del panel publicadas

Las selecciones de filtro y parámetro se almacenan en la dirección URL. Los usuarios pueden marcar estas direcciones URL para guardar el estado del panel’, incluidos todos los filtros y parámetros. De este modo, la configuración del panel permanece intacta, lo que permite a otros usuarios verlos con las mismas configuraciones cuando acceden al vínculo.

Copia de widgets

Use métodos abreviados de teclado para copiar un widget seleccionado y pegarlo de nuevo en el lienzo. Después de crear un widget, puede editarlo como lo haría con cualquier otro.

Para clonar un widget en el lienzo del panel de borrador, complete los pasos siguientes:

• Haga clic con el botón derecho en un widget.
• Haga clic en Clonar.

Un clon del widget aparece debajo del original.

Eliminación de widgets

Para eliminar widgets, seleccione uno y presione la tecla eliminar del teclado. O bien haga clic con el botón derecho en el widget. Después, haga clic en Eliminar.

Filtrado cruzado

El filtrado cruzado permite a los usuarios rastrear desagrupando datos un subconjunto seleccionado de datos y explorar interactivamente las relaciones y patrones en varias visualizaciones. Cuando un espectador del panel hace clic en un elemento de un gráfico, todos los demás gráficos basados en el mismo conjunto de datos se filtran automáticamente en función de ese valor.

Como editor de paneles, configure el filtrado cruzado mediante la creación de dos o más gráficos que compartan el mismo conjunto de datos. Los siguientes tipos de gráfico permiten filtrar el conjunto de datos haciendo clic en un elemento de gráfico:

• Barras
• Mapa térmico
• Circular
• Dispersión

Después de la selección, todas las demás visualizaciones basadas en el mismo conjunto de datos se actualizarán automáticamente con valores filtrados.

Descarga de resultados

Puede descargar conjuntos de datos como archivos CSV, TSV o Excel. Puede descargar visualizaciones en el lienzo como archivos PNG.

• Para abrir las opciones de descarga de la pestaña Lienzo, haga clic en el menú kebab en la esquina superior derecha del widget.
• Para abrir las opciones de descarga desde una pestaña Datos, haga clic en el menú kebab situado a la derecha del conjunto de datos.

Puede descargar hasta aproximadamente 1GB de datos de resultados en formato CSV y TSV y hasta 100 000 filas en un archivo de Excel. El tamaño final de descarga de archivos puede ser ligeramente mayor o menor que 1 GB, ya que el límite de 1 GB se aplica a un paso anterior que la descarga final de archivos.

Publicar un panel

Publique un panel para crear una copia limpia del borrador actual. Debe tener al menos permisos de PUEDE EDITAR para publicar un panel.

Después de publicar un panel, la versión publicada permanecerá intacta hasta que vuelva a publicar, incluso si realiza cambios en el borrador. Puede efectuar modificaciones y mejoras en una versión de borrador sin que afecte a la copia publicada. Cualquier usuario registrado con acceso al panel publicado puede seguir viendo la versión publicada. La versión publicada sigue enviándose por correo electrónico a los suscriptores, si los hay. Para obtener más información sobre cómo administrar el acceso al panel, consulte Compartir un panel.

Al publicar un panel, puede elegir insertar las credenciales o no.

Importante

Los paneles publicados no tienen versiones y no se deben usar para el control de versiones. No se puede revertir un panel de borrador a un estado publicado anteriormente.

• Insertar credenciales: todos los visores de un panel publicado pueden ejecutar consultas con sus credenciales para los datos y el proceso. Esto permite a los usuarios ver el panel incluso si no tienen acceso al área de trabajo original, a los datos subyacentes o al almacén SQL. Esto puede exponer datos a los usuarios a los que no se le ha concedido acceso directo. Ésta es la opción predeterminada.
• No insertar credenciales: todos los espectadores del panel publicado ejecutan consultas con sus propios datos y credenciales de proceso. Los espectadores necesitan acceso al área de trabajo, al almacenamiento de SQL adjunto y a los datos asociados para ver el panel.

Consulte Compartir un panel publicado para obtener recomendaciones sobre qué configuración elegir.

Complete los pasos siguientes para publicar un panel:

1. Abra un panel. Si el panel se ha publicado anteriormente, se abre la versión publicada. Si es necesario, use el modificador en la parte superior de la página para ver la versión actual del borrador.
2. Haga clic en Publicar. Aparece el cuadro de diálogo Publicar.
3. Elija las credenciales que se van a usar para el panel publicado. Puede optar por insertar sus credenciales o no.
4. Haga clic en Publicar. Si el panel se publica por primera vez, se abre un cuadro de diálogo Uso compartido y se le pide que comparta el panel publicado. Consulte Compartir un panel para obtener recomendaciones y más detalles sobre el uso compartido.

Para acceder al panel publicado, haga clic en Publicado en el menú desplegable situado cerca de la parte superior del panel.

Habilitar un espacio de Genie desde el panel

Importante

Esta característica está en versión preliminar pública.

Al crear un panel, se crea automáticamente un borrador de espacio de Genie. Un espacio de Genie es una interfaz sin código que permite a los usuarios empresariales realizar análisis de datos de autoservicio mediante lenguaje natural. La publicación de un espacio de Genie asociado permite a los visores explorar los datos del panel de una manera diferente. En lugar de obtener información basada solo en lo que está disponible en un panel, interactúan con los datos haciendo sus propias preguntas para un análisis más profundo. Consulte Trabajar con un espacio de AI/BI Genie.

El borrador del espacio de Genie permanece sincronizado con el panel de borrador al agregar y quitar conjuntos de datos y visualizaciones. Puede usar el borrador del espacio de Genie para obtener una vista previa e interactuar con el espacio de Genie antes de publicarlo.

Para obtener una vista previa del borrador del espacio de Genie:

1. Haga clic en el menú kebab de la esquina superior derecha del panel.
2. Haga clic en Abrir el borrador del espacio de Genie.

Nota:

No se pueden editar las instrucciones de este espacio de Genie desde la interfaz de usuario del espacio de Genie. El borrador de espacio de Genie solo cambia cuando realiza cambios en el panel de borrador.

Al publicar el panel, puede hacer que este espacio complementario de Genie esté disponible para los espectadores. Esto agrega un botón Preguntar a Genie que vincula a una copia publicada del espacio de Genie donde los usuarios pueden formular preguntas de seguimiento.

Para controlar si el espacio de Genie está disponible en el panel publicado:

1. Haga clic en Publicar.
2. El botón de alternancia Habilitar Genie está activado de forma predeterminada. Haga clic en el botón de alternancia para activarlo o desactivarlo.
3. Haga clic en Publicar.

Nota:

Los espacios de borrador y publicados de Genie son independientes, al igual que el borrador y las versiones publicadas del panel. Los cambios realizados en el panel de borrador se reflejan en el espacio publicado de Genie solo cuando se vuelve a publicar el panel. Los espacios de Borrador y Genie publicados son complementarios al panel. No aparecen en el explorador de archivos ni en la página de descripción de Genie.

Uso compartido de un panel

Puede compartir paneles de forma segura con cualquier persona de su cuenta. En el caso de los usuarios asignados a su área de trabajo, puede conceder acceso y configurar distintos niveles de permisos como lo haría con otros objetos del área de trabajo. Para los usuarios que no están asignados al área de trabajo, puede compartir paneles a nivel de cuenta, lo que permite a los usuarios registrados ver y ejecutar el panel.

Para obtener más información sobre cómo los administradores pueden configurar su cuenta para compartir en el nivel de cuenta, consulta Guía de administración del panel. Para más información sobre cómo compartir el panel en los niveles de cuenta y área de trabajo, consulta Uso compartido de un panel.

Insertar paneles en sitios web y aplicaciones

Importante

Esta característica está en versión preliminar pública.

Puede insertar el panel publicado en sitios web y aplicaciones externos mediante un iframe. Vea Inserción de un panel.

Si es un administrador del área de trabajo que quiere administrar los sitios externos en los que se pueden insertar paneles, vea Administración de la inserción de paneles.

Programaciones y suscripciones

Puedes configurar actualizaciones programadas para actualizar automáticamente la caché del panel y, opcionalmente, enviar correos electrónicos con un PDF del panel más reciente a los usuarios que están suscritos a la programación. Los usuarios con al menos permisos Can Edit pueden crear una programación para que los paneles publicados con credenciales insertadas se ejecuten periódicamente. Cada panel puede tener hasta diez programaciones.

Consulta Administración de actualizaciones y suscripciones del panel programados.

Exportar, importar o reemplazar un panel

Puede exportar e importar paneles como archivos para facilitar el uso compartido de paneles editables en diferentes áreas de trabajo. Para transferir un panel a otra área de trabajo, expórtelo como un archivo y, a continuación, impórtelo en la área de trabajo nueva. También puede reemplazar los archivos del panel. Esto significa que, al editar un archivo de panel directamente, puede cargar ese archivo en el área de trabajo original y sobrescribir el archivo existente al tiempo que mantiene la configuración de uso compartido existente.

En las secciones siguientes se explica cómo exportar e importar paneles en la interfaz de usuario. También puedes usar la API de Databricks para importar y exportar paneles mediante programación. Consulte POST /api/2.0/workspace/import.

Exportación de un archivo de panel

• En un panel de borrador, haz clic en el menú kebab en la esquina superior derecha de la pantalla y, después, haz clic en Exportar panel.
• Confirme o cancele la acción mediante el cuadro de diálogo Exportar panel. Cuando la exportación se realiza correctamente, se guarda un archivo .lvdash.json en el directorio de descarga predeterminado del explorador web.

Importar un archivo de panel

• En la página del listado de paneles, haz clic en > Importar el panel desde un archivo.
• Haga clic en Elegir archivo para abrir el cuadro de diálogo de archivo local y, a continuación, seleccione el archivo .lvdash.json que desea importar.
• Haga clic en Importar panel para confirmar y crear el panel.

El panel importado se guarda en la carpeta de usuario. Si ya existe un panel importado con el mismo nombre en esa ubicación, el conflicto se resuelve automáticamente anexando un número entre paréntesis para crear un nombre único.

Reemplazar un panel de un archivo

• En un panel de borrador, haga clic en el menú kebab de la esquina superior derecha de la pantalla y, a continuación, haga clic en Reemplazar panel.
• Haga clic en Eligir archivo para abrir el cuadro de diálogo de archivo y seleccione el archivo .lvdash.json que desea importar.
• Haga clic en Sobrescribir para sobrescribir el panel existente.

Administración de paneles con la API REST

Consulte Uso de las API de Azure Databricks para administrar paneles para ver tutoriales que muestran cómo usar las API REST de Azure Databricks para administrar paneles. Los tutoriales incluidos explican cómo convertir paneles heredados en paneles de Lakeview, así como cómo crear, administrar y compartirlos.

También puede administrar los paneles mediante Terraform. Para más información, vea la documentación de Databricks Terraform.