Dashboards

Você pode usar painéis para criar visualizações de dados e compartilhar relatórios 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.

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.
• Tela: A guia Tela pode ser organizada em relatórios de várias páginas. Os editores de painéis podem criar e configurar seus painéis adicionando widgets como visualizações, filtros, texto e imagens.

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, consulte ACLs de 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 usando 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 páginas, visualizações, texto e filtros à tela

Use a guia Tela para montar seu painel. Uma tela pode conter até dez páginas. Você pode adicionar visualizações, texto e widgets de filtro a cada página. Use várias páginas para organizar sua apresentação de conteúdo, minimizar a rolagem e melhorar a legibilidade do painel. Use a barra de ferramentas na parte inferior de cada página para adicionar widgets, como visualizações, caixas de texto e filtros.

Criar relatórios de várias páginas

Novos painéis começam com uma única página chamada Página sem título. Para editar o nome de uma página, clique duas vezes no título e insira o novo nome no campo de texto. Os conflitos de nomenclatura são resolvidos automaticamente anexando um número ao título.

Para exibir o conteúdo de uma página, clique no título para selecioná-lo.

Adicionar e remover páginas

Para adicionar uma nova página:

• Clique à direita do título da página atual na tela. Por padrão, sua nova página é chamada de Página sem título.
• (Opcional) Clique duas vezes no título da página e insira um novo nome para renomeá-la.

Para remover uma página:

• Clique no menu kebab à direita do título da página.
• Clique em Excluir para excluir a página.

Visualizações

Crie uma visualização adicionando um widget de visualização a uma página na 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.

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.

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:

  Para imagens hospedadas publicamente, use a sintaxe markdown a seguir e insira a URL pública que aponta para a imagem.

  ![description](URL)
  

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.

Filtragem cruzada

A filtragem cruzada permite que os usuários inspecionem um subconjunto selecionado de dados e explorem interativamente relacionamentos e padrões em várias 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
• Gráfico de caixa
• Mapa de calor
• Histograma
• Pizza
• Dispersão

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

Usar 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 valores de filtro padrão

Os valores padrão são usados quando o painel é atualizado sem selecionar um novo valor de filtro. Para configurar um valor padrão, selecione um valor na lista suspensa Valor padrão nas definições de configuração 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

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

Filtros e parâmetros em URLs de painel 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.

As seleções de filtro não são armazenadas como valores nomeados. Em vez disso, eles são convertidos em identificadores exclusivos incorporados na string de URL. Esses identificadores são definidos como valores na URL, permitindo que você passe seleções de filtro específicas diretamente para a URL para carregar painéis com esses valores selecionados.

Passar valores para a URL

O exemplo a seguir mostra uma URL que aponta para um painel publicado. Para criar um painel de exemplo semelhante, consulte Criar um painel.

O painel de exemplo inclui três filtros: Intervalo de tempo, Zip de retirada e Zip de entrega. No URL de exemplo, o valor do CEP de retirada selecionado foi selecionado.

<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_01ef60cd2a3c11818750488d57e7a1bb=10013

No final da URL, observe que o identificador de filtro neste exemplo é a string f_01ef60cd2a3c11818750488d57e7a1bb, que é definida como o valor 10013.

Especificar valores de intervalo de datas relativas no URL

Quando valores de data específicos são selecionados, eles aparecem na URL. Você também pode especificar os valores de data relativos, como Últimos 5 minutos ou Últimas 12 horas, por exemplo.

O exemplo a seguir mostra uma URL com a hora relativa Últimas 12 horas selecionadas.

<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_01ef60cd29f81d1aacc19a7312fb10a4=now-12h

No final da URL, observe que o identificador de filtro neste exemplo é a string f_01ef60cd29f81d1aacc19a7312fb10a4, que é definida como o valor now-12h.

Filtros de widget estáticos

Os filtros de widget estático são configurados diretamente em um widget de visualização, permitindo que os autores filtrem individualmente os widgets de visualização que compartilham o mesmo conjunto de dados. Isso permite que o mesmo conjunto de dados apresente diferentes exibições na tela. Os visualizadores do painel publicado não podem ajustar o valor dos filtros de widget estáticos.

Para adicionar um filtro de widget estático a uma visualização:

1. Adicione um widget de visualização à tela do painel de rascunho.

2. Com o novo widget selecionado, escolha um conjunto de dados no menu suspenso Conjunto de dados no painel de configuração.

3. Clique em Mostrar filtros. Uma opção Filtrar campos é exibida sob o título do conjunto de dados. Para conjuntos de dados que incluem parâmetros, uma seção Parâmetros também é exibida.

   

Para adicionar um filtro de campo, faça o seguinte:

1. Clique no sinal de mais à direita do título Filtrar campos e escolha um campo no menu suspenso.
2. Por padrão, o valor do filtro é definido como Todos. Use o menu suspenso para escolher um novo valor. Navegue para fora do menu suspenso para mostrar a visualização com o novo filtro aplicado.
3. Revise seu dashboard.

Parâmetros do widget estático

Os parâmetros permitem substituir valores diferentes em consultas de conjunto de dados no runtime. Consulte Trabalhar com parâmetros de painel para saber como configurar parâmetros em suas consultas.

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.

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.

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.

• 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

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.

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.

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

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

Para saber como gerenciar um painel de IA/BI usando DABs (Asset Bundles) do Databricks, consulte painel.

A Databricks também oferece um provedor Terraform. Consulte a documentação do Databricks Terraform.