Criar destinatários de dados para OpenSharing (compartilhamento Databricks-to-Databricks)
Esta página explica como criar destinatários no OpenSharing, quando os destinatários estão em um workspace do Databricks habilitado para o Unity Catalog. Para view, atualizar, excluir, conceder acesso a compartilhamento, gerenciar propriedades ou restringir acesso com listas de IP para um destinatário existente, consulte Gerenciar destinatários de dados para OpenSharing.
Um destinatário é o objeto nomeado que representa a identidade de um usuário ou grupo de usuários que consomem dados compartilhados. A forma como você cria destinatários difere dependendo se o seu destinatário tem acesso a um workspace Databricks que esteja habilitado para o Unity Catalog:
-
Destinatários com acesso a um workspace do Databricks habilitado para Unity Catalog:
É possível criar um objeto de destinatário com uma conexão segura gerenciada pelo Databricks. Esse modo de compartilhamento é chamado de compartilhamento Databricks-to-Databricks e está documentado nesta página.
-
Destinatários sem acesso a um workspace do Databricks com Unity Catalog habilitado:
Você deve usar compartilhamento aberto , com uma conexão segura que você gerencia usando autenticação baseada em tokens (tokens do portador ou federação OAuth). Para obter informações sobre como criar destinatários de compartilhamento Databricks-to-Open, consulte Habilitar a federação Open ID Connect (OIDC) para destinatários do OpenSharing ou Criar um objeto destinatário para usuários que não são do Databricks usando tokens do portador (compartilhamento Databricks-to-Open).
Para obter mais informações sobre estes dois modos de compartilhamento e quando escolher qual, consulte Compartilhamento Databricks-para-Aberto versus compartilhamento Databricks-to-Databricks.
Requisitos
Para criar um destinatário:
- Você deve ter o privilégio
CREATE RECIPIENTpara o metastore do Unity Catalog onde os dados que você deseja compartilhar estão registrados. - É necessário criar o destinatário utilizando um workspace Databricks que tenha esse metastore do Unity Catalog anexado.
- Se você usar um Notebook Databricks para criar o destinatário, seu compute deve usar o Databricks Runtime 11.3 LTS ou acima e o modo de acesso padrão ou dedicado (antigos modos de acesso compartilhado e de usuário único).
Para as permissões necessárias para outras operações de destinatários (view, atualizar, excluir, conceder acesso de compartilhamento, gerenciar propriedades), consulte Gerenciar destinatários de dados para OpenSharing.
Criar um objeto de destinatário para usuários do Databricks
Se o destinatário dos seus dados tiver acesso a um workspace do Databricks que foi habilitado para o Unity Catalog, você pode criar um objeto de destinatário com um tipo de autenticação de DATABRICKS.
Um objeto destinatário com o tipo de autenticação DATABRICKS representa um destinatário de dados em um metastore específico do Unity Catalog, identificado na definição do objeto destinatário por uma string de *identificador de compartilhamento* que consiste na cloud, região e UUID do metastore. Os dados compartilhados com este destinatário podem ser acessados somente nesse metastore.
Para criar um destinatário para o compartilhamento Databricks-to-Databricks, use o Catalog Explorer, a CLI do Databricks ou o comando SQL CREATE RECIPIENT em um Notebook do Databricks ou no editor de consultas SQL do Databricks. Para criar um destinatário com a API REST, incluindo um destinatário de e-mail, consulte Create a recipient na referência da API REST.
Permissões necessárias : Administrador de metastore ou usuário com o privilégio CREATE RECIPIENT para o metastore do Unity Catalog onde os dados que deseja compartilhar estão registrados.
- Catalog Explorer
- SQL
- CLI
-
No seu Databricks workspace, clique em
Catálogo .
-
No topo do painel Catálogo , clique no ícone de
engrenagem e selecione OpenSharing .
Alternativamente, no canto superior direito, clique em **Share > OpenSharing**.
-
Na tab Compartilhado por mim , clique em Novo destinatário .
-
Escolha como o seu destinatário pode acessar os compartilhamentos dele:
-
Compartilhar usando email (Beta): isso envia um email ao destinatário, solicitando que ele faça log in na account do Databricks e selecione o metastore desejado. O destinatário deve fazer log in com uma account do Databricks que use o endereço de email convidado. Para obter mais informações e conhecer as limitações, consulte o compartilhamento por email.
- Insira o Nome do destinatário .
- Insira o endereço de email do destinatário.
- Em Configure como este compartilhamento pode ser consumido , selecione Qualquer cliente OpenSharing aceito ou Limitar aos destinatários da Databricks . Qualquer cliente OpenSharing aceito permite que seu destinatário faça download de um arquivo de credencial e acesse o compartilhamento no Databricks.
- (Opcional) Em Allowed metastores (via sharing ID) , clique em Add metastore e insira um identificador de compartilhamento para limitar quais metastores do Databricks podem aceitar o convite.
-
Quando você adiciona um destinatário a um compartilhamento, o OpenSharing envia um link de ativação seguro por email para o destinatário e envia um novo email cada vez que você o adiciona a outro compartilhamento. Conceder novamente um compartilhamento que o destinatário já possui não trigger um email duplicado. Consulte Gerenciar o acesso a compartilhamentos de dados do OpenSharing (para provedores).
-
Compartilhar usando o identificador de compartilhamento : Você precisa solicitar e inserir o identificador de compartilhamento do destinatário.
-
Insira o Nome do destinatário .
-
Para Tipo de destinatário , selecione Databricks .
-
Insira o **Identificador de Compartilhamento** do destinatário.
Use a string do identificador de compartilhamento inteira no formato
<cloud>:<region>:<uuid>. Por exemplo,aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016. 4. (Opcional) Insira um comentário. -
-
Clique em Criar .
-
(Opcional) Crie **propriedades do destinatário** personalizadas.
Na guia Visão geral do destinatário, clique no ícone de edição
ao lado de Propriedades do destinatário . Em seguida, adicione um nome de propriedade ( Chave ) e Valor . Para obter detalhes, consulte Gerenciar propriedades do destinatário.
Execute o seguinte comando em um Notebook ou no editor de consultas SQL do Databricks:
CREATE RECIPIENT [IF NOT EXISTS] <recipient-name>
USING ID '<sharing-identifier>'
[COMMENT "<comment>"];
Use a string do identificador de compartilhamento inteira no formato <cloud>:<region>:<uuid>. Por exemplo, aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.
Pode-se também adicionar propriedades personalizadas para o destinatário. Para obter detalhes, consulte Gerenciar propriedades do destinatário.
Execute o seguinte comando usando a CLI do Databricks. Substitua os valores temporários:
<recipient-name>: O nome do destinatário.<sharing-identifier>: a cadeia de caracteres inteira do identificador de compartilhamento no formato<cloud>:<region>:<uuid>. Por exemplo,aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.<authentication-type>: Definido comoDATABRICKSquando uma string de identificador de compartilhamento no formato<cloud>:<region>:<uuid>for fornecida para<sharing-identifier>.
databricks recipients create <recipient-name> <authentication-type> --sharing-code <sharing-identifier>
Pode-se também adicionar propriedades personalizadas para o destinatário. Para obter detalhes, consulte Gerenciar propriedades do destinatário.
O destinatário é criado com o authentication_type de DATABRICKS.
Recursos adicionais
- Gerenciar acesso a compartilhamentos de dados OpenSharing (para provedores) — Conceda ao destinatário o acesso a um ou mais compartilhamentos.
- Gerenciar destinatários de dados para o OpenSharing — Visualizar, atualizar, excluir, gerenciar propriedades ou restringir acesso para um destinatário existente.
- Crie compartilhamentos para o OpenSharing — Crie os compartilhamentos aos quais deseja conceder acesso ao destinatário.