Dashboards

Você pode usar painéis para criar visualizações de dados e compartilhar insights de dados informativos com sua equipe. Os painéis de IA/BI apresentam criação assistida por IA, uma biblioteca de visualização aprimorada e uma experiência de configuração simplificada para que você possa transformar rapidamente dados em insights compartilháveis.

Observação

Os painéis de IA/BI (anteriormente painéis do Lakeview) agora estão disponíveis para todos.

Os painéis não estão disponíveis nas regiões do Azure Governamental. Use painéis herdados.

• Os painéis SQL originais do Databricks agora são chamados de painéis herdados. Eles continuarão a ser suportados e atualizados com correções de bugs críticos, mas as novas funcionalidades serão limitadas. Você pode continuar a usar painéis herdados para criação e consumo.
• Converta painéis herdados usando a ferramenta de migração ou API REST. Veja Clonar um painel herdado em um painel Lakeview para instruções sobre como usar a ferramenta de migração integrada. Veja Tutoriais de painéis para obter tutoriais sobre como criar e gerenciar painéis usando a API REST.

Os painéis de IA/BI têm os seguintes componentes:

• Dados: a guia Dados permite que os usuários definam os conjuntos de dados que serão usados no painel. Os conjuntos de dados são agrupados com painéis ao compartilhá-los, importá-los ou exportá-los usando a interface do usuário ou a API.
• Canvas: a guia Canvas permite que os usuários criem visualizações e construam seus painéis. A tela contém widgets que podem ser configurados para exibir visualizações, filtros, texto ou imagens.

Observação

Você pode definir até 100 conjuntos de dados por painel. A Tela pode conter até 100 widgets por painel.

Exibir e organizar dashboards

Você pode acessar painéis no navegador do workspace junto com outros objetos do Azure Databricks.

• Clique em Workspace na barra lateral para exibir os painéis no navegador do workspace. Os painéis são armazenados no diretório /Workspace/Users/<username> por padrão. Os usuários podem organizar os dashboards em pastas no navegador do espaço de trabalho, juntamente com outros objetos do Azure Databricks. Consulte Navegador do workspace.

• Para exibir a página de listagem do painel, clique em Painéis na barra lateral.

  Por padrão, a página de listagem de painéis mostra os painéis aos quais você tem acesso classificados em ordem cronológica inversa. É possível filtrar a lista inserindo um título na barra de pesquisa, por proprietário ou de acordo com a última modificação em um período de tempo.

• Clique no título de um painel para abri-lo. Se o painel já tiver sido publicado, a versão publicada será aberta. Caso contrário, o painel de rascunho será aberto.

Criar um painel

Para criar um painel na página de listagem do painel, clique em Criar próximo ao canto superior direito da página.

Definir os conjuntos de dados

Defina os conjuntos de dados subjacentes para o painel na guia Dados.

Você pode definir conjuntos de dados como um dos seguintes elementos:

• Uma nova consulta a uma ou mais tabelas ou exibições.
• Uma exibição ou tabela Catálogo do Unity existente.

Você pode definir conjuntos de dados em qualquer tipo de tabela ou exibição. Você pode definir vários conjuntos de dados escrevendo consultas adicionais ou selecionando tabelas ou exibições adicionais. Após definir um conjunto de dados, você pode usar o menu kebab à direita do nome do conjunto de dados para renomeá-lo, cloná-lo ou excluí-lo. Você também pode baixar o conjunto de dados como um arquivo CSV, TSV ou Excel.

Limitar o acesso a dados com SQL

Todos os dados em um conjunto de dados de painel podem ser acessíveis aos visualizadores do painel, mesmo que não sejam exibidos em uma visualização. Para impedir que dados confidenciais sejam enviados para o navegador, limite as colunas especificadas na consulta SQL que define o conjunto de dados. Por exemplo, em vez de selecionar todas as colunas de uma tabela, escolha apenas as colunas específicas necessárias para as visualizações na instrução SQL em vez da configuração da tabela.

Adicionar ou remover visualizações, texto e filtrar widgets na tela

Use a guia Tela para montar seu painel. Use a barra de ferramentas na parte inferior da tela para adicionar widgets, por exemplo, visualizações, caixas de texto e filtros.

Visualizações

Crie uma visualização adicionando um widget de visualização à tela. As visualizações com suporte incluem tipos de gráfico de tabela, barra, barra, combinação, contador, mapa de calor, histograma, linha, pizza, pivô, dispersão e tabela.

Observação

As consultas usadas por visualizações nem sempre correspondem precisamente ao conjunto de dados. Por exemplo, se você aplicar agregações a uma visualização, a visualização mostrará os valores agregados.

Para criar uma visualização, use um dos seguintes métodos:

• Visualizações assistidas por IA: descreva o gráfico que você deseja ver em linguagem natural e deixe o Assistente do Databricks gerar um gráfico. Depois de criado, você pode modificar o gráfico gerado usando o painel de configuração. Você não pode usar o Assistente para criar tipos de gráficos de tabela ou de tabela dinâmica.
• Use o painel de configuração: aplique agregações ou intervalos de tempo adicionais na configuração da visualização sem modificar o conjunto de dados diretamente. Você pode escolher um conjunto de dados, valores do eixo x, valores do eixo y e cores. Consulte Tipos de visualização de painel para obter detalhes de configuração e exemplos de cada tipo de visualização com suporte. Veja Opções de tabela para saber como controlar a apresentação de dados em visualizações de tabela.

Observação

Quando você aplica transformações temporais na configuração de visualização, a data mostrada na visualização representa o início desse período.

Widgets de texto

Markdown é uma linguagem de marcação para formatar texto em um editor de texto sem formatação. Você pode usar markdown em widgets de texto para formatar texto, inserir links e adicionar imagens ao painel.

• Para adicionar uma imagem estática em um widget de texto, adicione a sintaxe de imagem markdown com uma descrição e URL desejadas: ![description](URL) de uma URL disponível publicamente. Por exemplo, o seguinte markdown inserirá uma imagem do logotipo do Databricks: ![The Databricks Logo](https://upload.wikimedia.org/wikipedia/commons/6/63/Databricks_Logo.png). Para redimensionar a imagem, redimensione as dimensões do widget.
• Para adicionar uma imagem do DBFS, adicione a sintaxe de imagem markdown com uma descrição desejada e o caminho FileStore: ![description](files/path_to_dbfs_image). Para redimensionar a imagem, redimensione as dimensões do widget. Para obter mais informações sobre o DBFS, consulte O que é DBFS?.

Para obter mais informações sobre a sintaxe markdown, consulte este guia.

Filtros

Os filtros são widgets que permitem aos visualizadores do painel restringir os resultados filtrando campos específicos ou definindo parâmetros de conjunto de dados. Eles funcionam da mesma forma que as segmentações de dados em outras ferramentas de BI, permitindo que os visualizadores do painel manipulem e refinem os dados apresentados nas visualizações. Cada widget de filtro pode ser configurado para filtrar em campos de conjunto de dados ou atribuir valores a parâmetros predefinidos em uma consulta de conjunto de dados. Filtros e parâmetros de campo podem ser combinados em um único widget ao usar parâmetros baseados em consulta. Consulte Usar parâmetros baseados em consulta para saber como aplicar um parâmetro baseado em consulta.

Você pode definir um valor padrão em um widget para alguns tipos de filtro, conforme indicado nas listas de tipos de filtro a seguir. Para fazer isso, selecione um valor no menu suspenso Valor padrão nas configurações do widget de filtro. Os filtros sempre se aplicam a todo o conjunto de dados. Se o conjunto de dados for pequeno, o filtro será aplicado diretamente no navegador para melhorar o desempenho. Se o conjunto de dados for maior, o filtro será adicionado à consulta executada no SQL Warehouse. Confira Otimização e armazenamento em cache do conjunto de dados.

Filtrar em campos

Os filtros podem ser aplicados a campos de um ou mais conjuntos de dados. Para conectar um filtro a mais de um conjunto de dados, adicione vários Campos, até um por conjunto de dados. O filtro se aplica a todas as visualizações criadas nos conjuntos de dados selecionados. A seleção do filtro se reflete sequencialmente em todos os outros filtros. Os painéis dão suporte aos seguintes tipos de filtro para filtrar em um campo:

• Valor único (aceita valor padrão)
• Vários valores (aceita valor padrão)
• Seletor de data
• Seletor de intervalo de datas
• Entrada de texto
• Controle deslizante de intervalo

Filtrar em parâmetros

Um filtro pode ser aplicado a um ou mais parâmetros. Para conectar um filtro a mais de um parâmetro, adicione vários Parâmetros no painel de configuração do filtro. Para tipos de filtro que aceitam a configuração de um valor padrão no widget, o valor padrão substitui o valor padrão definido no editor de consultas na guia Dados. Se um filtro estiver conectado a um parâmetro, ele executará uma consulta no SQL Warehouse, independentemente do tamanho do conjunto de dados. Veja O que são parâmetros do painel?.

Os painéis dão suporte aos seguintes tipos de filtro para filtrar em um parâmetro:

• Valor único (aceita valor padrão)
• Seletor de data

Você pode definir valores de parâmetro para aceitar um dos seguintes tipos de dados:

• String
• Data
• Data e hora
• Decimal
• Inteiro

Observação

O uso de parâmetros para especificar intervalos de datas não é compatível. Para especificar um intervalo de datas, aplique filtros nos campos que incluem as datas de início e término do intervalo desejado.

Incluir filtros e parâmetros nas URLs dos painéis publicados

As seleções de filtros e parâmetros são armazenadas na URL. Os usuários podem marcar essas URLs como favoritas para salvar o estado do painel, incluindo todos os filtros e parâmetros. Dessa forma, as configurações do painel permanecem intactas, permitindo que outras pessoas o visualizem com as mesmas configurações quando acessarem o link.

Copiar widgets

Use atalhos de teclado para copiar um widget selecionado e colá-lo de volta na tela. Depois de criar um novo widget, você pode editá-lo como faria com qualquer outro widget.

Para clonar um widget na tela do painel de rascunho, realize as seguintes etapas:

• Clique com o botão direito do mouse em um widget.
• Clique em Clonar.

Um clone do seu widget aparece abaixo do original.

Remover widgets

Exclua widgets selecionando um widget e pressionando a tecla de exclusão no teclado. Ou clique com o botão direito do mouse no widget. Em seguida, clique em Excluir.

Baixar os resultados

Você pode baixar conjuntos de dados como arquivos CSV, TSV ou Excel. Você pode fazer download de visualizações na tela como arquivos PNG.

• Para abrir as opções de download na guia Tela, clique no menu kebab no canto superior direito do widget.
• Para abrir as opções de download de uma guia Dados, clique no menu kebab à direita do conjunto de dados.

Você pode baixar até aproximadamente 1 GB de dados de resultados nos formatos CSV e TSV e até 100.000 linhas em um arquivo do Excel. O tamanho do download do arquivo final pode ser ou pouco maior ou menor que 1 GB, pois o limite de 1 GB é aplicado a uma etapa anterior ao download do arquivo final.

Elaborar e colaborar em um painel

Os novos painéis começam como um rascunho. O rascunho pode ser colaborativo quando você o compartilha com outros usuários em seu workspace. Os painéis de rascunho não podem ser compartilhados com usuários fora do espaço de trabalho. Todos os usuários usam suas próprias credenciais para interagir com os dados e as visualizações nos rascunhos do painel.

Para obter mais informações sobre níveis de permissão, veja ACLs do painel de IA/BI.

Publicar um painel

Publique um painel para criar uma cópia limpa do rascunho atual. Você precisará ter, no mínimo, permissões PODE EDITAR para publicar um painel.

Depois de publicar um painel, a versão publicada permanecerá intacta até que você publique novamente, mesmo que você faça alterações no rascunho. É possível fazer modificações e melhorias na versão de rascunho sem afetar a cópia publicada. Qualquer usuário registrado com acesso ao painel publicado pode continuar a exibir a versão publicada. A versão publicada continua a ser enviada por email aos assinantes, caso existam. Para obter mais informações sobre como gerenciar o acesso ao painel, veja Compartilhar um painel.

Ao publicar um painel, você pode optar por inserir ou não suas credenciais.

Importante

Os painéis publicados não têm versão e não devem ser usados ​​para controle de versão. Você não pode reverter um painel de rascunho para um estado publicado anteriormente.

• Credenciais de inserção: todos os visualizadores de um painel publicado podem executar consultas usando suas credenciais para dados e computação. Isso permite que os usuários acessem o painel mesmo que não tenham acesso ao workspace de origem, aos dados subjacentes ou ao warehouse SQL. Isso pode expor dados a usuários que não receberam acesso direto a ele. Essa é a opção padrão.
• Não insira credenciais: todos os visualizadores do painel publicado executam consultas usando seus próprios dados e credenciais de computação. Para visualizar os resultados no painel, os visualizadores precisam de acesso ao espaço de trabalho, ao armazém SQL anexado e aos dados associados.

Confira Compartilhar um painel publicado para obter recomendações sobre qual configuração escolher.

Para publicar um painel, siga estas etapas:

1. Abra um dashboard. Se o painel tiver sido publicado anteriormente, a versão publicada será aberta. Se necessário, use o alternador na parte superior da página para conferir a versão atual do rascunho.
2. Clique em Publicar. A caixa de diálogo Publicar será exibida.
3. Escolha as credenciais a serem usadas no painel publicado. Você pode optar por inserir ou não suas credenciais.
4. Clique em Publicar. Se o painel estiver sendo publicado pela primeira vez, uma caixa de diálogo Compartilhamento será aberta e solicitará o compartilhamento do painel publicado. Confira Compartilhar um painel para obter detalhes e recomendações sobre compartilhamento.

Para acessar o painel publicado, clique em Publicado no menu suspenso próximo à parte superior do painel.

Agendar atualizações periódicas para os painéis

Você pode configurar atualizações agendadas para atualizar automaticamente seu painel e, opcionalmente, enviar emails com um PDF do painel mais recente para os usuários que estão inscritos no agendamento.

Os usuários com pelo menos a permissão Pode Editar podem criar uma programação para que os painéis publicados com credenciais incorporadas sejam executados periodicamente. Cada painel pode ter até dez agendamentos.

Para cada atualização de painel agendada, ocorre o seguinte:

• Toda a lógica SQL que define conjuntos de dados é executada no intervalo de tempo designado.
• Os resultados preenchem o cache de resultados da consulta e ajudam a melhorar o tempo de carga inicial do painel.

Para criar uma agenda:

1. Clique em Agendar no canto superior direito do painel. A caixa de diálogo Adicionar agendamento é exibida.

   

2. Use os seletores suspensos para especificar a frequência e o fuso horário. Opcionalmente, marque a caixa de seleção Mostrar sintaxe cron para editar o agendamento na Sintaxe Quartz Cron.

3. Clique em Criar. A caixa de diálogo Agendamentos é exibida e mostra o agendamento que você criou. Se houver outros agendamentos para este painel, a caixa de diálogo também mostrará isso.

4. Opcionalmente, clique em Assinar para se adicionar como assinante e receber um email com um instantâneo em PDF do painel após a conclusão de uma execução agendada.

Observação

Se um agendamento já tiver sido criado para este painel, o botão no canto superior direito indicará Assinar. Você pode usar o fluxo de trabalho descrito anteriormente para adicionar um agendamento.

Gerenciar Assinaturas

Os assinantes do agendamento recebem um email com um instantâneo em PDF do painel atual sempre que o agendamento é executado. Os assinantes qualificados incluem usuários do workspace e destinos de notificação por email.

Observação

Quando não é possível adicionar assinantes de email, as notificações por email do workspace podem ter sido desativadas pelo administrador. Confira Guia de administração de painéis.

Os administradores do workspace devem definir os destinos de notificação por email antes de serem selecionados como assinantes. Confira Gerenciar destinos de notificação. Usuários de conta, listas de distribuição e usuários fora da conta (como usuários em organizações de parceiros ou clientes) podem ser configurados como destinos de notificação por email e inscritos. No entanto, eles não podem ser inscritos diretamente.

Importante

As listas de assinaturas podem conter até 100 assinantes. Um destino de notificação por email conta como um assinante, independentemente do número de emails enviados por ele.

Você pode adicionar e remover outros assinantes para receber atualizações se tiver pelo menos privilégios de Pode Editar no painel. Você pode adicionar e remover a si mesmo como assinante de um agendamento existente se tiver pelo menos privilégios de Pode Exibir no painel.

• Para assinar outros usuários:

  1. Clique em Assinar no canto superior direito do painel. A caixa de diálogo Agendamentos é exibida.
  2. Identifique a agenda à qual você deseja adicionar assinantes. Clique em à direita desse agendamento. Em seguida, clique em Editar.

  Observação

  Você também pode usar esse menu de contexto para pausar ou excluir uma agenda.

  Se você tiver acesso Pode Exibir a um painel que tenha um agendamento atribuído, poderá se inscrever para receber atualizações sempre que ocorrer uma execução agendada.

• Para se inscrever em uma agenda existente:

  1. Clique no botão Assinar próximo ao canto superior direito do painel. A caixa de diálogo Agendamentos mostra todos os agendamentos para o painel.
  2. Clique em Assinar à direita do agendamento escolhido.

  Se você não puder adicionar a si mesmo como assinante, verifique os seguintes motivos:

  • Um administrador do workspace desativou a opção Habilitar assinaturas do painel para o workspace.

    Esta configuração substitui todas as outras. Se o administrador do workspace tiver desativado esta configuração, os editores de painel ainda poderão atribuir um agendamento, mas nenhum assinante poderá ser atribuído.

  • O painel não é compartilhado com credenciais inseridas.

    Painéis compartilhados sem credenciais inseridas não podem ser atribuídos a um agendamento, portanto, eles não podem ser atribuídos aos assinantes.

  • Você não tem permissão para acessar o workspace.

    Os usuários da conta só podem ser adicionados como assinantes como um destino de notificação por email. Não há nenhum botão Assinar no painel para usuários da conta.

  • Nenhum agendamento foi definido.

    Para painéis sem um agendamento definido, os usuários do workspace com acesso Pode Exibir ou Pode Executar a um painel não podem interagir com o botão Assinar.

Cancelar assinatura de atualizações de email

Os assinantes podem optar por parar de receber emails ao cancelar a assinatura do agendamento.

• Para cancelar a assinatura usando a interface do usuário do painel:

  1. Clique no botão Assinar próximo ao canto superior direito do painel. A caixa de diálogo Agendamentos mostra todos os agendamentos para o painel.
  2. Clique em Inscrito para cancelar a assinatura. O texto do botão é alterado para Assinar.

  

• Use o link Cancelar assinatura no rodapé de email para cancelar a assinatura de atualizações agendadas.

Observação

Quando um usuário incluído em uma lista de distribuição maior configurada para notificações por email opta por cancelar a assinatura usando o link no rodapé do email, a ação cancela a assinatura de toda a lista de distribuição. O grupo como um todo é removido da assinatura e não receberá atualizações futuras de instantâneo em PDF.

Limites de tamanho do painel para assinaturas

Os emails de assinatura do painel incluem os seguintes arquivos codificados em base64:

• PDF: um arquivo PDF que inclui o painel completo.
• DesktopImage: um arquivo de imagem otimizado para visualização em computadores desktop.

É imposto um limite máximo de 9 MB ao tamanho combinado dos dois arquivos. As descrições a seguir descrevem o comportamento esperado quando o tamanho do arquivo combinado excede o limite:

• Se o arquivo PDF tiver mais de 9 MB: o email de assinatura não inclui o anexo em PDF ou quaisquer imagens. Inclui uma nota informando que o painel excedeu o limite de tamanho e mostra o tamanho real do arquivo do painel atual.
• Se o tamanho do arquivo combinado for superior a 9 MB: somente o PDF será anexado ao email. A mensagem embutida inclui um link para o painel, mas nenhuma imagem.

Exportar, importar ou substituir um painel

Você pode exportar e importar painéis como arquivos para facilitar o compartilhamento de painéis editáveis em diferentes workspaces. Para transferir um painel para um espaço de trabalho diferente, exporte-o como um arquivo e, em seguida, importe-o para o novo espaço de trabalho. Você também pode substituir os arquivos do painel no local. Isso significa que, ao fazer edições diretamente em um arquivo do painel, você pode carregar esse arquivo no workspace original e substituir o arquivo existente, mantendo as configurações de compartilhamento existentes.

As etapas a seguir explicam como exportar e importar os painéis na interface do usuário. Você também pode usar a API do Databricks para importar e exportar painéis programaticamente. Confira POST /api/2.0/workspace/import.

Exportar um arquivo de painel

• Em um painel de rascunho, clique no menu kebab no canto superior direito da tela e, em seguida, clique em Exportar painel.
• Confirme ou cancele a ação usando a caixa de diálogo Exportar dashboard. Quando a exportação for bem-sucedida, um arquivo .lvdash.json será salvo no diretório de download padrão do seu navegador da web.

Importar um arquivo de painel

• Na página de listagem de Painéis, clique em > Importar painel a partir do arquivo.
• Clique em Escolher arquivo para abrir a caixa de diálogo do arquivo local e selecione o arquivo .lvdash.json que deseja importar.
• Clique em Importar painel para confirmar e criar o painel.

O dashboard importado é salvo na sua pasta de usuário. Se já existir um painel importado com o mesmo nome nesse local, o conflito será resolvido automaticamente com a inclusão de um número entre parênteses para criar um nome exclusivo.

Substituir um painel a partir de um arquivo

• Em um painel de rascunho, clique no menu kebab no canto superior direito da tela e, em seguida, clique em Substituir painel.
• Clique em Escolher arquivo para abrir a caixa de diálogo de arquivo e selecionar o arquivo .lvdash.json que será importado.
• Clique em Substituir para substituir o painel existente.

Gerenciar painéis com a API REST

Consulte Usar APIs do Azure Databricks para gerenciar painéis para tutoriais que demonstram como usar AS APIs REST do Azure Databricks para gerenciar painéis. Os tutoriais incluídos explicam como converter painéis herdados em painéis do Lakeview, além de como criá-los, gerenciá-los e compartilhá-los.