Pular para o conteúdo principal

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:

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.

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.

  1. No seu Databricks workspace, clique em Ícone de dados. Catálogo .

  2. No topo do painel Catálogo , clique no ícone de ícone de engrenagem. 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. 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.

      1. Insira o Nome do destinatário .
      2. Insira o endereço de email do destinatário.
      3. 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.
      4. (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.
nota

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.

    1. Insira o Nome do destinatário .

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

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

  1. Clique em Criar .

  2. (Opcional) Crie **propriedades do destinatário** personalizadas.

    Na guia Visão geral do destinatário, clique no ícone de edição Í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.

O destinatário é criado com o authentication_type de DATABRICKS.

Recursos adicionais​