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.
Importante
- O Databricks recomenda o uso de painéis de IA/BI (anteriormente painéis do Lakeview). As versões anteriores dos painéis, anteriormente conhecidas como painéis SQL do Databricks, agora são chamadas de painéis herdados. O Databricks não recomenda a criação de novos dashboards herdados.
- Converta painéis herdados usando a ferramenta de migração ou a 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.
- Consulte Migrar um dashboard para obter instruções sobre como migrar painéis herdados usando a API.
- Confira ponto de extremidade POST /api/2.0/lakeview/dashboards/migrate do painel Migrar na referência da 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.
- 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.
Observação
Você pode definir até 100 conjuntos de dados por painel. O Canvas pode conter até 10 páginas. Os painéis podem conter até 100 widgets em todas as páginas.
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.
Observação
Cada conjunto de dados é definido por uma consulta. Ao selecionar uma tabela ou exibição existente do Catálogo do Unity, a consulta usa SELECT *
como padrão nesse objeto, o que você pode modificar para refinar o conjunto de dados.
Você pode criar vários conjuntos de dados por meio da adição de consultas ou da seleção de tabelas ou exibições adicionais. Para ajustar a ordem de exibição dos conjuntos de dados, arraste e solte os nomes na posição desejada.
Para formatar uma consulta no editor do conjunto de dados, clique com o botão direito do mouse no editor e selecione Formatar documento.
Para obter mais detalhes sobre como criar e gerenciar conjuntos de dados do painel, consulte Criar e gerenciar conjuntos de dados do painel.
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.
Observação
A exclusão de uma página também exclui todos os widgets dessa página. Se você excluir todas as páginas, clique em Criar uma página para começar a criar seu painel novamente.
Clonar uma página
Para clonar uma página:
- Clique no título da página para selecioná-lo.
- Clique em
bloco do título e depois em Clonar.
A nova página é uma cópia exata do original, incluindo todos os widgets. Os conjuntos de dados subjacentes permanecem inalterados.
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 obter uma lista completa de tipos de visualização disponíveis e valores de configuração de exemplo, consulte Tipos de Visualizações de Dashboard.
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.
Para obter detalhes sobre como aplicar a formatação personalizada aos seus gráficos, confira Visualizações de painel. 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.
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.
Usar um arquivo local:
Para exibir um arquivo local, primeiro codifique-o como uma cadeia de caracteres base64. Em seguida, use a sintaxe markdown a seguir, substituindo
<base64-encoded-string>
por sua cadeia de caracteres codificada.![description](data:image/webp;base64,<base64-encoded-string>)
Observação
Se você estiver familiarizado com utilitários de linha de comando, use a ferramenta
base64
para converter seu arquivo. Como alternativa, há muitos recursos online gratuitos que você pode usar para codificar arquivos base64.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:
- Clique em
Catálogo na barra lateral para abrir a interface do usuário do Explorador de Catálogo.
- Clique no arquivo de imagem no navegador de esquema.
- 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.
- Clique em
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.
Observação
Quando você publica seu painel com credenciais incorporadas, os visualizadores usam suas credenciais para acessar as imagens incluídas. Se o painel não for publicado com credenciais inseridas, você deverá conceder explicitamente acesso 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.
Filtragem cruzada
A filtragem cruzada permite analisar um subconjunto de dados selecionado e explorar relações entre várias visualizações. Quando você clica em um elemento em um gráfico, todos os gráficos na mesma página que usam o mesmo conjunto de dados filtram automaticamente com base no valor selecionado.
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
- Mapa de pontos
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. Para saber como configurar filtros para visualizações em um painel, consulte Usar filtros de painel.
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.
Para saber como baixar um painel publicado como PDF, consulte Baixar um painel publicado.
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.
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.
Ao publicar, escolha uma das seguintes opções:
- 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 registrados com acesso ao painel o exibam, mesmo que não tenham acesso ao workspace de origem, 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. 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.
Observação
Todos os visualizadores de dashboard devem se autenticar para acessar o painel, independentemente da configuração de credencial.
Confira Compartilhar um painel publicado para obter recomendações sobre qual configuração escolher.
Para publicar um painel, siga estas etapas:
- 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.
- Clique em Publicar. A caixa de diálogo Publicar será exibida.
- Escolha as credenciais a serem usadas no painel publicado. Você pode optar por inserir ou não suas credenciais.
- 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.
Usar uma entidade de serviço para publicar e compartilhar painéis
Use a API REST para publicar e compartilhar painéis com credenciais inseridas associadas a uma entidade de serviço. Isso permite que usuários sem dados diretos ou permissões de computação exibam o painel e executem consultas usando as credenciais da entidade de serviço em vez de as suas próprias. Os usuários devem estar registrados com uma conta do Databricks. Para obter detalhes sobre como usar a API REST para gerenciar painéis, consulte Lakeview na referência da API REST.
Baixar um painel publicado
Depois que um Painel de Controle publicado for carregado, use as seguintes etapas para baixá-lo como um PDF:
- Clique no
próximo ao canto superior direito do painel.
- Clique em Baixar como PDF.
Habilitar um espaço Genie em seu painel
Importante
Esse recurso está em uma versão prévia.
Quando você cria um painel, um 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. O espaço do Genie criado automaticamente começa como um rascunho que você pode usar para visualizar o espaço. 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.
Ao publicar seu painel, você pode optar por publicar o espaço de rascunho do Genie associado ou vincular a um espaço do Genie já existente.
A publicação de um espaço do Genie associado ao seu painel permite que os visualizadores 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 O que é um espaço de IA/BI do Genie.
A publicação do espaço do Genie adiciona um botão Pergunte ao Genie ao painel publicado. Quando os visualizadores do painel clicam nesse botão, uma interface de chat é aberta no painel e solicita que os usuários façam perguntas sobre os dados.
Para publicar o espaço Genie associado, use as seguintes etapas:
- Clique em Publicar.
- O botão de alternância Habilitar Genie está ativado por padrão. Clique no botão de alternância para ativá-lo.
- (Opcional) Para vincular um espaço existente do Genie, selecione o botão de opção Vincular espaço existente do Genie e cole a URL associada. Se essa opção não estiver selecionada, um novo espaço do Genie, baseado em seu painel, será gerado automaticamente para você.
- Clique em Publicar na caixa de diálogo 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.
Para abrir o espaço Genie publicado em uma nova janela:
- Clique no
menu kebab no canto superior direito da janela de bate-papo
- Clique em Abrir Espaço do Genie.
Para visualizar seu rascunho do espaço Genie:
- Clique no menu de kebab
no canto superior direito do painel.
- 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.
Permissões para espaços vinculados do Genie
As permissões no espaço Genie associado espelham as existentes no painel, mas o acesso é limitado a usuários com acesso ao espaço de trabalho. Mesmo que seu painel seja compartilhado com credenciais incorporadas, apenas usuários com acesso ao espaço de trabalho podem interagir com o espaço Genie.
Os espectadores usam suas próprias credenciais para acessar a computação e os dados necessários para alimentar o espaço Genie. Eles devem ter menos a permissão SELECT nas tabelas usadas no espaço 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
É 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.
Prática recomendada para gerenciar versões do painel
Para habilitar a colaboração e gerenciar diferentes versões de um painel, o Databricks recomenda usar as seguintes etapas:
- Exporte seu painel como um arquivo JSON. O formato de arquivo é
lvdash.json
. - Adicione esse arquivo a um sistema de controle de versão, como o Git.
- Edite o arquivo. Os arquivos do painel incluem sintaxe de consulta completa e configurações de widget. Você pode editar valores no arquivo de texto diretamente ou carregá-los de volta no workspace e fazer alterações na interface do usuário.
- Salve o novo arquivo. Se você fez alterações na interface do usuário, exporte seu novo arquivo. Use o sistema de controle de versão para controlar as alterações e as versões do painel.
- Atualize o painel existente. No painel de rascunho existente:
- Clique no menu kebab
no canto superior direito e clique em Substituir painel.
- Clique em Escolher arquivo na caixa de diálogo Substituir painel do arquivo. Em seguida, clique em Substituir.
- Clique no menu kebab
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.