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 os 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 espaço de trabalho. Consulte Compartilhar um painel.

Importante

• A Databricks recomenda o uso de painéis de IA/BI (anteriormente Lakeview dashboards). Versões anteriores de painéis, anteriormente conhecidos como painéis SQL Databricks, agora são chamados de painéis herdados. O Databricks não recomenda a criação de novos painéis herdados.
• Converta painéis herdados usando a ferramenta de migração ou a API REST. Consulte Clonar um painel herdado em um painel de IA/BI para obter instruções sobre como usar a ferramenta de migração interna. Consulte Tutoriais de painel 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 conjuntos de dados para uso 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 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.

Nota

Você pode definir até 100 conjuntos de dados por painel. O Canvas pode conter até 10 páginas. Os painéis podem armazenar até 100 widgets em todas as páginas.

Visualizar e organizar painéis

Você pode acessar painéis do navegador de espaço de trabalho junto com outros objetos do Azure Databricks.

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

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

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

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

Criar um novo dashboard

Para criar um novo painel a partir da página de listagem do painel, clique em Criar perto do canto superior direito da página.

Rascunhe e colabore em um painel

Novos painéis começam como um rascunho. Você pode compartilhar o rascunho com outros usuários em seu espaço de trabalho para colaborar. Não é possível compartilhar painéis de rascunho com usuários fora do espaço de trabalho. Todos os usuários usam suas credenciais para interagir com os dados e visualizações em rascunhos de painel.

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

Defina seus conjuntos de dados

Use a guia Dados para definir os conjuntos de dados subjacentes para seu painel.

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

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

Nota

Todos os conjuntos de dados são definidos por uma consulta. Quando você escolhe uma tabela ou exibição existente do Catálogo Unity, a consulta para esse conjunto de dados é uma instrução SELECT * nessa tabela ou exibição. Você pode modificar a consulta para refinar o conjunto de dados.

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. Para formatar uma consulta, clique com o botão direito do rato no editor e, em seguida, clique em Formatar documento.

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

Ver a tabela de resultados

Quando você cria um conjunto de dados, a consulta é executada automaticamente e os resultados aparecem como uma tabela no painel abaixo do editor. Cada coluna inclui um ícone indicando seu tipo de dados.

Para classificar valores de coluna:

• Passe o cursor sobre cada coluna para mostrar o ícone de ordenação ícone de classificação.
• Clique no ícone para classificar os valores em ordem crescente ou decrescente.

Exibir o esquema de resultado da consulta

Para exibir o esquema do conjunto de dados definido, clique em Esquema à direita de Tabela de Resultados. A guia Esquema lista todos os campos do conjunto de dados definido. Cada campo é rotulado com um ícone indicando o tipo de dados da coluna. Se as tabelas ou exibições subjacentes incluírem comentários, eles aparecerão na guia Esquema.

Escrever consultas com várias instruções

Em alguns casos, talvez você queira construir um conjunto de dados usando várias instruções SQL. Para executar várias instruções, termine cada instrução com um ponto-e-vírgula (;). Quando você executa esses comandos para criar o conjunto de dados, a saída mostra os resultados da última instrução no editor. Esse conjunto de dados é usado para quaisquer visualizações relacionadas na tela.

As instruções são locais para o conjunto de dados no qual são emitidas. Por exemplo, se você criar um conjunto de dados com uma USE instrução para definir o catálogo ou esquema, essa configuração se aplicará somente a esse conjunto de dados.

Exemplos

Os exemplos a seguir demonstram usos comuns para consultas com várias instruções.

Definir o catálogo e o esquema

Você pode escrever uma USE instrução para declarar o catálogo e o esquema para a tabela em sua consulta. A consulta a seguir contém três instruções. O primeiro define o nome do catálogo. O segundo define o esquema. A SELECT instrução faz referência apenas ao nome da tabela porque o catálogo e o esquema foram definidos. Consulte USE CATALOG.

USE CATALOG samples;
USE SCHEMA tpch;
SELECT * FROM customer;

Definir modo ANSI

Você pode definir uma consulta para ser executada com ANSI_MODE set como TRUE ou FALSE. Para Databricks SQL, o valor padrão do sistema para ANSI_MODE é TRUE. Ver ANSI_MODE.

A consulta a seguir define ANSI_MODE para FALSE que entradas de tipo de dados inválidas retornem NULL em vez de lançar um erro.

SET ANSI_MODE = FALSE;
SELECT cast('a' AS INTEGER);

Parametrizar consultas complexas

Você pode usar várias instruções para parametrizar o nome do modo de exibição para uma expressão de tabela comum ou outra consulta complexa.

A consulta a seguir cria dois modos de exibição temporários. A SELECT instrução usa a IDENTIFIER cláusula para interpretar a cadeia de caracteres de entrada como um nome de tabela. Consulte a cláusula IDENTIFIER.

CREATE TEMPORARY VIEW v1 AS SELECT 1;
CREATE TEMPORARY VIEW v2 AS SELECT 2;
SELECT * FROM IDENTIFIER(:view_name)

Definir variáveis

A consulta a seguir declara uma variável e um valor na primeira instrução. A segunda instrução altera o valor da variável. A terceira instrução mostra que o valor final para a variável é 5. Consulte SET VARIABLE para obter detalhes e sintaxe completa para usar variáveis temporárias.

DECLARE VARIABLE myvar1 INT DEFAULT 7;
SET VAR myvar1 = 5;
VALUES (myvar1);

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 evitar 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 em sua instrução SQL em vez de configuração de tabela.

Adicionar páginas, visualizações, texto e filtros à tela

Use a guia Canvas para construir 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

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

Nota

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.

Visualizações

Crie uma visualização adicionando um widget de visualização a uma página na tela. As visualizações suportadas incluem tipos de gráficos de área, barra, caixa, combinação, contador, mapa de calor, histograma, linha, pizza, pivô, dispersão e tabela. Para obter uma lista completa dos tipos de visualização disponíveis e exemplos de valores de configuração, consulte Tipos de visualizações do painel.

Nota

As consultas usadas pelas visualizações nem sempre correspondem com precisão 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 Databricks Assistant gerar um gráfico. Depois de criado, você pode modificar o gráfico gerado usando o painel de configuração. Não é possível usar o Assistente para criar tipos de gráficos de tabela ou tabela dinâmica.
• Use o painel de configuração: aplique agregações adicionais ou compartimentos de tempo na configuração de 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 formatação personalizada aos seus gráficos, consulte Visualizações do painel. Consulte Opções de tabela para saber como controlar a apresentação de dados em visualizações de tabela.

Nota

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 simples. Você pode usar a marcação em widgets de texto para formatar texto, inserir links e adicionar imagens ao seu painel.

Adicionar imagens a widgets de texto

Use um dos seguintes métodos para adicionar imagens ao seu painel. Cada método inclui exemplos de sintaxe de marcação que editam para exibir sua imagem. Para redimensionar uma 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 espaço de trabalho e pelo caminho para a imagem armazenada em um volume.

  Use as seguintes etapas para obter o caminho para sua imagem:

  1. Clique em Catálogo na barra lateral para abrir a interface do usuário do Catalog Explorer.
  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 Unity? para saber mais sobre como armazenar dados em volumes.

• Imagens hospedadas publicamente:

  Para imagens hospedadas publicamente, use a sintaxe de marcação 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, a marcação a seguir 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 sintaxe de markdown, consulte este guia.

Nota

Quando você publica seu painel com credenciais incorporadas, os visualizadores usam suas credenciais para acessar as imagens incluídas. Se seus painéis não forem publicados com credenciais incorporadas, você deverá conceder explicitamente acesso aos usuários para arquivos de imagem armazenados no Azure Databricks. Use o Gerenciador 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 Catalog Explorer.

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 baseados no mesmo conjunto de dados são filtrados automaticamente nesse valor.

Como editor de painel, configure a filtragem cruzada criando dois ou mais gráficos que compartilham o 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
• Box plot
• Heatmap
• Histograma
• Circular
• 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.

Utilizar filtros

Os filtros são widgets de painel que ajudam os visualizadores a restringir os resultados e refinar os dados em visualizações, semelhante às segmentações de dados 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. Os 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.

Nota

Os filtros em campos e parâmetros afetam apenas as visualizações na mesma página que o widget de filtro. Os filtros aplicam-se a todas as visualizações nessa página que partilham o mesmo conjunto de dados.

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 definir 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. Consulte Otimização e cache de conjuntos de dados.

Filtrar em campos

Os filtros de campo refinam os dados apresentados em visualizações filtrando campos específicos do conjunto de dados. Por exemplo, um filtro de campo pode limitar os dados a um determinado intervalo de datas com base em um campo de data em um conjunto de dados. Os filtros podem ser aplicados aos campos de um ou mais conjuntos de dados. Para conectar um filtro a campos de 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.

Filtrar parâmetros

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

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

• String
• Numérico
  • Número inteiro
  • Decimal
• Date
• Data e Hora
• Intervalo de Datas
• Intervalo de data e hora

Tipos de filtro

Os painéis suportam os seguintes tipos de filtro para filtragem em um parâmetro:

• Valor único
• Vários valores
• Seletor de datas
• Intervalo de datas

Os painéis suportam os seguintes tipos de filtro para filtragem em um campo:

• Valor único
• Vários valores
• Seletor de datas
• Seletor de intervalo de datas
• Entrada de texto
• Controle deslizante de alcance

Filtros e parâmetros em URLs de painéis publicados

As seleções de filtros e parâmetros são armazenadas no URL. Os usuários podem marcar essas URLs 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 acessam 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 cadeia de caracteres 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 o 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: Time Range, Pickup Zip e Dropoff Zip. No URL de exemplo, o valor Pickup ZIP 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 cadeia de caracteres f_01ef60cd2a3c11818750488d57e7a1bb, que é definida como o valor 10013.

Especificar valores relativos de intervalo de datas no URL

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

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

<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 cadeia de caracteres f_01ef60cd29f81d1aacc19a7312fb10a4, que é definida como o valor now-12h.

Filtros estáticos de widgets

Os filtros de widget estáticos apresentam diferentes visualizações do mesmo conjunto de dados em uma tela. Ao contrário dos filtros de painel, os filtros de widget estáticos aplicam-se apenas ao widget de visualização onde estão configurados. Esses filtros são estáticos e não podem ser alterados pelos visualizadores do painel.

Suponha que você esteja criando um painel de vendas que analise o desempenho regional. Você usa um conjunto de dados com dados de vendas para todas as regiões. Ao aplicar filtros de widget estáticos, você pode configurar um widget para exibir vendas para a Região A e outro widget para exibir vendas para a Região B. Essa abordagem permite que os espectadores comparem o desempenho regional lado a lado, mesmo que ambos os widgets se baseiem no mesmo conjunto de dados. Como os filtros de widgets estáticos são fixos, os visualizadores não podem modificar os filtros, garantindo que o painel sempre apresente uma exibição consistente dos dados.

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 na lista suspensa Conjunto de dados no painel de configuração.

3. Clique em Mostrar filtros. Uma opção Filtrar campos aparece 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 adição à 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. Reveja o seu painel.

Parâmetros estáticos do widget

Os parâmetros permitem substituir valores diferentes em consultas de conjunto de dados em tempo de execução. Consulte Trabalhar com parâmetros de painel para saber como configurar parâmetros em suas consultas.

Os parâmetros estáticos do widget são configurados diretamente em um widget de visualização, permitindo que os autores reutilizem conjuntos de dados enquanto apresentam diferentes visualizações do mesmo conjunto de resultados em diferentes widgets de visualização. Por exemplo, considere um conjunto de dados mostrando as 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, você pode 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, você pode mostrar a comparação em seu painel. Os parâmetros estáticos do widget não são interativos, portanto, as visualizações do painel não podem ajustar seus valores.

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

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

Copiar widgets

Use atalhos de teclado para copiar um widget selecionado e colá-lo novamente 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, conclua as seguintes etapas:

• Clique com o botão direito do rato num widget.
• Clique em Clonar.

Um clone do seu widget aparece abaixo do original.

Remover widgets

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

Resultados de transferência

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

• Para abrir as opções de download na guia Canvas , 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 em formato CSV e TSV e até 100.000 linhas para um arquivo Excel. O tamanho final do download do arquivo pode ser um pouco maior ou menor que 1GB, pois o limite de 1GB é 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ê deve ter pelo menos permissões CAN EDIT para publicar um painel.

Depois de publicar um painel, a versão publicada permanece intacta até que você publique novamente, mesmo se você fizer alterações no rascunho. Você pode fazer modificações e melhorias na versão de rascunho sem afetar a cópia publicada. Qualquer utilizador registado com acesso ao painel publicado pode continuar a visualizar a versão publicada. A versão publicada continua a ser enviada por e-mail aos assinantes, caso existam. Para saber mais sobre como gerenciar o acesso ao painel, consulte Compartilhar um painel.

Importante

Os painéis publicados não têm controle de versão e não devem ser usados para controle de versão. Não é possível reverter um painel de rascunho para um estado publicado anteriormente.

Ao publicar, escolha uma das seguintes opções:

• Incorporar credenciais: 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 visualizem, mesmo que não tenham acesso ao espaço de trabalho de origem, aos dados subjacentes ou ao SQL warehouse. Isso pode expor os dados a usuários que não receberam acesso direto a eles. Esta é a opção padrão.
• Não incorporar credenciais: todos os visualizadores do painel publicado executam consultas usando seus próprios dados e credenciais de computação. Para exibir os resultados no painel, os visualizadores precisam acessar o espaço de trabalho, o SQL warehouse anexado e os dados associados.

Nota

Todos os visualizadores do painel devem se autenticar para acessar o painel, independentemente da configuração de credencial.

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

Para publicar um painel, conclua as seguintes etapas:

1. Abra um painel. Se o painel tiver sido publicado anteriormente, a versão publicada será aberta. Se necessário, use o switcher na parte superior da página para ver a versão de rascunho atual.
2. Clique em Publicar. A caixa de diálogo Publicar é exibida.
3. Escolha as credenciais a serem usadas para o painel publicado. Você pode optar por incorporar suas credenciais ou não.
4. Clique em Publicar. Se o seu painel estiver sendo publicado pela primeira vez, uma caixa de diálogo Compartilhamento será aberta e solicitará que você compartilhe o painel publicado. Consulte 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.

Habilite um espaço Genie a partir do seu painel

Importante

Esta funcionalidade está em Pré-visualização Pública.

Quando você cria um painel, um espaço Genie é criado automaticamente para você. Um espaço Genie é uma interface sem código que permite que os usuários de negócios realizem análises de dados de autoatendimento usando linguagem natural. O espaço Genie criado automaticamente começa como um rascunho que você pode usar para visualizar o espaço. O espaço do Genie de rascunho permanece sincronizado com o painel de rascunho à medida que você adiciona e remove conjuntos de dados e visualizações.

Ao publicar seu painel, você tem a opção de publicar o espaço Genie de rascunho associado ou vincular a um espaço Genie existente.

A publicação de um espaço Genie associado ao seu painel 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. Veja O que é um espaço de IA/BI Genie.

A publicação do espaço Genie adiciona um botão Ask Genie ao painel publicado. Quando os visualizadores do painel clicam nesse botão, uma interface de bate-papo é 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:

1. Clique em Publicar.
2. A opção Ativar Genie está ativada por padrão. Clique no interruptor para ativá-lo.
3. (Opcional) Para vincular um espaço Genie já existente, selecione o botão de opção Vincular espaço Genie já existente e cole o URL associado. Se esta opção não estiver selecionada, é gerado automaticamente para si um novo espaço Genie baseado no seu painel.
4. Clique em Publicar na caixa de diálogo Publicar .

Nota

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

Para abrir o espaço Genie publicado em uma nova janela:

1. Clique no menu kebab no canto superior direito da janela de chat
2. Clique em Abrir Espaço Genie.

Para visualizar seu espaço Genie de rascunho:

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

Nota

Não é possível editar as instruções para este espaço Genie a partir da IU do espaço Genie. O espaço do Genie de rascunho só muda quando você faz alterações no painel de rascunho.

Permissões para espaços Genie vinculados

As permissões no espaço Genie associado espelham as existentes no painel, mas o acesso é limitado aos usuários com acesso ao espaço de trabalho. Mesmo que seu painel seja compartilhado com credenciais incorporadas, somente 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 pelo menos a permissão SELECT nas tabelas usadas no espaço Genie.

Partilhar um dashboard

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 diferentes níveis de permissão 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 os usuários registrados visualizem e executem seu painel.

Para obter detalhes sobre como os administradores podem configurar sua conta para compartilhamento no nível da conta, consulte 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.

Incorporar painéis em sites e aplicativos

Você pode incorporar seu painel publicado em sites e aplicativos externos usando um iframe. Consulte Incorporar um painel.

Se você for um administrador de espaço de trabalho que deseja gerenciar os sites externos onde os painéis podem ser incorporados, consulte Gerenciar incorporação de painéis.

Agendas e subscrições

Você pode configurar atualizações agendadas para atualizar automaticamente o cache do seu painel e, opcionalmente, enviar e-mails com um PDF do painel mais recente para os usuários que estão inscritos na agenda. Os usuários com pelo menos permissões de Pode Editar podem criar uma agenda para que os painéis publicados com credenciais incorporadas sejam executados periodicamente. Cada painel pode ter até dez horários.

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 espaços de trabalho. Para transferir um painel para um espaço de trabalho diferente, exporte-o como um arquivo e importe-o para o novo espaço de trabalho. Você também pode substituir os arquivos do painel no local. Isso significa que, ao editar um arquivo de painel diretamente, você pode carregar esse arquivo para o espaço de trabalho original e substituir o arquivo existente, mantendo as configurações de compartilhamento existentes.

As seções a seguir explicam como exportar e importar painéis na interface do usuário. Você também pode usar a API Databricks para importar e exportar painéis programaticamente. Consulte 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 painel . Quando a exportação é bem-sucedida, um .lvdash.json arquivo é salvo no diretório de download padrão do navegador da Web.

Importar um arquivo de painel

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

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

Substituir um painel 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 do arquivo e selecione o .lvdash.json arquivo a ser importado.
• Clique em Substituir para substituir o painel existente.

Práticas recomendadas para gerenciar versões de painéis

Para habilitar a colaboração e gerenciar diferentes versões de um painel, o Databricks recomenda o uso das seguintes etapas:

1. Exporte seu painel como um arquivo JSON. O formato de arquivo é lvdash.json.
2. Adicione esse arquivo a um sistema de controle de versão, como o Git.
3. 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á-lo de volta ao seu espaço de trabalho e fazer alterações na interface do usuário.
4. Salve o novo arquivo. Se você tiver feito alterações na interface do usuário, exporte o novo arquivo. Use seu sistema de controle de versão para acompanhar as alterações e versões do painel.
5. Atualize o painel existente. A partir do painel de controlo de rascunho existente:
   1. Clique no menu kebab no canto superior direito e, em seguida, clique em Substituir o painel.
   2. Clique em Escolher ficheiro na caixa de diálogo painel Substituir de. Em seguida, clique em Substituir.

Gerenciando 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 Lakeview, bem como como criá-los, gerenciá-los e compartilhá-los.

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

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