Painéis herdados

Você pode usar o editor SQL para criar um painel herdado que combine visualizações e caixas de texto que fornecem contexto aos seus dados.

Visualizar e organizar painéis herdados

Você pode acessar painéis do navegador do workspace junto com outros objetos do Azure Databricks.

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

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

• Clique na guia Painéis herdados para visualizar os painéis herdados.

  Por padrão, a guia Meus painéis é selecionada e mostra os painéis de sua propriedade classificados em ordem cronológica inversa. Reordene a lista clicando no título Criado em. Ou use as guias na parte superior da página para visualizar os painéis Favoritos ou Todos os painéis. Use a guia Tags para filtrar por tag.

Organizar os dashboards em pastas no navegador de workspace

Organize os dashboards novos e existentes em pastas no navegador do espaço de trabalho, juntamente com outros objetos do Azure Databricks. Consulte Navegador do workspace.

Filtrar a lista de painéis salvos

Filtrar a lista de todos os dashboards pelo dashboards que você criou (Meus Dashboards), por favoritos e por marcas.

Crie um painel herdado

Você não pode mais criar novos painéis herdados. Em vez disso, o Databricks recomenda usar dashboards de IA/BI. Para saber mais, consulte Dashboards. Para obter instruções sobre como criar um novo painel, consulte Criar um painel.

Clonar um painel herdado

Não há mais suporte para clonagem de painéis herdados. Para converter um painel herdado existente em um painel de IA/BI, consulte Clonar um painel herdado em um painel de IA/BI.

Usando parâmetros de consulta em painéis herdados

Opcionalmente, as consultas podem aproveitar parâmetros ou valores estáticos. Quando uma visualização baseada em uma consulta parametrizada é adicionada a um painel, a visualização pode ser configurada para usar um:

• Parâmetro do widget: os parâmetros do widget são específicos para uma única visualização em um painel, aparecem no painel de visualização e os valores dos parâmetros especificados se aplicam somente à consulta subjacente à visualização.
• Parâmetro do painel: os parâmetros do painel herdado podem ser aplicados a diversas visualizações. Quando você adiciona uma visualização com base em uma consulta parametrizada a um painel, por padrão, o parâmetro será contado como um parâmetro de painel. Os parâmetros de dashboard são configurados para uma ou mais visualizações em um painel e aparecem na parte superior do painel. Os valores de parâmetro especificados para um parâmetro de dashboard se aplicam às visualizações que reutilizam esse parâmetro de dashboard específico. Um painel pode ter vários parâmetros; cada um deles pode ser aplicado a algumas visualizações e não a outras.
• Valor estático: os valores estáticos são usados em vez de um parâmetro que responde às alterações. Os valores estáticos permitem codificar um valor no lugar de um parâmetro e farão com que o parâmetro "desapareça" do dashboard ou do widget em que ele apareceu anteriormente.

Ao adicionar uma visualização contendo uma consulta parametrizada, você pode escolher o título e a fonte do parâmetro na consulta de visualização clicando no ícone de lápis apropriado . Você também pode selecionar a palavra-chave e um valor padrão. Confira Propriedades de parâmetro.

Depois de adicionar uma visualização a um painel, você pode acessar a interface de mapeamento de parâmetro clicando no Menu kebab no canto superior direito de um widget de painel e, em seguida, clicando em Alterar configurações de widget.

Propriedades do parâmetro

As propriedades do parâmetro widget do painel são:

• Título: o nome de exibição que aparece ao lado do seletor de valor em seu painel. Ele usa como padrão o título definido no editor de consultas. Para editar como ele aparece no dashboard, clique no ícone de lápis . Os títulos não são exibidos para parâmetros de painel estático, porque o seletor de valor está oculto. Se você selecionar Valor estático como a origem do valor, o campo Título ficará esmaecido.

• Palavra-chave: o literal de cadeia de caracteres desse parâmetro na consulta subjacente. Isso será útil para depuração se o painel não retornar os resultados esperados.

• Valor padrão: o valor definido para esse parâmetro na carga do painel até que outro seja selecionado e as alterações sejam aplicadas. Para alterar esse padrão, abra a consulta subjacente no editor do SQL, altere o parâmetro para o valor desejado e clique no botão Salvar.

• Origem do valor: a origem do valor do parâmetro. Clique no ícone de lápis para escolher uma origem.

  • Novo parâmetro de painel: cria um novo parâmetro de nível de painel. Isso permite que você defina um valor de parâmetro em um único local no dashboard e o mapeie para uma ou mais visualizações. Os parâmetros devem ter nomes exclusivos no painel.
  • Parâmetro de painel existente: mapeie o parâmetro dessa visualização para um parâmetro de painel existente. Você deve especificar o parâmetro de painel já existente.
  • Parâmetro de widget: exibe um seletor de valor dentro do widget de painel. Isso é útil para parâmetros únicos que não são compartilhados entre widgets.
  • Valor estático: escolhe um valor estático para o widget, independentemente dos valores usados em outros widgets. Os valores de parâmetros mapeados estaticamente não exibem um seletor de valor em lugares mais compactos do painel. Isso permite que você aproveite a flexibilidade dos parâmetros de consulta sem obstruir a interface do usuário em um painel quando não se espera que determinados parâmetros sejam alterados com frequência.

  

Editar um painel herdado

Para abrir o painel de edição, abra o Menu de kebab no canto superior direito do painel e selecione Editar.

Durante a edição, você pode adicionar e remover conteúdo, editar visualizações e aplicar filtros. Para alterar a ordem em que os parâmetros são mostrados, você pode clicar e arrastar cada parâmetro para a posição desejada.

Filtrar entre várias consultas

Para filtrar entre várias consultas em um dashboard:

1. Vá para o seu painel herdado.
2. No modo Editar, clique em Adicionar e, em seguida, clique em Filtrar.
3. Selecione Novo filtro de dashboard e escolha as consultas e colunas a serem filtradas. Você também pode optar por importar filtros de consultas existentes selecionando Filtros de consulta existentes e optando por importar um filtro de um editor de consultas SQL. As consultas escolhidas devem pertencer ao mesmo catálogo e esquema.
4. Clique em Salvar. Isso cria um filtro que contém a união de todas as opções de listas suspensas.

Editar uma visualização de dashboard

Para editar uma visualização no painel enquanto estiver no modo de edição, selecione a visualização que você deseja editar e clique no Menu kebab no canto superior direito da visualização. Na lista exibida, selecione Editar visualização.

Adicionar conteúdo a um painel

1. Abra o painel para edição.
2. Clique em Adicionar Caixa de Texto ou Adicionar Widget.
3. Clique em Adicionar ao painel herdado.
4. Clique em Edição concluída.

Você também pode adicionar uma visualização a um painel no editor do SQL.

Remover conteúdo de um painel

1. Clique em ou passe o mouse sobre o objeto, clique no menu kebab na parte superior direita do widget e selecione Remover do Painel.
2. Clique em Excluir.

Filtros de painel

Quando as consultas têm filtros, você também deve aplicar filtros no nível do painel. Marque a caixa de seleção Usar Filtros de Nível de Painel para aplicar o filtro a todas as consultas.

Personalizar as cores do painel

Você pode personalizar a paleta de cores do dashboard, incluindo criar uma paleta de cores.

Crie uma paleta de cores

Para criar uma paleta de cores personalizada para um painel:

1. Clique no Menu kebab no canto superior direito e clique em Editar.
2. Clique em Cores.
3. Para importar uma paleta de cores existente, clique em importar e selecione a paleta. Você pode personalizar a paleta importada.
4. Para criar uma nova paleta ou para personalizar uma paleta importada, faça o seguinte:
   1. Para adicionar uma nova cor, clique em Adicionar.
   2. Para uma cor recém-adicionada ou uma cor existente, especifique a cor seguindo um destes procedimentos:
      • Clique no quadrado e selecione a nova cor clicando nela no seletor de cores ou usando o conta-gotas.
      • Clique no campo de texto ao lado do quadrado e insira um valor hexadecimal.
5. Clique em Aplicar.

Parar de usar uma paleta de cores personalizada

Para remover uma paleta de cores personalizada:

1. Clique no Menu kebab no canto superior direito e clique em Editar.
2. Clique em Cores.
3. Clique em Desmarcar.
4. Clique em Aplicar.

Use uma paleta de cores diferente para uma visualização

Por padrão, se uma paleta de cores tiver sido aplicada em um painel, todas as visualizações usarão essa paleta de cores. Se você quiser usar cores diferentes para uma visualização, poderá substituir esse comportamento:

1. Clique no Menu kebab para a visualização no painel e clique em Editar.
2. Clique na caixa de seleção ao lado de Reter cores especificadas na visualização.
3. Clique em OK.

Atualizar um painel

Os painéis herdados são projetados para carregamento eficiente, pois recuperam dados de um cache que é renovado sempre que uma consulta é executada. No entanto, seus dashboards poderão ficar desatualizados se você não executar as consultas associadas regularmente. Para impedir que seus painéis fiquem obsoletos, você pode atualizar o painel para executar novamente as consultas associadas.

Sempre que um painel é atualizado, manualmente ou em um agendamento, todas as consultas referenciadas no painel são atualizadas. Quando uma visualização individual é atualizada, a consulta upstream é atualizada. Atualizar manualmente o painel ou a visualização individual não atualiza as consultas usadas nas Listas suspensas baseadas em consulta. Para obter detalhes sobre listas suspensas baseadas em consulta, confira Lista suspensa baseada em consulta.

Atualizar comportamento e contexto de execução

Quando um painel é “Executar como proprietário” e uma programação é adicionada, a credencial do proprietário é usada para execução e qualquer pessoa com pelo menos a permissão PODE EXECUTAR vê os resultados dessas consultas atualizadas.

Quando um painel é "Executado como Visualizador" e um agendamento é adicionado, a credencial do proprietário é usada para a execução, mas somente o proprietário vê os resultados atualizados das consultas; todos os outros usuários devem atualizar manualmente para ver os resultados atualizados das consultas.

Atualizar manualmente um painel

Para forçar uma atualização, clique em Atualizar na parte superior direita do painel. Isso executa todas as consultas do painel e atualiza suas visualizações.

Atualizar automaticamente um painel

O proprietário de um painel de controle e os usuários com a permissão CAN EDIT podem configurar um painel para atualizar automaticamente de acordo com um cronograma. Para atualizar automaticamente um painel:

1. Clique em Agendar no canto superior direito do painel. Em seguida, clique em Adicionar agenda.

2. Use os seletores da lista suspensa para especificar a frequência, o período, a hora de início e o fuso horário. Opcionalmente, marque a caixa de seleção Mostrar sintaxe cron para editar o agendamento na Sintaxe Quartz Cron.

3. Escolha Mais opções para mostrar as configurações opcionais. Você pode optar por:

   • Um nome para o agendamento.
   • Um SQL warehouse para potencializar a consulta. Por padrão, o SQL warehouse usado para execução de consulta ad hoc também é usado para um trabalho agendado. Use essa configuração opcional para selecionar um warehouse diferente para executar a consulta agendada.

   Observação

   Este warehouse pode ser diferente do usado para atualização manual.

4. Opcional: na guia Assinantes, insira uma lista de endereços de email para notificar quando o painel é atualizado automaticamente. Cada endereço de email deve ser associado a uma conta do Azure Databricks com acesso ao workspace ou definido como um destino de notificação nas configurações do workspace. Os destinos de notificação são configurados por um administrador do workspace.

5. Clique em Criar. O rótulo de Agendar mudará para Agendar(1).

6. Edite as configurações de compartilhamento.

   Observação

   As permissões do painel não estão vinculadas a permissões de agendamento. Depois de criar o intervalo de atualização agendado, edite as permissões de agendamento para fornecer acesso a outros usuários. Somente usuários com permissão PODE GERENCIAR podem editar a programação ou editar a lista de assinantes.

   • Clique no Menu de kebab.
   • Clique em Editar permissões de agendamento.
   • Escolha um usuário ou grupo no menu suspenso do diálogo.
   • Escolha CAN VIEW para permitir que os usuários selecionados visualizem a configuração do agendamento.

A permissão CAN VIEW ou CAN RUN permite que o destinatário atribuído veja se existe uma programação, bem como outras propriedades, como cadência do relatório e número de assinantes. PODE GERENCIAR permite que o destinatário modifique a programação, a lista de assinantes e a permissão de agendamento. A permissão CAN MANAGE também permite que o destinatário pause ou retome a programação.

Atualizar o comportamento em um painel aberto

Quando você abre um dashboards definido como Run as Owner, ele exibe dados da atualização mais recente do painel, independentemente de ter sido agendada ou atualizada manualmente. Se um painel estiver aberto em uma janela do navegador e uma consulta for modificada ou uma execução agendada atualizar os resultados do painel, as alterações não serão refletidas imediatamente. Os resultados atualizados serão exibidos na próxima vez que você abrir o painel ou atualizar a janela do navegador aberto.

Assinaturas de instantâneo do painel

Você pode exportar periodicamente e enviar instantâneos de painel de email. Instantâneos de painel são tirados do estado padrão do painel, o que significa que toda interação com os filtros e as visualizações não está incluída no instantâneo.

Se você tiver pelo menos a permissão CAN EDIT, poderá criar uma agenda de atualização e inscrever outros usuários, que receberão instantâneos do painel por email sempre que ele for atualizado. Para adicionar assinantes, insira usuários ou grupos na guia Assinantes, conforme descrito acima. Os assinantes qualificados incluem usuários do workspace e destinos de notificação.

Há um limite de tamanho de arquivo de 6 MB para anexos de email. Se um email de assinatura de dashboard exceder o limite de tamanho de 6 MB, o email omitirá o instantâneo do dashboard embutido e incluirá apenas um PDF do instantâneo do dashboard.

Se o arquivo de instantâneo PDF exceder 6 MB, o email da assinatura omitirá o PDF e incluirá um link para o painel atualizado. O email terá uma observação de aviso detalhando o tamanho atual do painel. (Os usuários podem testar o tamanho do instantâneo PDF baixando manualmente um PDF do dashboard.)

Pausar temporariamente as atualizações agendadas do painel

Se um painel estiver configurado para atualizações automáticas e você tiver pelo menos a permissão PODE EXIBIR no agendamento, o rótulo no botão Agendar será Agendar(#), onde # é o número de eventos agendados que estão visíveis para você. Além disso, se você tiver pelo menos a permissão PODE GERENCIAR na programação, poderá pausar temporariamente a programação. Isso é útil para evitar o envio de atualizações durante o teste de alterações no painel. Para pausar temporariamente as atualizações agendadas do painel sem modificar a lista de assinantes:

1. Clique em Agendamento(#).
2. Clique no Menu de kebab.
3. Clique em Pausar.

Parar de atualizar automaticamente um painel

Para parar de atualizar automaticamente o painel e remover suas assinaturas:

1. Clique em Agendamento(#).
2. Clique no menu kebab >Excluir.

Limites de tamanho do painel para assinaturas

Os emails de assinatura do painel herdado incluem os seguintes arquivos codificados em base64:

• PDF: um arquivo PDF que inclui o painel completo.
• DesktopImage: um arquivo de imagem otimizado para visualização em computadores desktop.

É imposto um limite máximo de 6MB ao tamanho combinado dos dois arquivos. As descrições a seguir descrevem o comportamento esperado quando o tamanho do arquivo combinado excede o limite:

• Se o arquivo PDF tiver mais de 6 MB: o email de assinatura não inclui o anexo em PDF ou quaisquer imagens. Inclui uma nota informando que o painel excedeu o limite de tamanho e mostra o tamanho real do arquivo do painel atual.
• Se o tamanho do arquivo combinado for superior a 6 MB: somente o PDF será anexado ao email. A mensagem embutida inclui um link para o painel, mas nenhuma imagem.

Baixar como PDF

Para baixar um painel como um arquivo PDF, clique no Menu kebab no canto superior direito do painel e selecione Baixar como PDF.

Mover um painel herdado para a Lixeira

Para mover um painel até a Lixeira, faça o seguinte:

1. Clique no menu kebab no canto superior direito do painel e selecione Mover para a Lixeira.
2. Confirme clicando em Mover para a Lixeira.

Restaurar um painel herdado da Lixeira

1. Clique no Workspace na barra lateral.
2. Clique em Lixeira no navegador do espaço de trabalho para exibir os ativos incluídos.
3. Clique no Menu de kebab ao lado do painel que você deseja restaurar.
4. Clique em Restaurar. É exibida uma caixa de diálogo Mover.
5. Use a caixa de diálogo Mover para escolher um novo local para o painel restaurado.

Excluir permanentemente um painel herdado

1. Clique no Workspace na barra lateral.
2. Clique em Lixeira no navegador do espaço de trabalho para exibir os ativos incluídos.
3. Clique no Menu kebab ao lado do painel que você deseja excluir.
4. Clique em Excluir permanentemente.
5. Confirme clicando em Excluir.

Abrir uma consulta

Para abrir a consulta exibida em um widget no editor do SQL, clique no ícone de Menu kebab no canto superior direito do widget e selecione Exibir Consulta.

Configurar permissões do painel herdado e propriedade do painel

Você deve ter CAN MANAGE em um painel para configurar permissões. Para níveis de permissão do painel, veja ACLs de painel herdado.

1. Na barra lateral, clique em Painéis.
2. Clique em um painel.
3. Clique no botão no canto superior direito para abrir a caixa de diálogo Compartilhamento.
4. Procure e selecione os grupos ou os usuários e atribua o nível de permissão.
   1. Defina as credenciais como Executar como visualizador para atribuir as permissões PODE EDITAR ou PODE GERENCIAR.
5. Clique em Adicionar.

Você pode compartilhar rapidamente todas as consultas associadas ao seu painel clicando no ícone de engrenagem e selecionando Compartilhar todas as consultas. As consultas referenciadas pelo painel têm permissões separadas e não são compartilhadas por padrão quando você compartilha o painel.

Transferir a propriedade de um painel herdado

Se o proprietário de um dashboard for removido de um workspace, o painel não terá mais um proprietário. Um usuário administrador do workspace pode transferir a propriedade de qualquer dashboard, incluindo um sem um proprietário, para um usuário diferente. Os grupos não podem receber a propriedade de um painel. Você também pode transferir a propriedade usando a API de Permissões.

1. Como administrador do workspace, faça logon no workspace do Azure Databricks.

2. Na barra lateral, clique em Painéis.

3. Clique em um painel.

4. Clique no botão Compartilhar no canto superior direito para abrir a caixa de diálogo Compartilhamento.

5. Clique no ícone de engrenagem no canto superior direito e clique em Atribuir novo proprietário.

   

6. Selecione o usuário ao qual a propriedade será atribuída.

7. Clique em Confirmar.

Acessar a exibição do administrador

Um usuário administrador do workspace do Azure Databricks tem acesso de exibição a todos os dashboards no workspace. Nessa exibição, um administrador do workspace pode exibir e excluir qualquer dashboard. No entanto, um administrador de workspace não pode editar um painel quando as credenciais de configuração de compartilhamento são definidas como Executar como proprietário.

Para exibir todos os painéis herdados:

1. Clique em Painéis na barra lateral.
2. Clique na guia Painéis herdados.
3. Clique na guia Todos os painéis perto da parte superior da tela.