Dashboards

Você pode usar painéis para criar visualizações de dados e compartilhar insights de dados informativos com sua equipe. A última versão de painéis apresentam uma biblioteca de visualização aprimorada e uma experiência de configuração simplificada para que você possa transformar rapidamente dados em insights que podem ser compartilhados.

Observação

Os painéis (anteriormente painéis Lakeview) agora estão disponíveis para o público geral.

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 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.

Observação

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

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.

• Use o Assistente do Databricks: crie visualizações descrevendo o gráfico que você deseja ver em linguagem natural e permita que o assistente gere 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 adicionais ou timebins na configuração de visualização sem modificar o conjunto de dados diretamente. Você pode escolher um conjunto de dados, valores de eixo x, valores de eixo y e cores no painel de configuração. Consulte Tipos de visualização de painel para obter detalhes de configuração e exemplos de cada tipo de visualização com suporte. Consulte Opções de tabela para saber como controlar a apresentação de dados em visualizações de tabela.

Observação

Os widgets de visualização permanecem em branco até que você descreva o gráfico desejado ou escolha as configurações para definir o conjunto de dados, o tipo de gráfico e os valores que você deseja representar.

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 é o DBFS (Sistema de Arquivos do Databricks)?.

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

Filtros

Os filtros são widgets que permitem que os visualizadores do painel filtrem em um campo ou definam parâmetros de conjunto de dados. 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. Um widget de filtro único não pode usar campos e parâmetros simultaneamente.

Filtrar em campos

Os painéis dão suporte aos seguintes tipos de filtro para filtrar campos:

• Lista suspensa de opção única
• Lista suspensa com várias opções
• Texto
• Data
• Intervalo de datas

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 filtros do painel sempre se aplicam a todo o conjunto de dados. Se o conjunto de dados for pequeno, o filtro do painel 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.

Filtrar em parâmetros

Se um filtro estiver conectado a um parâmetro, ele executará uma consulta no SQL Warehouse, independentemente do tamanho do conjunto de dados.

Os painéis dão suporte aos seguintes tipos de filtro para definir parâmetros:

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

Veja O que são parâmetros do painel?.

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.

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. Em um painel de rascunho, acesse as opções de download na guia Dados ou clique com o botão direito do mouse em uma visualização na tela.

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.

Para painéis publicados, os visualizadores podem baixar os resultados clicando com o botão direito do mouse em uma visualização.

Os administradores do workspace podem ajustar suas configurações de segurança para impedir que os usuários baixem resultados com as seguintes etapas:

1. Clique no nome de usuário na barra superior do workspace do Azure Databricks e selecione Configurações.
2. Clique em Segurança.
3. Desative a opção Download de resultados do SQL.

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. 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 os níveis de permissão, consulte ACLs do painel.

Publicar um painel

Publique o painel para criar uma cópia limpa do painel atual e poder compartilhá-lo com todos os usuários em seu workspace do Azure Databricks. Depois de publicar seu painel, a versão publicada permanece inalterada e acessível para compartilhamento até que você publique novamente. Você pode continuar fazendo modificações e melhorias em uma versão de rascunho sem afetar a cópia compartilhada publicamente.

A publicação não compartilha painéis automaticamente com os usuários. Você pode compartilhar explicitamente painéis com permissões de exibição para usuários ou grupos.

Você precisará ter, no mínimo, permissões Pode editar para publicar um painel.

1. Abra um dashboard.
2. No menu suspenso Compartilhar no canto superior direito, clique em Publicar. A caixa de diálogo Publicar será exibida.
3. Escolha as credenciais a serem usadas no painel publicado. Opcionalmente, você pode optar por inserir suas credenciais.

• 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 vejam o painel mesmo que não tenham acesso aos dados subjacentes ou ao SQL Warehouse. 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. Os visualizadores precisam de acesso ao workspace, ao SQL Warehouse anexado e aos dados associados para exibir os resultados no painel.

1. Clique em Publicar.

Você pode compartilhar o painel publicado com todos os usuários em seu workspace do Azure Databricks. Para saber mais sobre como controlar o acesso ao seu painel, consulte ACLs de painel.

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 enviar emails periodicamente com os dados mais recentes para seus assinantes.

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.

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.

Controles de assinatura do administrador do workspace

Os administradores do workspace podem impedir que os usuários distribuam painéis usando assinaturas.

Para impedir o compartilhamento de atualizações de email:

1. Clique no nome de usuário na barra superior do workspace do Azure Databricks e selecione Configurações.
2. Clique em Notificações.
3. Desative a opção Habilitar assinaturas de email do painel.

Alterar esta configuração impede que todos os usuários adicionem assinantes de email. Os editores de painel não podem adicionar assinantes, e os visualizadores de painel não têm a opção de assinar um painel.

Se esta configuração estiver desativada, as assinaturas existentes serão pausadas e ninguém poderá modificar as listas de assinaturas existentes. Se esta configuração estiver ativada novamente, as assinaturas serão retomadas usando a lista existente.

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.

Transferir a propriedade de um painel

Se você for um administrador de workspace, poderá transferir a propriedade de um painel para um usuário diferente.

1. Navegue até a lista de painéis. Clique em um nome de dashboard para editar.
2. Clique em Compartilhar.
3. Clique no ícone na parte superior direita da caixa de diálogo Compartilhamento.
4. Comece a digitar um nome de usuário para pesquisar e selecione o novo proprietário.
5. Clique em Confirmar.

O novo proprietário aparece na caixa de diálogo Compartilhamento com permissões PODE GERENCIAR. Para exibir painéis listados pelo proprietário, vá para a lista de painéis disponíveis escolhendo o .

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.

O que é compartilhar para a conta?

O compartilhamento do painel para a conta permite que os usuários compartilhem painéis publicados com usuários e grupos fora do workspace em que o painel foi criado.

Adicionar usuários à conta do Databricks não é o mesmo que adicioná-los a um workspace. Quando os usuários são adicionados a uma conta, suas credenciais não lhes concedem acesso automático a um workspace, dados ou recursos de computação. Em vez disso, o registro estabelece sua identidade dentro do sistema, que o Azure Databricks usará posteriormente para verificar se os painéis compartilhados estão disponíveis apenas para seus destinatários pretendidos.

A imagem a seguir mostra um exemplo de como os painéis publicados podem ser compartilhados em vários workspaces e no nível da conta.

Os dashboards publicados podem ser compartilhados com o seguinte:

• Um ou mais usuários específicos atribuídos ao espaço de trabalho de origem.
• Grupos de espaços de trabalho (incluindo todos os usuários do espaço de trabalho).
• Um ou mais usuários específicos na conta do Azure Databricks.
• Grupos de contas do Azure Databricks (incluindo todos os usuários da conta).

Para obter mais informações sobre usuários e relações de grupo em sua conta do Azure Databricks, consulte Como os administradores atribuem usuários a espaços de trabalho?

Como compartilhar um painel com outros usuários da conta do Azure Databricks

Os painéis de rascunho não podem ser compartilhados com usuários fora do espaço de trabalho. Os painéis publicados podem ser compartilhados com usuários e grupos da conta do Azure Databricks. Adicionar usuários e grupos a uma conta do Databricks não atribui automaticamente permissões de workspace, dados ou computação. Consulte Gerenciar usuários, entidades de serviço e grupos para obter detalhes sobre o gerenciamento de identidade com o Azure Databricks.

Use as etapas a seguir para publicar e compartilhar seu painel com usuários da conta.

• Navegue até o painel de rascunho.

• Publique o dashboard com a configuração Incorporar credenciais (padrão).

  Incorporar suas credenciais significa que o SQL Warehouse e as consultas SQL usam os dados do fornecedor e as permissões do warehouse para atualizar o dashboard publicado. Isso é necessário se você quiser compartilhar com usuários fora do workspace de origem, pois eles não têm suas próprias credenciais.

• Clique no botão Compartilhar e use a caixa de diálogo Compartilhamento para definir permissões para usuários e grupos em sua conta do Databricks.

  • Na parte superior da Caixa de diálogo de compartilhamento, insira usuários do workspace, grupos do workspace, usuários de conta específicos ou grupos de contas.

  Para usuários em seu workspace, você pode atribuir permissões Pode Gerenciar, Pode Editar, Pode Executarou Pode Exibir. Os usuários da conta são limitados ao acesso Pode Exibir, mesmo se uma permissão mais alta for atribuída no modal de Compartilhamento.

  Para atribuir rapidamente o acesso de exibição a todos os usuários da conta, use a opção Configurações de compartilhamento na parte inferior da caixa de diálogo de Compartilhamento.

  

• Compartilhe o link com os usuários.

  Clique Copiar link próximo à parte inferior da caixa de diálogo de Compartilhamento para copiar uma URL compartilhável para o painel publicado.

Observação

Os usuários que não têm acesso ao workspace são limitados a permissões Pode Exibir. Se você conceder permissões elevadas, como Pode Editar a um usuário que não tem acesso ao workspace, as permissões aparecerão na interface do usuário, mas não serão aplicadas até que o usuário seja adicionado ao workspace.

Para obter mais informações sobre os níveis de permissão do painel, consulte ACLs do painel.

Considerações de rede

Se as listas de acesso ao IP estiverem configuradas, um dashboard publicado na conta só ficará acessível aos usuários da conta se for acessado de dentro do intervalo de IP aprovado, como, por exemplo, ao usar uma VPN. Para obter mais informações sobre como configurar o acesso, confira Gerenciar listas de acesso de IP.

Monitorar a atividade do Lakeview

Os administradores podem monitorar a atividade nos painéis usando logs de auditoria. Confira os Eventos de painéis.

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.