Compartilhar um painel de controle

Este artigo explica como publicar um painel e compartilhá-lo com os usuários em seu workspace ou account.

O que são permissões de dados compartilhados?

As permissões de dados compartilhados permitem que você compartilhe seu painel com qualquer pessoa em sua account Databricks , independentemente de ela ter acesso explícito aos dados subjacentes e compute necessários para preencher e atualizar o painel.

Ao publicar um painel, você deve escolher uma das seguintes configurações:

• Permissão de compartilhamento de dados (default) : os visualizadores executam consultas usando as permissões de dados do editor. Isso permite que os usuários view o painel mesmo que não tenham acesso direto aos dados subjacentes. Isso pode expor dados a usuários que não receberam acesso direto a eles. Esta é a opção default .
• Permissão individual para o uso de dados :
  • Os visualizadores executam consultas usando suas próprias credenciais. As permissões de acesso aos dados determinam quais resultados eles podem visualizar, e eles precisam ter acesso aos dados subjacentes.
  • O acesso aos recursos computacionais é sempre concedido pelas credenciais do editor.

Para compartilhar informações de um painel de controle de forma eficaz, os visualizadores devem ter acesso tanto aos dados subjacentes quanto aos recursos compute usados para executar as consultas de suporte. Caso opte por não compartilhar seus dados, você deve verificar se os visualizadores possuem as permissões necessárias para acessar os dados exibidos no painel. Use as permissões de compartilhamento de dados ao compartilhar painéis com usuários que não têm acesso aos dados ou compute subjacentes.

Para dashboards em versão rascunho, as permissões de dados do visualizador são sempre aplicadas, mesmo que o dashboard seja publicado com permissões de dados compartilhadas.

A tabela a seguir resume o acesso e as limitações concedidas por cada opção de publicação.

Opção de publicação	Consultas de execução de quem	Acesso aos dados determinado por	Quem pode view	Melhor para
Permissões de compartilhamento de dados (default)	Editor	Permissões do editor	Usuários e grupos que receberam acesso explicitamente. Os usuários devem estar registrados com a account, mas não precisam de acesso workspace .	Experiência consistente para usuários sem acesso workspace
Permissões de dados individuais	Cada espectador	Permissões do próprio espectador	Usuários do espaço de trabalho com acesso explícito tanto ao painel quanto aos dados Usuários no nível account que receberam acesso explícito ao painel de controle.	Usuários internos com conta workspace e permissões de dados

Quem pode acessar seu painel de controle?

Você pode compartilhar painéis com usuários e grupos em sua account ou workspace Databricks . Os usuários do espaço de trabalho com a licença Databricks SQL podem ter diferentes níveis de permissões atribuídos, que controlam como eles interagem com seus painéis. Usuários com direito de acesso de Consumidor e usuários account têm acesso limitado à viewdo seu painel de controle. Eles podem view e executar o painel de controle, mas não podem editá-lo nem o conjunto de dados subjacente que o suporta. Este nível de acesso está alinhado com as funções de somente viewem outros sistemas de visualização de dados, com o benefício adicional de não exigir uma licença especial.

acesso de usuário ao espaço de trabalho

Os membros do espaço de trabalho recebem permissões que controlam a forma como interagem com o workspace Databricks .

Usuários com a licença Databricks SQL podem receber permissão para acessar dashboards em versão preliminar e publicados.

• É possível acessar tanto a versão preliminar quanto a versão publicada do painel de controle. Eles precisam ter, no mínimo, a permissão CAN EDIT para modificar e republicar um rascunho. Para view todos os níveis de permissão e as respectivas capacidades, consulte ACLs do Painel de Controle.

Os usuários com direito de acesso de Consumidor têm acesso restrito somente para leitura e execução. Eles podem executar o painel, aplicar filtros, interagir com visualizações e compartilhar o URL do painel com outros usuários workspace . Eles não podem criar ou editar um painel de controle nem alterar suas configurações de compartilhamento. Para saber mais sobre o direito de acesso do consumidor , consulte gerenciar direitos.

Os painéis herdam as permissões workspace definidas na pasta que os contém. Por default, os dashboards são armazenados no diretório /Workspace/Users/<username> . Qualquer pessoa que tenha acesso à pasta anexa também poderá acessar seu painel de controle. Somente os administradores workspace podem alterar a propriedade de um painel. Consulte o guia de administração deAI/BI.

acesso de usuário da conta

Membros registrados da sua account Databricks que não possuem acesso workspace podem receber acesso a uma cópia somente viewde um painel. Eles usam as credenciais do editor para acessar os recursos compute e devem receber as permissões apropriadas para acessar os dados subjacentes. Os membros sem acesso ao workspace não podem acessar a versão preliminar do painel e não veem os elementos de navegação workspace Databricks na barra lateral esquerda ou perto da parte superior da tela. A imagem a seguir mostra view de um usuário account enquanto ele navega por diferentes painéis compartilhados.

Para que os membros da sua account acessem painéis compartilhados, um administrador precisa primeiro registrá-los na sua account Databricks . O compartilhamento em nível accountdo painel de controle oferece suporte à autenticação email e senha de uso único, além de login unificado com autenticação única (SSO). Esta configuração restringe o acesso ao painel compartilhado apenas aos membros designados da account, em vez de permitir que qualquer pessoa com o link o view . Consulte o guia de administração deAI/BI.

Usuários da conta que não são membros de um workspace não podem acessar dados do painel de controle de itens protegidos vinculados workspace , como catálogos vinculados workspace , mesmo que tenham permissões para as tabelas ou catálogos subjacentes. Os widgets do painel que consultam itens protegidos vinculados workspacenão exibem dados para usuários account .

Para saber mais sobre como o acesso de usuário accountse compara ao acesso do consumidor , consulte Acesso do consumidor vs. usuários account.

Publicar um painel de controle

Antes de poder compartilhar um painel, você precisa publicá-lo. A publicação cria um instantâneo do seu painel que os visualizadores podem acessar. A versão publicada permanece inalterada até que você publique novamente, mesmo que continue editando o rascunho.

Para publicar um painel de controle:

1. Abra o painel de rascunhos.

2. Clique em Publicar no canto superior direito do painel de controle.

3. Escolha uma das seguintes opções de permissão de dados:

   • Permissões de compartilhamento de dados (default) : os visualizadores executam consultas usando as permissões de dados do editor. Use esta opção para compartilhar com usuários que não têm acesso aos dados subjacentes.
   • Permissões de dados individuais : os visualizadores executam consultas usando suas próprias credenciais. Use esta opção quando os visualizadores precisarem ver os dados com base em suas próprias permissões.

4. Clique em Publicar .

Após a publicação, a caixa de diálogo de compartilhamento é aberta automaticamente, permitindo que você compartilhe imediatamente o painel publicado.

Compartilhe um painel de controle publicado

Os painéis publicados podem ser compartilhados com os seguintes destinatários:

• Usuários e grupos específicos em seu workspace
• Usuários e grupos específicos em sua account Databricks
• Todos os usuários da sua account Databricks

Se você deseja compartilhar com todos os membros da sua account Databricks , use a configuração de compartilhamento: Qualquer pessoa na minha account pode view . Se você deseja compartilhar com todos no seu workspace, use o grupo do sistema: Todos os usuários workspace .

Siga os passos abaixo para compartilhar seu painel:

1. Abra um painel de controle em rascunho ou já publicado.

2. Clique em Compartilhar e, em seguida, use a caixa de diálogo de compartilhamento para definir permissões para usuários e grupos em sua account.

   • Na parte superior da caixa de diálogo, insira os usuários e grupos com os quais deseja compartilhar. Você pode atribuir níveis de permissão específicos, como CAN EDIT e CAN MANAGE. Em seguida, clique em Adicionar .
   • Para atribuir rapidamente acesso view a qualquer pessoa em sua account Databricks , use a opção de configurações de compartilhamento na parte inferior da caixa de diálogo de compartilhamento .

   

   Os usuários precisam ter acesso ao workspace para gerenciar ou editar um painel. Os administradores do espaço de trabalho podem adicionar usuários ao workspace. Veja gerenciar usuários.

nota

Os usuários que não têm acesso ao workspace ficam limitados às permissões CAN RUN . Se você conceder permissões elevadas, como CAN EDIT, a um usuário que não tem acesso workspace , essas permissões aparecerão na caixa de diálogo de compartilhamento , mas suas permissões reais serão limitadas a CAN RUN. Permissões elevadas não podem ser aplicadas a menos que o usuário seja adicionado ao workspace. Se o usuário tiver um nível de permissão mais alto atribuído e for adicionado posteriormente ao workspace, ele poderá interagir com os painéis de acordo com a permissão atribuída. Consulte a seção ACLs do painel para obter mais informações sobre os níveis de permissão do painel.

3. Compartilhe o link com os usuários.

   • Clique em "Copiar link" próximo à parte inferior da caixa de diálogo de compartilhamento para copiar um URL compartilhável para o painel publicado.
   • Opcionalmente, você pode incorporar seu painel de controle em um site ou aplicativo diferente.

Use uma entidade de serviço para publicar e compartilhar painéis.

Utilize a API REST para publicar e compartilhar painéis com permissões de dados compartilhadas associadas a uma entidade de serviço. Quando API de execução dos usuários faz chamadas com os tokens da entidade de serviço, eles acessam os dados sob as permissões da entidade de serviço. Essa configuração permite que usuários que não possuem permissões diretas de dados ou compute view o painel e as consultas em execução, desde que estejam registrados em sua account Databricks .

Para publicar um painel com credenciais de entidade de serviço, primeiro você se autentica como a entidade de serviço para obter um access token OAuth , depois usa esses tokens para chamar o endpoint API de publicação do painel com embed_credentials definido como true. O painel de controle é publicado com as credenciais da entidade de serviço incorporadas, permitindo que os visualizadores acessem o painel sem a necessidade de permissões diretas para os dados subjacentes ou recursos compute .

Para obter instruções passo a passo e exemplos de API, consulte Publicar um painel com credenciais de entidade de serviço. Para obter mais detalhes sobre como usar a API REST para gerenciar painéis, consulte Lakeview na referência da API REST.

Baixe um painel de controle publicado

Após o carregamento do painel de controle publicado, siga os passos abaixo para download lo em formato PDF:

• Clique no próximo ao canto superior direito do painel.
• Clique em "Baixar como PDF" .

gerenciar permissões do painel

Você pode compartilhar painéis de controle com segurança com qualquer pessoa em sua account. Para os usuários atribuídos ao seu workspace, você pode conceder acesso e definir diferentes níveis de permissão, da mesma forma que faria com outros objetos workspace . Para usuários que não estão atribuídos ao seu workspace, você pode compartilhar painéis no nível account , permitindo que usuários registrados view e executem seu painel.

Para obter detalhes sobre como os administradores podem configurar sua account para compartilhamento no nível account , consulte o guia de administração deAI/BI.

Para obter informações sobre os níveis de permissão nos painéis, consulte ACLs do painel.