Painéis herdados

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

Visualizar e organizar painéis herdados

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.

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

• Clique na guia Painéis herdados para exibir painéis herdados.

  Por padrão, a guia Meus painéis é selecionada e mostra os painéis que você possui classificados em ordem cronológica inversa. Reordene o list clicando no cabeçalho Criado em. Ou use as guias próximas à parte superior da página para exibir Favoritos ou Todos os painéis. Use a guia Tags para filtrar por tag.

Organizar painéis em pastas no navegador de espaço de trabalho

Organize painéis novos e existentes em pastas no navegador de espaço de trabalho junto com outros objetos do Azure Databricks. Consulte Navegador de espaço de trabalho.

Filtrar o list de painéis salvos

Filtre o list de todos os dashboards por aqueles que você criou (Meus Dashboards), por favoritose por etiquetas.

Criar um painel herdado

Siga estas etapas para criar um novo painel herdado. Para clonar um painel existente, consulte Clonar um painel herdado.

1. Clique em Painéis na barra lateral e, em seguida, clique na guia Painéis herdados.
2. Clique em Criar painel herdado.
3. Insira um nome para o painel.
4. Ao criar um painel, tem a opção de especificar um armazém a ser utilizado para processos manuais refresh. Caso não select e guarde um armazém de dados no painel, recairá para usar o armazém de dados guardado para consultas individuais.

1. Adicione conteúdo ao painel clicando em Adicionar e selecionando o tipo de conteúdo a ser adicionado:

   • Clique em Caixa de texto para adicionar comentários.

     Insira o texto. Estilize as caixas de texto usando Markdown.

     • Para adicionar uma imagem estática em uma caixa de texto, use a sintaxe da imagem de marcação com uma descrição e URL disponível publicamente: ![description](url). Por exemplo, a marcação a seguir insere uma imagem do logotipo do Databricks: ![The Databricks Logo](https://upload.wikimedia.org/wikipedia/commons/6/63/Databricks_Logo.png). Para redimensionar a imagem, redimensione as dimensões do widget.
     • Para adicionar uma imagem do DBFS, adicione a sintaxe da imagem de marcação com uma descrição desejada e o caminho do FileStore: ![description](files/path_to_dbfs_image). Para redimensionar a imagem, redimensione as dimensões do widget.

     Importante

     As imagens usadas em um painel armazenadas no DBFS não serão renderizadas ao fazer um pdf ou assinatura sob demanda

   • Clique em Visualização para adicionar uma visualização de consulta.

     1. Select uma consulta. Pesquise consultas existentes ou escolha uma recente na lista preenchida previamente list. Se uma consulta foi salva com a configuração Limit 1000, a consulta no painel limita os resultados a 1000 linhas.

     2. No menu suspenso Escolher Visualização, select o tipo de visualização.

        

2. Clique em Adicionar ao painel herdado.

3. Arraste e solte blocos de conteúdo no painel.

4. Clique em Edição concluída.

   

Você também pode criar um painel com o provedor Databricks Terraform e databricks_sql_dashboard. Você pode criar um widget para um painel herdado com databricks_sql_widget. Você pode criar um painel herdado de exemplo com dbsql-nyc-taxi-trip-analysis.

Clone um painel herdado

Você pode clonar o painel herdado e todas as consultas upstream se tiver as permissões CAN RUN, CAN EDIT e CAN MANAGE no painel e em cada uma de suas consultas upstream. Você se torna o proprietário do novo painel e das consultas.

Para clonar um painel herdado:

1. Abra o menu menu kebab no canto superior direito do painel e selectClone.
2. Insira um nome para o novo painel e clique em Confirmar.

Para obter mais informações sobre dropdown suspenso baseado em consulta listparameters, consulte Query-Based dropdown List.

Utilizando consulta parameters em painéis herdados

Opcionalmente, as consultas podem aproveitar parameters ou valuesestá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 Widget: Os parameters são específicos para uma única visualização dentro de um painel de visualização, aparecem dentro do painel de visualização, e o parâmetro values especificado aplica-se apenas à consulta subjacente à visualização.
• Parâmetro do painel: o painel herdado parameters pode ser aplicado a várias visualizações. Quando você adiciona uma visualização baseada em uma consulta parametrizada a um painel, por padrão, o parâmetro será contado como um parâmetro de painel. Os dashboards parameters estão configurados para uma ou mais visualizações num painel e aparecem no topo do painel. O parâmetro values especificado para um parâmetro dashboard se aplica a visualizações que reutilizam esse parâmetro específico do painel. Um painel pode ter vários parameters, cada um dos quais pode aplicar-se a algumas visualizações e não a outras.
• Valor estático: Valores estáticos values são usados em vez de um parâmetro que responde a alterações. O values estático permite fixar de forma rígida um valor no lugar de um parâmetro e fará com que o parâmetro "desapareça" do painel ou widget where onde ele apareceu anteriormente.

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

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

Propriedades do parâmetro

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

• Título: O nome para exibição que aparece ao lado do seletor de valores no painel. O padrão é o título set no editor de consultas. Para editar como ele aparece no painel, clique no ícone de lápis . Os títulos não são exibidos para o painel estático parameters, como o seletor de valores está oculto. Se escolher select'Valor estático' como sua Fonte de Valor, o campo Título ficará acinzentado.

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

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

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

  • Novo parâmetro do painel: crie um novo parâmetro no nível do painel. Isso permite set um valor de parâmetro em um só lugar no painel e mapeá-lo para uma ou mais visualizações. Parameters deve ter nomes exclusivos dentro do painel.
  • Parâmetro de painel existente: mapeie o parâmetro desta visualização para um parâmetro de painel existente. Você deve especificar qual parâmetro de painel pré-existente.
  • Parâmetro do widget: exibe um seletor de valor dentro do widget do painel. Isso é útil para parameters únicos que não são compartilhados entre widgets.
  • Valor estático: Escolha um valor estático para o widget, independentemente do values usado em outros widgets. Os parâmetros mapeados estaticamente, como o values, não exibem um seletor de valores em qualquer lugar do painel, o que torna o painel mais compacto. Isso permite-lhe aproveitar a flexibilidade da consulta parameters sem sobrecarregar a interface do utilizador num painel quando não se espera que determinados parameters sejam alterados com frequência.

  

Editar um painel herdado

Para abrir o painel para edição, abra o menu menu kebab no canto superior direito do painel e selectEditar.

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

Filtrar em várias consultas

Para filtrar várias consultas em um painel:

1. Vá para o seu painel legado.
2. No modo de edição, clique em Adicionar e, em seguida, clique em Filtrar.
3. Select Novo filtro de painel e escolha as consultas e columns filtrar. Você também pode optar por importar filtros de consultas existentes selecionando Filtros de consulta existentes e escolhendo importar um filtro de um editor de consultas SQL. As consultas que você escolher devem pertencer ao mesmo catalog e schema.
4. Clique em Guardar. Isso cria um filtro que contém a união de todas as opções suspensas.

Editar uma visualização de painel

Para editar uma visualização no painel enquanto estiver no modo de edição, select a visualização que deseja editar e clique no menu Kebab menu kebab no canto superior direito da visualização. Na listexibida, selectEditar a 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 SQL.

Remove conteúdo a partir de um painel

1. Clique no ou passe o mouse sobre o objeto, clique no menu menu kebab no canto superior direito do widget e selectRemove no Dashboard.
2. Clique em Eliminar.

Filtros de dashboard

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

Personalizar as cores do painel

Você pode personalizar a paleta de cores do painel, incluindo a criação de uma paleta de cores.

Criar 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 Importar e select a paleta. Você pode personalizar a paleta importada.
4. Para criar uma nova paleta ou 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 select a nova cor clicando nele 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 remove 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 Limpar.
4. Clique em Aplicar.

Usar um paladar de cor 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.

Refresh um painel

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

Cada vez que um painel é atualizado, manualmente ou em uma agenda, todas as consultas referenciadas no painel são atualizadas. Quando uma visualização individual é atualizada, a consulta upstream é atualizada. A atualização manual do painel ou da visualização individual não refresh consultas usadas em Listas Suspensas Baseadas em Consultas. Para obter detalhes sobre Dropdown Lists baseadas em consultas, consulte Query-Based Dropdown List.

Refresh comportamento e contexto de execução

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

Quando um painel é “Executado como Visualizador” e uma agenda é adicionada, a credencial do proprietário é usada para a execução. No entanto, apenas o proprietário vê os resultados das consultas atualizadas; todos os outros visualizadores devem realizar refresh manualmente para ver os resultados das consultas atualizados.

Manualmente refresh um painel

Para forçar um refresh, clique em Refresh no canto superior direito do painel. Isso executa todas as consultas do painel e atualiza suas visualizações.

refresh automaticamente um painel

O proprietário de um painel e os utilizadores com a permissão CAN EDIT podem configurar um painel para refresh automaticamente conforme um cronograma. Para refresh automaticamente um painel:

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

2. Use os seletores suspensos para especificar a frequência, o período, a hora de início e o fuso horário. Opcionalmente, select a caixa de seleção Show cron syntax para editar a agenda no Quartz Cron Syntax.

3. Escolha Mais opções para mostrar as configurações opcionais. Pode escolher:

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

   Nota

   Este armazém pode ser diferente daquele utilizado para o manual refresh.

4. Opcional: no separador Assinantes, insira uma list de endereços de e-mail para notificar quando o painel for atualizado automaticamente. Cada endereço de email deve ser associado a uma conta do Azure Databricks com acesso ao espaço de trabalho ou definido como um destino de notificação nas configurações do espaço de trabalho. Os destinos de notificação são configurados por um administrador de espaço de trabalho.

5. Clique em Criar. O rótulo Schedule muda para Schedule(1).

6. Edite as configurações de compartilhamento.

   Nota

   As permissões do painel não estão vinculadas às permissões de agendamento. Depois de criar seu intervalo de refresh agendado, edite as permissões de agendamento para fornecer acesso a outros usuários. Somente utilizadores com permissão CAN MANAGE podem alterar a programação ou editar o listdo assinante.

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

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

Refresh comportamento num painel aberto

Quando você abre um painel set para Run as Owner, ele exibe dados do painel mais recente update, independentemente de ter sido agendado ou atualizado manualmente. Se um(a) painel estiver aberto num navegador window, 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 aparecerão na próxima vez que abrires o painel ou o navegador refresh aberto window.

Assinaturas de instantâneo do painel

Você pode exportar periodicamente e enviar instantâneos do painel por e-mail. Os instantâneos do painel são tirados do estado padrão do painel, o que significa que qualquer interação com os filtros e visualizações não é incluída no instantâneo.

Se tiveres pelo menos a permissão CAN EDIT, podes criar uma programação de refresh e subscrever outros utilizadores, que receberão capturas de ecrã por e-mail do painel sempre que este for atualizado. Para adicionar assinantes, insira usuários ou grupos na guia Assinantes, conforme descrito acima. Os subscritores elegíveis incluem utilizadores da área de trabalho e destinos de notificação.

Há um tamanho de arquivo de 6 MB limit para anexos de e-mail. Se um e-mail de assinatura do painel exceder o tamanho de 6 MB limit, o e-mail omitirá o instantâneo do painel embutido e incluirá apenas um PDF do instantâneo do painel.

Se o arquivo de instantâneo PDF exceder 6 MB, o e-mail de assinatura omitirá o PDF e, em vez disso, incluirá um link para o painel atualizado. O e-mail terá uma nota de aviso detalhando o tamanho atual do painel. (Os usuários podem testar o tamanho do instantâneo PDF baixando manualmente um PDF do painel.)

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 CAN VIEW na agenda, o rótulo no botão ScheduleSchedule(#) o # é o número de eventos agendados visíveis para você. Além disso, se você tiver pelo menos a permissão CAN MANAGE na agenda, poderá pausar temporariamente a agenda. Isso é útil para evitar o envio de atualizações ao testar alterações no painel. Para pausar temporariamente as atualizações agendadas do painel sem modificar a list dos assinantes:

1. Clique em Schedule(#).
2. Clique no menu kebab.
3. Clique em Pausar.

Parar a atualização automática de um painel

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

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

Limites de tamanho do painel para assinaturas

Os e-mails de assinatura do painel herdado incluem os seguintes arquivos codificados base64:

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

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

• Se o ficheiro PDF tiver mais de 6MB: O e-mail de subscrição não inclui o anexo PDF nem quaisquer imagens. Inclui uma nota que diz que o painel excedeu o tamanho limit e mostra o tamanho real do arquivo do dashboard atual.
• Se o tamanho combinado do ficheiro for superior a 6MB: apenas o PDF é anexado ao e-mail. A mensagem embutida inclui um link para o painel, mas nenhuma imagem.

Descarregar em formato PDF

Para baixar um painel como um arquivo PDF, clique no menu Kebab menu kebab no canto superior direito do painel e selectDownload as PDF.

Mover um painel herdado para a Lixeira

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

1. Clique sobre o menu na parte superior direita do dashboard e selectMover para a Lixeira.
2. Confirme clicando em Mover para a Lixeira.

Restore um painel herdado da Lixeira

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

Excluir permanentemente um painel herdado

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

Abrir uma consulta

Para abrir a consulta exibida em um widget no editor SQL, clique no menu Kebab menu kebab no canto superior direito do widget e selectView Query.

Configurar permissões de painel herdadas e propriedade do painel

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

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 select os grupos ou usuários e atribua o nível de permissão.
   1. Set a credentialsExecutar como visualizador para atribuir as permissões CAN EDIT ou CAN MANAGE.
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 painel for removido de um espaço de trabalho, o painel não terá mais um proprietário. Um usuário administrador de espaço de trabalho pode transferir a propriedade de qualquer painel, incluindo um sem proprietário, para um usuário diferente. Não é possível atribuir a propriedade de um painel aos grupos. Você também pode transferir a propriedade usando a API de Permissões.

1. Como administrador do espaço de trabalho, faça logon no seu espaço de trabalho 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. Select o utilizador a quem atribuir a propriedade.

7. Clique em Confirmar.

Aceder à vista de administrador

Um usuário administrador do espaço de trabalho do Azure Databricks tem acesso de exibição a todos os painéis no espaço de trabalho. Nessa exibição, um administrador de espaço de trabalho pode exibir e excluir qualquer painel. No entanto, um administrador de espaço de trabalho não pode editar um painel ao compartilhar credentials de configuração setExecutar como proprietário.

Para visualizar 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 na parte superior da tela.