Receber Azure armazenamento in-loco, compartilhar in-loco com Compartilhamento de Dados do Microsoft Purview (versão prévia)

O Compartilhamento de Dados do Microsoft Purview dá suporte ao compartilhamento in-loco de dados do Azure Data Lake Storage (ADLS Gen2) para o ADLS Gen2 e da conta de armazenamento de Blobs para a conta de armazenamento de Blobs. Este artigo explica como receber um compartilhamento e acessar dados compartilhados.

Pré-requisitos para receber dados compartilhados

Pré-requisitos do Microsoft Purview

• Uma conta do Microsoft Purview.
• Uma função mínima de Leitor de Dados em uma coleção do Microsoft Purview para usar a experiência do usuário de compartilhamento de dados no portal de governança do Microsoft Purview. Consulte as permissões do Microsoft Purview para saber mais sobre a coleção e as funções do Microsoft Purview.
• Para usar o SDK, não é necessária nenhuma permissão do Microsoft Purview.

Pré-requisitos da conta de Armazenamento do Azure

• Sua assinatura do Azure deve ser registrada para o recurso de visualização AllowDataSharing. Siga as etapas abaixo usando o portal do Azure ou o PowerShell.

  • Portal
  • PowerShell

  1. No portal do Azure, selecione a assinatura do Azure que você usa para criar a conta de armazenamento de origem e de destino.
  2. No menu à esquerda, selecione Visualizar recursos em Configurações.
  3. Selecione AllowDataSharing e registre-se.
  4. Atualize a tela de recursos de visualização para verificar se o estado é Registrado. Pode levar de 15 minutos a 1 hora para que o registro seja concluído.
  5. Além disso, para usar o compartilhamento de dados para contas de armazenamento no Leste dos EUA, Leste dos EUA 2, Centro-Sul dos EUA, Centro-Oeste dos EUA, Oeste da Europa, Oeste dos EUA, Oeste dos EUA 2, Oeste dos EUA 3: Selecione AllowDataSharingInHeroRegion e registre

  Para obter mais informações, consulte o artigo Registrar recurso de visualização.

  O RegistrationState deve ser Registrado. Pode levar de 15 minutos a 1 hora para que o registro seja concluído. Para obter mais informações, consulte o artigo Registrar recurso de visualização.

  Observação

  A seguir estão as configurações de conta de armazenamento com suporte:

  • Regiões do Azure: Canadá Central, Leste do Canadá, Sul do Reino Unido, Oeste do Reino Unido, Leste da Austrália, Leste do Japão, Sul da Coreia e Norte da África do Sul
  • Regiões adicionais do Azure: Leste dos EUA, Leste dos EUA 2, Norte da Europa, Centro-Sul dos EUA, Centro-Oeste dos EUA, Oeste da Europa, Oeste dos EUA, Oeste dos EUA 2, Oeste dos EUA
  • Desempenho: Standard
  • Opções de redundância: LRS

• Uma conta de armazenamento de destino criada após a conclusão da etapa de registro. A conta de armazenamento de destino deve estar na mesma região do Azure que a conta de armazenamento de origem. Se você não souber a região do Azure da conta de armazenamento de origem, poderá descobrir durante a etapa de anexação de compartilhamento posteriormente no processo. A conta de armazenamento de destino pode estar em uma região do Azure diferente da sua conta do Microsoft Purview.

  Importante

  A conta de armazenamento de destino deve estar na mesma região do Azure que a conta de armazenamento de origem.

• Você precisa da função Colaborador ou Proprietário ou Proprietário de Dados do Blob de Armazenamento ou Colaborador de Dados do Blob de Armazenamento na conta de armazenamento de destino. Você pode encontrar mais detalhes nas páginas da fonte de dados do ADLS Gen2 ou do Armazenamento de Blobs .

• Se a conta de armazenamento de destino estiver em uma assinatura do Azure diferente da conta do Microsoft Purview, o Microsoft.Purview provedor de recursos precisará ser registrado na assinatura do Azure em que a conta de armazenamento está localizada. Ele é registrado automaticamente no momento do consumidor do compartilhamento anexar o compartilhamento e se o usuário tiver permissão para fazer a /register/action operação e, portanto, funções de Colaborador ou Proprietário para a assinatura onde a conta de armazenamento está localizada. Esse registro só será necessário na primeira vez ao compartilhar ou receber dados em uma conta de armazenamento na assinatura do Azure.

• Uma conta de armazenamento precisa ser registrada na coleção em que você recebe o compartilhamento. Para obter instruções de registro, consulte as páginas da fonte de dados do ADLS Gen2 ou do Armazenamento de Blobs . Esta etapa não é necessária para usar o SDK.

• Versão mais recente do SDK de armazenamento, do PowerShell, da CLI e do Gerenciador de Armazenamento do Azure. A versão da API REST de armazenamento deve ser fevereiro de 2020 ou posterior.

Receber compartilhamento

1. Você pode exibir seus convites de compartilhamento em qualquer conta do Microsoft Purview. Abra o portal de governança do Microsoft Purview navegando diretamente para o portal clássico ou para o novo portal do Microsoft Purview e selecionando sua conta do Microsoft Purview.

2. No portal clássico, selecione o ícone Mapa de Dados na navegação à esquerda. No novo portal, navegue até o aplicativo Catálogo de Dados.

3. Selecione Compartilhar convites. Se você recebeu um convite por email, também pode selecionar o link Exibir convite de compartilhamento no email para selecionar uma conta do Microsoft Purview.

   Se você for um usuário convidado de um locatário, será solicitado que verifique seu endereço de email do locatário antes de exibir o convite de compartilhamento pela primeira vez. Você pode ver nosso guia abaixo para obter as etapas. Uma vez verificado, é válido por 12 meses.

   

4. Como alternativa, no portal do Microsoft Purview, localize o ativo de dados Gen 2 do Armazenamento do Azure ou do Azure Data Lake Storage (ADLS) no qual você gostaria de receber o compartilhamento usando a pesquisa ou navegação do catálogo de dados. Selecione o botão Data Share. Você pode ver todos os convites na guia Compartilhar convites .

5. Selecione o nome do convite de compartilhamento para exibir ou configurar.

6. Se você não quiser aceitar o convite, selecione Excluir.

   

   Observação

   Se você excluir um convite, se quiser aceitar o compartilhamento no futuro, ele precisará ser reenviado. Para desmarcar o compartilhamento sem excluir, selecione o botão Cancelar .

7. É possível editar o nome do compartilhamento recebido , se desejar. Em seguida, selecione um nome de conta de armazenamento para uma conta de armazenamento de destino na mesma região da origem. Você pode optar por Registrar uma nova conta de armazenamento para anexar o compartilhamento na lista suspensa também.

   Importante

   A conta de armazenamento de destino precisa estar na mesma região do Azure que a conta de armazenamento de origem.

8. Configure o Caminho (um novo nome de contêiner ou o nome de um contêiner de compartilhamento existente) e Nova pasta (um novo nome de pasta para o compartilhamento dentro de seu contêiner).

9. Selecione Anexar ao destino.

   

10. Na página Gerenciar compartilhamentos de dados, você vê o novo compartilhamento com o status de Anexando até que ele seja concluído e seja anexado.

    

11. Você pode acessar dados compartilhados da conta de armazenamento de destino por meio do portal do Azure, do Gerenciador de Armazenamento do Azure, do SDK de Armazenamento do Azure, do PowerShell ou da CLI. Você também pode analisar os dados compartilhados conectando sua conta de armazenamento ao Azure Synapse Analytics, Spark ou Databricks.

Quando um compartilhamento é anexado, um novo ativo do tipo compartilhamento recebido é ingerido no catálogo do Microsoft Purview, na mesma coleção em que a conta de armazenamento à qual você anexou o compartilhamento está registrada. Você pode pesquisá-lo ou procurá-lo como qualquer outro ativo.

Consulte Compartilhamento de Dados do Microsoft Purview para saber mais sobre ativos de compartilhamento e linhagem de compartilhamento de dados.

Atualizar compartilhamento recebido

Depois de anexar um compartilhamento, você pode editar o compartilhamento recebido reanexando-o a uma nova conta de armazenamento ou interromper a relação de compartilhamento excluindo o compartilhamento recebido.

Você pode localizar e editar o ativo de compartilhamento recebido de duas maneiras:

• Acesse o armazenamento de blobs ou o ativo ADLS Gen2 em que os dados foram recebidos no catálogo de dados, abra-o e, em seguida, selecione Data Share e Gerenciar compartilhamentos de dados. Lá, você pode ver todas as ações desse ativo. Selecione a guia Compartilhamentos recebidos , selecione um compartilhamento e, em seguida, selecione seu compartilhamento.

  

  

• Pesquise ou navegue no catálogo de dados por ativos de compartilhamento de dados e selecione o compartilhamento recebido. Em seguida, selecione o botão Editar .

  

Reanexar compartilhamento

Depois de selecionar o compartilhamento de dados para edição, você poderá reanexar o compartilhamento a uma nova conta de armazenamento ou caminho em sua conta de armazenamento atual selecionando uma conta de armazenamento, fornecendo um caminho e fornecendo a pasta.

Se você estiver atualizando o destino, selecione Anexar ao destino para salvar suas alterações. A anexação pode levar alguns minutos para ser concluída após o início do processo.

Excluir compartilhamento recebido

Para excluir um compartilhamento recebido, selecione o compartilhamento e, em seguida, selecione Excluir.

A exclusão de um compartilhamento recebido interrompe a relação de compartilhamento e você não poderá acessar os dados compartilhados. A exclusão de um compartilhamento recebido pode levar alguns minutos.

Verificação de usuário convidado

Se você for um usuário convidado no Azure, para poder receber compartilhamentos, sua conta deve primeiro estar associada ao Microsoft Entra ID. Você pode iniciar esse processo de dentro do Microsoft Purview.

1. No Portal de Governança do Microsoft Purview, selecione o Mapa de Dados e, em seguida, Compartilhe convites.

2. Você verá um texto indicando que precisa ser associado ao Microsoft Entra ID. Selecione o botão Obter código de verificação .

   

3. Você receberá um email do Microsoft Azure com o código de verificação. Copie-a.

4. Retorne à página Compartilhar convites no Portal de Governança do Microsoft Purview, selecione Verificar e insira o código recebido.

Solução de problemas

Aqui estão alguns problemas comuns para receber compartilhamento e como solucioná-los.

Não é possível criar uma conta do Microsoft Purview

Se você estiver recebendo um erro relacionado à cota ao criar uma conta do Microsoft Purview, isso significa que sua organização excedeu o limite de serviço do Microsoft Purview. Se você precisar de um aumento no limite, entre em contato com o suporte.

Não consigo encontrar meu ativo da conta de armazenamento no Catálogo

• A fonte de dados não está registrada no Microsoft Purview. Consulte as etapas de registro para o Armazenamento de Blobs e o ADLSGen2 , respectivamente. Não é necessário realizar uma verificação.
• A fonte de dados está registrada em uma coleção do Microsoft Purview para a qual você não tem no mínimo permissão de Leitor de Dados. Consulte as permissões do catálogo do Microsoft Purview e entre em contato com o administrador da coleção para obter acesso.

Não é possível exibir a lista de compartilhamentos no ativo da conta de armazenamento

• Problema de permissão para o armazenamento de dados para o qual você deseja ver os compartilhamentos. Você precisa de um mínimo da função de Leitor na conta de armazenamento de origem para ver uma exibição somente leitura dos compartilhamentos enviados e recebidos. Você pode encontrar mais detalhes na página da fonte de dados do ADLS Gen2 ou do Armazenamento de Blobs .

Não é possível exibir o compartilhamento recebido no ativo da conta de armazenamento

• Você pode ter selecionado uma conta de armazenamento diferente para anexar o compartilhamento, que pode não estar registrada no Microsoft Purview ou talvez registrada em uma coleção para a qual você não tem permissões. Consulte as etapas de registro para o Armazenamento de Blobs e o ADLSGen2 , respectivamente. Consulte as permissões do catálogo do Microsoft Purview e entre em contato com o administrador da coleção para obter acesso às coleções.

Não é possível exibir o convite de compartilhamento

Se você foi notificado de que recebeu um compartilhamento, mas não pode exibir o convite de compartilhamento em sua conta do Microsoft Purview, pode ser devido aos seguintes motivos:

• Você não tem um mínimo de função de Leitor de Dados para nenhuma coleção nesta conta do Microsoft Purview. Entre em contato com o Administrador de Coleção do Microsoft Purview para conceder acesso à função de Leitor de Dados para exibir, aceitar e configurar o compartilhamento recebido.
• O convite de compartilhamento é enviado para seu alias de email ou para um grupo de distribuição de email em vez de seu email de entrada do Azure. Entre em contato com seu provedor de dados e verifique se ele enviou o convite para seu endereço de email de entrada do Azure.
• A ação já foi aceita. Se você já aceitou o compartilhamento, ele não aparecerá mais na guia Compartilhar convites . Selecione Compartilhamentos recebidos em qualquer conta de armazenamento para a qual você tem permissões e veja seus compartilhamentos ativos.
• Você é um usuário convidado do locatário. Se você for um usuário convidado de um locatário, precisará verificar seu endereço de email do locatário para exibir um convite de compartilhamento pela primeira vez. Uma vez verificado, é válido por 12 meses.

Não é possível ver a conta de armazenamento de destino na lista ao anexar um compartilhamento

Quando você anexa um compartilhamento a um destino, se sua conta de armazenamento não está listada para você selecionar, é provável que seja devido aos seguintes motivos:

• Você não tem permissões necessárias para a conta de armazenamento. Verifique os pré-requisitos para obter detalhes sobre as permissões de armazenamento necessárias.

Falha ao anexar compartilhamento

Se você não conseguiu anexar um compartilhamento, provavelmente é devido aos seguintes motivos:

• Problema de permissão para o armazenamento de dados de destino. Verifique os pré-requisitos para as permissões de armazenamento de dados necessárias.
• Não há suporte para a conta de armazenamento. O compartilhamento de dados do Microsoft Purview só dá suporte a contas de armazenamento com configurações específicas.
• O Caminho especificado inclui um contêiner criado fora do Compartilhamento de Dados do Microsoft Purview. Você só pode receber dados em contêineres criados durante a anexação.
• A Nova Pasta que você especificou para receber os dados de armazenamento não está vazia.
• A conta de armazenamento de origem e de destino é a mesma. Não há suporte para o compartilhamento da mesma conta de armazenamento de origem para o mesmo destino.
• Limite excedido. A conta de armazenamento de origem pode dar suporte a até 20 destinos, e a conta de armazenamento de destino pode dar suporte a até 100 fontes. Se você precisar de um aumento no limite, entre em contato com o suporte.

Não é possível acessar dados compartilhados no armazenamento de dados de destino

Se você não consegue acessar dados compartilhados, provavelmente é devido aos seguintes motivos:

• Depois que a anexação de compartilhamento for bem-sucedida, poderá levar algum tempo para que os dados apareçam no repositório de destino. Tente novamente em alguns minutos. Da mesma forma, depois de excluir um compartilhamento, pode levar alguns minutos para que os dados desapareçam no repositório de destino.
• Você está acessando dados compartilhados usando uma versão da API de armazenamento anterior a fevereiro de 2020. Somente a versão da API de armazenamento fevereiro de 2020 e posterior tem suporte para acessar dados compartilhados. Certifique-se de estar usando a versão mais recente do SDK de armazenamento, do PowerShell, da CLI e do Gerenciador de Armazenamento do Azure.
• Você está acessando dados compartilhados usando uma ferramenta de análise que usa uma API de armazenamento, versão fevereiro de 2020. Você pode acessar dados compartilhados do Azure Synapse Analytics, Spark e Databricks. Você não poderá acessar dados compartilhados usandoantes do Azure Data Factory, Power BI ou AzCopy.

Próximas etapas

• Como compartilhar dados
• Perguntas frequentes sobre compartilhamento de dados
• Referência de API REST