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 espaço de trabalho do Azure Databricks habilitado para o Unity Catalog. Para exibir, atualizar, excluir, conceder acesso a compartilhamento, gerenciar propriedades ou restringir o 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 os destinatários varia dependendo se o destinatário tem ou não acesso a um workspace do Azure Databricks habilitado para o Unity Catalog:

Para obter mais informações sobre esses dois modos de compartilhamento e quando escolher cada um deles, consulte Compartilhamento Databricks-to-Open em comparação ao compartilhamento Databricks-to-Databricks.

Requirements

Para criar um destinatário:

  • Você deve ter o privilégio CREATE RECIPIENT do metastore do Unity Catalog em que os dados que você deseja compartilhar estão registrados.
  • Você deve criar o destinatário usando um workspace do Azure Databricks que tenha esse metastore do Catálogo do Unity anexado.
  • Se você usar um bloco de anotações do Databricks para criar o destinatário, seu ambiente deve usar o Databricks Runtime 11.3 LTS ou superior e o modo de acesso padrão ou dedicado (anteriormente chamados de modos de acesso compartilhado e de usuário único).

Para obter permissões necessárias para outras operações de destinatário (exibir, atualizar, excluir, conceder acesso de compartilhamento, gerenciar propriedades), consulte Gerenciar destinatários de dados para OpenSharing.

Criar um objeto destinatário para usuários do Azure Databricks

Se o destinatário dos seus dados tiver acesso a um workspace do Azure Databricks que foi habilitado para o Unity Catalog, você pode criar um objeto destinatário com um tipo de autenticação de DATABRICKS.

Um objeto de destinatário com o tipo de autenticação de DATABRICKS representa um destinatário de dados em um metastore específico do Catálogo do Unity, identificado na definição do objeto de destinatário por uma cadeia de caracteres de identificador de compartilhamento que consiste na nuvem, região e UUID do metastore. Os dados compartilhados com esse destinatário só poderão ser acessados nesse metastore.

Para criar um destinatário para compartilhamento Databricks para Databricks, use o Explorador de Catálogos, a CLI do Databricks ou o CREATE RECIPIENT comando SQL em um notebook do Azure Databricks ou o editor de consultas SQL do Databricks. Para criar um destinatário com a API REST, incluindo um destinatário de e-mail, veja Criar um destinatário na referência da API REST.

Permissões necessárias: Administrador do Metastore ou usuário com o privilégio CREATE RECIPIENT para o metastore do Catálogo do Unity no qual os dados que você deseja compartilhar estão registrados.

Gerenciador de Catálogos

  1. No workspace Azure Databricks, clique em Data icon.Catalog.

  2. Na parte superior do painel Catálogo , clique no ícone Engrenagem. Ícone de engrenagem e selecione OpenSharing.

    Como alternativa, no canto superior direito, clique em Compartilhar > OpenSharing.

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

  4. Escolha como seu destinatário pode acessar seus compartilhamentos:

    • Compartilhar usando e-mail (Beta): Isso envia um e-mail para o destinatário, solicitando que ele faça login em sua conta do Azure Databricks e selecione a metastore desejada. O destinatário deve fazer login com uma conta do Azure Databricks que utilize o endereço de e-mail convidado. Para mais informações e limitações, veja compartilhamento de e-mails.

      1. Insira o nome do destinatário.
      2. Insira o endereço de email do destinatário.
      3. Para configurar como esse compartilhamento pode ser consumido, selecione Qualquer cliente OpenSharing suportado ou Limitar aos destinatários Databricks. Qualquer cliente OpenSharing suportado permite que seu destinatário baixe um arquivo de credencial e acesse o compartilhamento no Azure Databricks.
      4. (Opcional) Em Metastores permitidos (via ID de compartilhamento), clique em Adicionar metastore e insira um identificador de compartilhamento para limitar quais metastores do Azure Databricks podem aceitar o convite.

      Note

      Quando você adiciona um destinatário a um compartilhamento, o OpenSharing envia um link seguro de ativação para o destinatário e envia um novo e-mail cada vez que você adiciona o destinatário a outro compartilhamento. Conceder novamente um compartilhamento que o destinatário já possui não aciona um e-mail duplicado. Consulte Gerenciar o acesso aos compartilhamentos de dados do OpenSharing (para provedores).

    • Compartilhe usando identificador de compartilhamento: Você precisa pedir e inserir o identificador de compartilhamento do destinatário.

      1. Insira o nome do destinatário.

      2. Para o tipo destinatário, selecione Databricks.

      3. Insira o identificador de compartilhamento do destinatário.

        Use toda a cadeia de caracteres do identificador de compartilhamento no formato <cloud>:<region>:<uuid>. Por exemplo, aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016.

      4. (Opcional) Insira um comentário.

  5. Clique em Criar.

  6. (Opcional) Criar propriedades do Destinatário personalizadas.

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

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

Use toda a cadeia de caracteres do identificador de 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 comando a seguir usando a CLI do Databricks. Substitua os valores de espaço reservado:

  • <recipient-name>: o nome do destinatário.
  • <sharing-identifier>: Use toda a cadeia de caracteres do identificador de compartilhamento no formato <cloud>:<region>:<uuid>. Por exemplo, aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.
  • <authentication-type>: defina para DATABRICKS quando uma cadeia de caracteres do identificador de compartilhamento no formato <cloud>:<region>:<uuid> for fornecida para <sharing-identifier>.
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 do DATABRICKS.

Recursos adicionais

  • Última atualização em