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 (sejam tokens do portador ou federação OAuth). Para informações sobre a criação de destinatários de compartilhamento Databricks-to-Open, consulte Habilitar federação Open ID Connect (OIDC) para destinatários do OpenSharing e Criar um objeto de destinatário para usuários não-Databricks utilizando tokens de 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 RECIPIENT para 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.

Crie um objeto de destinatário para usuários que têm acesso ao Databricks (compartilhamento Databricks-to-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.

passo 1: Solicite o identificador de compartilhamento do destinatário

Solicite a um usuário destinatário que envie o identificador de compartilhamento para o metastore do Unity Catalog que está anexado aos workspaces onde o usuário destinatário ou grupo de usuários trabalhará com os dados compartilhados.

O identificador de compartilhamento é uma string que consiste na cloud, região e UUID da metastore (o identificador exclusivo para a metastore), no formato <cloud>:<region>:<uuid>.

Por exemplo, na seguinte captura de tela, a string de identificador de compartilhamento completa é aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016.

O destinatário pode encontrar o identificador usando o Catalog Explorer, a CLI do Databricks Unity Catalog ou a função SQL default CURRENT_METASTORE em um Notebook do Databricks ou consulta do Databricks SQL que é executada em um compute com capacidade para Unity Catalog no workspace que eles pretendem usar.

Catalog Explorer

Para obter o identificador de compartilhamento usando o Catalog Explorer:

1. No seu Databricks workspace, clique em Catálogo .

2. No topo do painel Catálogo , clique no ícone de engrenagem e selecione OpenSharing .

   Alternativamente, no canto superior direito, clique em **Share > OpenSharing**.

3. Na tab Compartilhado comigo , clique no nome da sua organização de compartilhamento do Databricks no canto superior direito e selecione Copiar identificador de compartilhamento .

SQL

Execute o seguinte comando em um Notebook ou no editor de consultas SQL do Databricks:

SQL

SELECT CURRENT_METASTORE();

CLI

Execute o seguinte comando usando a CLI do Databricks. O identificador de compartilhamento é retornado como o global_metastore_id.

Bash

databricks metastores summary

É possível enviar ao destinatário as informações contidas nesta etapa, ou direcioná-lo para Obter acesso no modelo Databricks-to-Databricks.

o passo 2: criar o destinatário

Para criar um destinatário para o compartilhamento Databricks-to-Databricks, você pode usar o Catalog Explorer, a CLI do Databricks Unity Catalog ou o comando SQL CREATE RECIPIENT em um Notebook Databricks ou no editor de consultas do Databricks SQL.

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

1. No seu Databricks workspace, clique em Catálogo .

2. No topo do painel Catálogo , clique no ícone de engrenagem e selecione OpenSharing .

   Alternativamente, no canto superior direito, clique em **Share > OpenSharing**.

3. Na tab Compartilhado por mim , clique em Novo destinatário .

4. Insira o Nome do destinatário .

5. Para Tipo de destinatário , selecione Databricks .

6. 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.

7. (Opcional) Insira um comentário.

8. Clique em Criar .

9. (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.

SQL

Execute o seguinte comando em um Notebook ou no editor de consultas SQL do Databricks:

SQL

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.

CLI

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 como DATABRICKS quando uma string de identificador de compartilhamento no formato <cloud>:<region>:<uuid> for fornecida para <sharing-identifier>.

Bash

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.