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. Quando publicados, seus painéis podem ser compartilhados com qualquer pessoa registrada em sua conta do Azure Databricks, mesmo que ela não tenha acesso ao workspace. Confira Compartilhar um painel.

Observação

Painéis de IA/BI (anteriormente painéis Lakeview) agora estão disponíveis para o público geral.

• Os painéis SQL originais do Databricks já 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. Confira Clonar um painel herdado para um painel de IA/BI para obter instruções sobre como usar a ferramenta de migração interna. 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.

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. Não é possível compartilhar painéis de rascunho 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.

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 área, barra, caixa, 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.

Parâmetros do widget estático

Os parâmetros permitem substituir valores diferentes em consultas de conjunto de dados no runtime. Para saber como configurar parâmetros nas consultas, confira Trabalhar com parâmetros de painel.

Os parâmetros de widget estáticos são configurados diretamente em um widget de visualização, permitindo que os autores reutilizem conjuntos de dados enquanto apresentam exibições diferentes do mesmo conjunto de resultados em widgets de visualização diferentes. Por exemplo, considere um conjunto de dados mostrando tendências de vendas ao longo do tempo em todas as regiões de negócios. Para comparar tendências entre a Região A e a Região B, é possível criar duas visualizações com o mesmo tipo de gráfico que fazem referência ao mesmo conjunto de dados. Ao adicionar um parâmetro a cada visualização e selecionar o valor específico a ser exibido, é possível mostrar a comparação no painel. Os parâmetros de widget estáticos não são interativos, portanto, as exibições do painel não podem ajustar seus valores.

Consulte os Parâmetros de widget estáticos para obter um exemplo.

Para saber mais sobre como definir parâmetros em widgets de filtro, consulte os Filtrar em parâmetros.

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.

Adicionar imagens a widgets de texto

Use um dos métodos a seguir para adicionar imagens ao seu dashboard. Cada método inclui amostra de sintaxe de markdown que edita para exibir sua imagem. Para redimensionar a imagem, ajuste as dimensões do widget.

• De um volume:

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

  Substitua o texto de exemplo neste exemplo pela URL do workspace e pelo caminho para a imagem armazenada em um volume.

  Use as etapas a seguir para obter o caminho para sua imagem:

  1. Clique em Catálogo na barra lateral para abrir a interface do usuário do Explorador de Catálogo.
  2. Clique no arquivo de imagem no navegador de esquema.
  3. Clique no menu kebab à direita do nome do arquivo. Em seguida, clique em Copiar Caminho.

  Consulte O que são volumes do Catálogo do Unity? para saber mais sobre como armazenar dados em volumes.

• Imagens hospedadas publicamente:

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

Substitua o texto de exemplo pela descrição e URL da imagem que você deseja mostrar. 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 obter mais informações sobre a sintaxe markdown, consulte este guia.

Observação

Quando você publica seu painel com credenciais incorporadas, os visualizadores usam suas credenciais para acessar as imagens incluídas. Se seus dashboards não forem publicados com credenciais inseridas, você deverá conceder acesso explicitamente aos usuários para arquivos de imagem armazenados no Azure Databricks. Use o Explorador de Catálogos para verificar, conceder e revogar permissões nos arquivos de imagem que você deseja incluir. Clique em Catálogo na barra lateral para abrir a interface do usuário do Explorador de Catálogo.

Filtros

Os filtros são widgets de painel que ajudam os visualizadores a restringir os resultados e refinar os dados em visualizações, semelhantes às segmentações em outras ferramentas de BI. Você pode configurá-los para filtrar valores com base em uma ou mais colunas de conjunto de dados (também chamadas de campos) ou parâmetros definidos nas consultas SQL que criam conjuntos 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.

Definir os valores padrão

Defina um valor padrão em um widget para a maioria dos 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 de campo refinam os dados apresentados nas visualizações filtrando campos específicos do conjunto de dados. Por exemplo, um filtro de campo pode limitar os dados a um intervalo de datas específico com base em um campo de data em um conjunto de dados. 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. Quando você seleciona um valor para um filtro, ele pode alterar dinamicamente os valores disponíveis mostrados nos menus suspensos para outros filtros. A imagem a seguir mostra um painel de configuração de filtro definido para filtrar em dois campos.

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

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

Filtrar em parâmetros

Ao contrário dos filtros de campo, que filtram diretamente os campos de dados, os filtros de parâmetro alteram a própria consulta SQL, permitindo ajustes dinâmicos na consulta com base na entrada do usuário. 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. Confira Trabalhar com parâmetros de painel.

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

• Um único valor
• 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.

Filtros e parâmetros nos 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.

Filtragem cruzada

A filtragem cruzada permite que os usuários façam uma busca detalhada em um subconjunto selecionado de dados e explorem relacionamentos e padrões de forma interativa em diferentes visualizações. Quando um visualizador de painel clica em um elemento em um gráfico, todos os outros gráficos com base no mesmo conjunto de dados são filtrados automaticamente nesse valor.

Como um editor de painel, configure a filtragem cruzada criando dois ou mais gráficos com base no mesmo conjunto de dados. Os seguintes tipos de gráfico permitem que os visualizadores filtrem o conjunto de dados clicando em um elemento de gráfico:

• Barras
• Mapa de calor
• Pizza
• Dispersão

Após a seleção, todas as outras visualizações com base no mesmo conjunto de dados serão atualizadas automaticamente com valores filtrados.

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.

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.

Habilitar um espaço Genie em seu painel

Importante

Esse recurso está em uma versão prévia.

Quando você cria um painel, um rascunho do espaço Genie é criado automaticamente para você. Um espaço do Genie é uma interface sem código que permite que os usuários empresariais realizem análise de dados de autoatendimento usando linguagem natural. A publicação de um espaço Genie associado permite que os espectadores explorem os dados do painel de uma maneira diferente. Em vez de obter insights com base apenas no que está disponível em um painel, eles se envolvem com os dados fazendo suas próprias perguntas para uma análise mais profunda. Confira Trabalhar com um espaço de IA/BI do Genie.

O rascunho do espaço Genie permanece sincronizado com o painel de rascunho à medida que você adiciona e remove conjuntos de dados e visualizações. Você pode usar o rascunho do espaço Genie para visualizar e interagir com seu espaço Genie antes de publicá-lo.

Para visualizar seu rascunho do espaço Genie:

1. Clique no menu de kebab no canto superior direito do painel.
2. Clique em Abrir o rascunho do espaço Genie.

Observação

Você não pode editar as instruções para este espaço Genie na interface do usuário do espaço Genie. Seu rascunho do espaço Genie só muda quando você faz alterações no painel de rascunho.

Ao publicar seu painel, você pode disponibilizar esse espaço complementar do Genie para os visualizadores. Isso adiciona um botão Pergunte ao Genie com link para uma cópia publicada do espaço Genie, onde os usuários podem fazer perguntas de acompanhamento.

Para controlar se o espaço Genie está disponível no painel publicado:

1. Clique em Publicar.
2. O botão de alternância Habilitar Genie está ativado por padrão. Clique no botão de alternância para ativar ou desativar.
3. Clique em Publicar.

Observação

Os espaços Genie de rascunho e publicados são independentes, assim como as versões de rascunho e publicadas do seu painel. Quaisquer alterações feitas no painel de rascunho são refletidas no espaço publicado do Genie somente quando o painel é republicado. Os espaços Genie de rascunho e publicados são complementos do seu painel. Eles não aparecem no navegador de arquivos ou na página de listagem do Genie.

Compartilhar um painel

Você pode compartilhar painéis com segurança com qualquer pessoa em sua conta. Para usuários atribuídos ao seu espaço de trabalho, você pode conceder acesso e definir níveis de permissão variados, como faria com outros objetos do espaço de trabalho. Para usuários que não estão atribuídos ao seu espaço de trabalho, você pode compartilhar painéis no nível da conta, permitindo que usuários registrados visualizem e executem seu painel.

Para obter detalhes sobre como os administradores podem configurar sua conta para compartilhamento no nível de conta, consulte o Guia de administração do painel. Para obter detalhes sobre como compartilhar seu painel nos níveis de conta e espaço de trabalho, consulte Compartilhar um painel.

Inserir dashboards em sites e aplicativos

Importante

Esse recurso está em uma versão prévia.

É possível inserir o painel publicado em sites e aplicativos externos usando um iframe. Confira Inserir um painel.

Se você for um administrador de workspace que quer gerenciar os sites externos em que os painéis podem ser inseridos, confira Gerenciar incorporação de painel.

Agendamentos e assinaturas

Você pode configurar atualizações agendadas para atualizar automaticamente o cache do 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.

Consulte Gerenciar atualizações e assinaturas agendadas do painel.

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 seções 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.

Você também pode gerenciar painéis usando o Terraform. Para obter detalhes, consulte a documentação do Databricks Terraform.