Criar destinatários de dados para Delta Sharing (Compartilhamento Databricks-to-Databricks )

Esta página explica como criar destinatários no Delta Sharing, quando os destinatários estão em um workspace Databricks que está habilitado para Unity Catalog. Para view, atualizar, excluir, conceder acesso de compartilhamento, gerenciar propriedades ou restringir o acesso com listas de IP para um destinatário existente, consulte Gerenciar destinatários de dados para Delta Sharing.

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 o senhor cria destinatários difere dependendo se o destinatário tem ou não acesso a um Databricks workspace que está habilitado para Unity Catalog:

• Destinatários com acesso a um Catálogo Unity habilitado Databricks workspace:

  O senhor pode criar um objeto destinatário com uma conexão segura gerenciar por Databricks. Esse modo de compartilhamento é chamado de compartilhamento Databricks-to-Databricks e está documentado nesta página.

• Destinatários sem acesso a um Catálogo Unity habilitado Databricks workspace:

  Você deve usar o Open Compartilhament , com uma conexão segura que você gerencia usando autenticação baseada em tokens ( tokens de portador ou federação OAuth ). Para obter informações sobre como criar destinatários de compartilhamento aberto, consulte Habilitar federação Open ID Connect (OIDC) para destinatários Delta Sharing e Criar um objeto de destinatário para usuários que não sejam doDatabricks usando tokens de portador (compartilhamento aberto).

Para obter mais informações sobre esses dois modos de compartilhamento e quando escolher um deles, consulte Open compartilhamento versus Databricks-to-Databricks compartilhamento.

Requisitos

Para criar um destinatário:

• Você deve ter o privilégio CREATE RECIPIENT para o metastore Unity Catalog onde os dados que você deseja compartilhar estão registrados.
• O senhor deve criar o destinatário usando um Databricks workspace que tenha o metastore Unity Catalog anexado.
• Se o senhor usar um notebook Databricks para criar o destinatário, seu compute deverá usar Databricks Runtime 11.3 LTS ou acima e o modo de acesso padrão ou dedicado (anteriormente, modos de acesso compartilhado e de usuário único).

Para obter informações sobre as permissões necessárias para outras operações do destinatário (view, atualizar, excluir, conceder acesso de compartilhamento, gerenciar propriedades), consulte Gerenciar destinatários de dados para Delta Sharing.

Crie um objeto destinatário para os usuários que têm acesso a Databricks (Databricks-to-Databricks compartilhamento)

Se o destinatário dos dados tiver acesso a um Databricks workspace que tenha sido habilitado para Unity Catalog, o senhor poderá criar um objeto destinatário com um tipo de autenticação DATABRICKS.

Um objeto destinatário com o tipo de autenticação DATABRICKS representa um destinatário de dados em um determinado metastore Unity Catalog, identificado na definição do objeto destinatário por uma cadeia de identificadores de compartilhamento que consiste na nuvem, na região e no UUID do metastore. Os dados compartilhados com esse destinatário só podem ser acessados nessa metastore.

Etapa 1: Solicitar o identificador de compartilhamento do destinatário

Peça a um usuário destinatário que lhe envie o identificador de compartilhamento do metastore Unity Catalog que está anexado ao espaço de trabalho em que o usuário destinatário ou o grupo de usuários trabalhará com os dados compartilhados.

O identificador do compartilhamento é uma cadeia de caracteres que consiste na nuvem, na região e no UUID do metastore (o identificador exclusivo do metastore), no formato <cloud>:<region>:<uuid>.

Por exemplo, na captura de tela a seguir, a sequência completa de identificadores de compartilhamento é aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016.

O destinatário pode encontrar o identificador usando o Catalog Explorer, o Databricks Unity Catalog CLI, ou a função default SQL CURRENT_METASTORE em um Databricks Notebook ou Databricks SQL consultar essa execução em um Unity-Catalog compatível com compute no workspace que pretende usar.

Catalog Explorer

Para obter o identificador de compartilhamento usando o Catalog Explorer:

1. Em seu site Databricks workspace, clique em Catalog .

2. Na parte superior do painel Catálogo , clique no ícone de engrenagem e selecione Delta Sharing .

   Alternativamente, no canto superior direito, clique em Compartilhar > Delta Sharing .

3. No Shared with me tab, clique no nome da sua organização de compartilhamento Databricks no canto superior direito e selecione Copy compartilhamento identifier (Copiar identificador de compartilhamento ).

SQL

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

SQL

SELECT CURRENT_METASTORE();

CLI

execute o seguinte comando usando o Databricks CLI. O identificador de compartilhamento é retornado como global_metastore_id.

Bash

databricks metastores summary

O senhor pode enviar ao seu destinatário as informações contidas nesta etapa ou pode indicá-lo para obter acesso no modelo Databricks-to-Databricks.

Etapa 2: criar o destinatário

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

Permissões necessárias : Administrador do metastore ou usuário com o privilégio CREATE RECIPIENT para o metastore do Unity Catalog onde os dados que o senhor deseja compartilhar estão registrados.

Catalog Explorer

1. Em seu site Databricks workspace, clique em Catalog .

2. Na parte superior do painel Catálogo , clique no ícone de engrenagem e selecione Delta Sharing .

   Alternativamente, no canto superior direito, clique em Compartilhar > Delta Sharing .

3. Em Shared by me (Compartilhado por mim ) tab, clique em New recipient (Novo destinatário ).

4. Insira o nome do destinatário .

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

6. Digite o identificador de compartilhamento do destinatário.

   Use as cadeias de identificadores de todo o compartilhamento 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 personalizadas do destinatário .

   Na visão geral do destinatário tab, clique no ícone de edição ao lado de Recipient properties (Propriedades do destinatário ). Em seguida, adicione um nome de propriedade (chave ) e Value (valor ). Para obter detalhes, consulte gerenciar propriedades do destinatário.

SQL

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

SQL

CREATE RECIPIENT [IF NOT EXISTS] <recipient-name>
USING ID '<sharing-identifier>'
[COMMENT "<comment>"];

Use as cadeias de identificadores de todo o compartilhamento no formato <cloud>:<region>:<uuid>. Por exemplo, aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.

Você também pode adicionar propriedades personalizadas para o destinatário. Para obter detalhes, consulte gerenciar propriedades do destinatário.

CLI

execute o seguinte comando usando o Databricks CLI. Substitua os valores do espaço reservado:

• <recipient-name>: O nome do destinatário.
• <sharing-identifier>: As cadeias de identificadores de todo o compartilhamento no formato <cloud>:<region>:<uuid>. Por exemplo, aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.
• <authentication-type>: Defina como DATABRICKS quando uma cadeia de identificadores de compartilhamento no formato <cloud>:<region>:<uuid> for fornecida para <sharing-identifier>.

Bash

databricks recipients create <recipient-name> <authentication-type> --sharing-code <sharing-identifier>

Você também pode 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.

Próximos passos

• Gerenciar o acesso aos compartilhamentos de dados Delta Sharing (para provedores) — Conceder ao destinatário acesso a um ou mais compartilhamentos.
• Gerenciar destinatários de dados para Delta Sharing — visualizar, atualizar, excluir, gerenciar propriedades ou restringir o acesso de um destinatário existente.
• Criar compartilhamentos para Delta Sharing — Crie os compartilhamentos aos quais você deseja conceder acesso ao destinatário.