Tutorial: Compartilhar dados usando o Compartilhamento de Dados do Azure

Neste tutorial, você aprenderá como configurar um novo Compartilhamento de Dados do Azure e começar a compartilhar seus dados com clientes e parceiros fora da sua organização do Azure.

Neste tutorial, irá aprender a:

• Criar um Data Share.
• Adicionar conjuntos de dados ao Data Share.
• Habilite um agendamento de instantâneo para seu compartilhamento de dados.
• Adicione destinatários ao Data Share.

Pré-requisitos

• Assinatura do Azure: se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
• O endereço de email do Azure do destinatário (usar o alias de email dele não funcionará).
• Se o armazenamento de dados do Azure de origem estiver em uma assinatura do Azure diferente daquela que você usará para criar o recurso de Compartilhamento de Dados, registre o provedor de recursos Microsoft.DataShare na assinatura em que o repositório de dados do Azure está localizado.

Partilhar a partir de uma conta de armazenamento

• Uma conta de Armazenamento do Azure: se ainda não tiver uma, pode criar uma conta de Armazenamento do Azure
• Permissão para gravar na conta de armazenamento, que está presente em Microsoft.Storage/storageAccounts/write. Essa permissão existe na função de Colaborador da Conta de Armazenamento .
• Permissão para adicionar atribuição de função à conta de armazenamento, que está presente em Microsoft.Authorization/role assignments/write. Esta permissão existe na função de Proprietário.

Compartilhar de uma fonte baseada em SQL

Abaixo está a lista de pré-requisitos para compartilhar dados da fonte SQL.

Pré-requisitos para compartilhar do Banco de Dados SQL do Azure ou do Azure Synapse Analytics (anteriormente Azure SQL DW)

• Um Banco de Dados SQL do Azure ou o Azure Synapse Analytics (anteriormente Azure SQL DW) com tabelas e exibições que você deseja compartilhar.
• Permissão para gravar nos bancos de dados no SQL Server, que está presente em Microsoft.Sql/servers/databases/write. Esta permissão existe na função de Contribuidor.
• Microsoft Entra Admin do servidor SQL
• Acesso ao Firewall do SQL Server. Isso pode ser feito através das seguintes etapas:
  1. No portal do Azure, navegue até SQL server. Selecione Firewalls e redes virtuais na navegação à esquerda.
  2. Selecione Sim para Permitir que os serviços e recursos do Azure acessem este servidor.
  3. Selecione +Adicionar IP do cliente. O endereço IP do cliente está sujeito a alterações. Esse processo pode precisar ser repetido na próxima vez que você estiver compartilhando dados SQL do portal do Azure. Você também pode adicionar um intervalo de IP.
  4. Selecione Guardar.

Pré-requisitos para compartilhamento do pool SQL do Azure Synapse Analytics (espaço de trabalho)

• • Um pool SQL dedicado do Azure Synapse Analytics (espaço de trabalho) com tabelas que você deseja compartilhar. Atualmente, não há suporte para compartilhamento de exibição. Atualmente, não há suporte para compartilhamento do pool SQL sem servidor.

• Permissão para gravar no pool SQL no espaço de trabalho Synapse, que está presente em Microsoft.Synapse/workspaces/sqlPools/write. Esta permissão existe na função de Contribuidor.

• Permissão para a identidade gerenciada do recurso de Compartilhamento de Dados acessar o pool SQL do espaço de trabalho Sinapse. Isso pode ser feito através das seguintes etapas:

  1. No portal do Azure, navegue até o espaço de trabalho Sinapse. Selecione SQL Ative Directory admin na navegação à esquerda e defina-se como o administrador do Microsoft Entra.

  2. Abra o Synapse Studio, selecione Gerenciar na navegação à esquerda. Selecione Controle de acesso em Segurança. Atribua a si mesmo a função de administrador do SQL ou do espaço de trabalho .

  3. No Synapse Studio, selecione Desenvolver na navegação à esquerda. Execute o script a seguir no pool SQL para adicionar a Identidade Gerenciada do recurso de Compartilhamento de Dados como um db_datareader.

     create user "<share_acct_name>" from external provider;     
     exec sp_addrolemember db_datareader, "<share_acct_name>"; 
     

     O <share_acc_name> é o nome do seu recurso de Compartilhamento de Dados. Se você ainda não criou um recurso de Compartilhamento de Dados, poderá voltar a esse pré-requisito mais tarde.

• Acesso ao firewall do espaço de trabalho Sinapse. Isso pode ser feito através das seguintes etapas:

  1. No portal do Azure, navegue até o espaço de trabalho Sinapse. Selecione Firewalls na navegação à esquerda.
  2. Selecione ATIVADO para Permitir que os serviços e recursos do Azure acessem esse espaço de trabalho.
  3. Selecione +Adicionar IP do cliente. O endereço IP do cliente está sujeito a alterações. Esse processo pode precisar ser repetido na próxima vez que você estiver compartilhando dados SQL do portal do Azure. Você também pode adicionar um intervalo de IP.
  4. Selecione Guardar.

Partilhar a partir do Azure Data Explorer

• Um cluster do Azure Data Explorer com bancos de dados que você deseja compartilhar.
• Permissão para gravar no cluster do Azure Data Explorer, que está presente em Microsoft.Kusto/clusters/write. Esta permissão existe na função de Contribuidor.

Inicie sessão no portal do Azure

Inicie sessão no portal do Azure.

Criar uma conta de compartilhamento de dados

Portal

Crie um recurso de Compartilhamento de Dados do Azure em um grupo de recursos do Azure.

1. Selecione o botão de menu no canto superior esquerdo do portal e, em seguida, selecione Criar um recurso (+).

2. Pesquise por compartilhamento de dados.

3. Selecione Compartilhamento de dados e selecione Criar.

4. Preencha os detalhes básicos do seu recurso de Partilha de Dados do Azure com as seguintes informações.

   Definição	Valor sugerido	Descrição do campo
   Subscrição	a sua subscrição	Selecione a assinatura do Azure que você deseja usar para sua conta de compartilhamento de dados.
   Grupo de recursos	TestResourceGroup	Use um grupo de recursos existente ou crie um novo grupo de recursos.
   Localização	Leste dos EUA 2	Selecione uma região para sua conta de compartilhamento de dados.
   Nome	DataShareAccount	Especifique um nome para sua conta de compartilhamento de dados.

5. Selecione Rever + criar e, em seguida , Criar para criar a sua conta de partilha de dados. Criar uma nova conta de compartilhamento de dados normalmente leva cerca de 2 minutos ou menos.

6. Quando a implementação for concluída, selecione Ir para recurso.

CLI do Azure

Crie um recurso de Compartilhamento de Dados do Azure em um grupo de recursos do Azure.

Comece por preparar o seu ambiente para a CLI do Azure:

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

  • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

Use estes comandos para criar o recurso:

1. Use o comando az account set para definir sua assinatura como sendo a assinatura padrão atual:

   az account set --subscription 00000000-0000-0000-0000-000000000000
   

2. Execute o comando az provider register para registrar o provedor de recursos:

   az provider register --name "Microsoft.DataShare"
   

3. Execute o comando az group create para criar um grupo de recursos ou utilize um grupo de recursos existente:

   az group create --name testresourcegroup --location "East US 2"
   

4. Execute o comando az datashare account create para criar uma conta de compartilhamento de dados:

   az datashare account create --resource-group testresourcegroup --name datashareaccount --location "East US 2" 
   

   Execute o comando az datashare account list para ver suas contas de compartilhamento de dados:

   az datashare account list --resource-group testresourcegroup
   

PowerShell

Crie um recurso de Compartilhamento de Dados do Azure em um grupo de recursos do Azure.

Comece preparando seu ambiente para o PowerShell. Você pode executar comandos do PowerShell localmente ou usando o ambiente Bash no Azure Cloud Shell.

• Se você optar por usar o Azure PowerShell localmente:
  • Instale a versão mais recente do módulo Az PowerShell.
  • Conecte-se à sua conta do Azure usando o cmdlet Connect-AzAccount .
• Se você optar por usar o Azure Cloud Shell:
  • Consulte Visão geral do Azure Cloud Shell para obter mais informações.

Use estes comandos para criar o recurso:

1. Use o comando Connect-AzAccount para se conectar à sua conta do Azure.

   Connect-AzAccount
   

2. Execute o comando Set-AzContext para definir a assinatura correta, se você tiver várias assinaturas.

   Set-AzContext [SubscriptionID/SubscriptionName]
   

3. Execute o comando New-AzResourceGroup para criar um grupo de recursos ou use um grupo de recursos existente:

   New-AzResourceGroup -Name <String> -Location <String>
   

4. Execute o comando New-AzDataShare para criar uma conta de Compartilhamento de Dados:

    New-AzDataShareAccount -ResourceGroupName <String> -Name <String> -Location <String>
   

   Execute o comando Get-AzDataShareAccount para ver suas contas de Compartilhamento de Dados:

   Get-AzDataShareAccount
   

Criar uma partilha

Portal

1. Navegue até a página Visão geral do compartilhamento de dados.

   

2. Selecione Começar a partilhar os seus dados.

3. Selecione Criar.

4. Preencha os detalhes da sua partilha. Especifique um nome, tipo de compartilhamento, descrição do conteúdo do compartilhamento e termos de uso (opcional).

   

5. Selecione Continuar.

6. Para adicionar conjuntos de dados ao seu compartilhamento, selecione Adicionar conjuntos de dados.

   

7. Selecione o tipo de conjunto de dados que você deseja adicionar. Você verá uma lista diferente de tipos de conjunto de dados, dependendo do tipo de compartilhamento (instantâneo ou in-loco) selecionado na etapa anterior. Se partilhar a partir de uma Base de Dados SQL do Azure ou do Azure Synapse Analytics (anteriormente Azure SQL DW), ser-lhe-á pedido o método de autenticação para listar tabelas. Selecione Autenticação do Microsoft Entra e marque a caixa de seleção Permitir compartilhamento de dados para executar o script 'criar usuário' acima em meu nome.

   

8. Navegue até o objeto que deseja compartilhar e selecione 'Adicionar conjuntos de dados'.

   

9. Na guia Destinatários, insira os endereços de e-mail do seu Consumidor de Dados selecionando '+ Adicionar Destinatário'.

   

10. Selecione Continuar.

11. Se você selecionou o tipo de compartilhamento de instantâneo, poderá configurar o agendamento de instantâneo para fornecer atualizações de seus dados ao consumidor de dados.

    

12. Selecione uma hora de início e um intervalo de recorrência.

13. Selecione Continuar.

14. No separador Rever + Criar, reveja o Conteúdo do Pacote, Definições, Destinatários e Definições de Sincronização. Selecione Criar.

CLI do Azure

1. Execute o comando az storage account create para criar uma conta de armazenamento para este compartilhamento de dados:

   az storage account create --resource-group testresourcegroup --name ContosoMarketplaceAccount
   

2. Use o comando az storage container create para criar um contêiner dentro da conta de armazenamento criada no comando anterior:

   az storage container create --name ContosoMarketplaceContainer --account-name ContosoMarketplaceAccount
   

3. Execute o comando az datashare create para criar seu compartilhamento de dados:

   az datashare create --resource-group testresourcegroup \
     --name ContosoMarketplaceDataShare --account-name ContosoMarketplaceAccount \
     --description "Data Share" --share-kind "CopyBased" --terms "Confidential"
   

4. Use o comando az datashare invitation create para criar o convite para o endereço especificado:

   az datashare invitation create --resource-group testresourcegroup \
     --name DataShareInvite --share-name ContosoMarketplaceDataShare \
     --account-name ContosoMarketplaceAccount --target-email "jacob@fabrikam.com"
   

PowerShell

1. Se ainda não tiver dados que gostaria de partilhar, pode seguir estes passos para criar uma conta de armazenamento. Se já tiver armazenamento, pode saltar para o passo 2.

   1. Execute o comando New-AzStorageAccount para criar uma conta de Armazenamento do Azure:

      $storageAccount = New-AzStorageAccount -ResourceGroupName <String> -AccountName <String> -Location <String> -SkuName <String>
      
      $ctx = $storageAccount.Context
      

   2. Execute o comando New-AzStorageContainer para criar um contêiner em sua nova conta de Armazenamento do Azure que armazenará seus dados:

      $containerName = <String>
      
      New-AzStorageContainer -Name $containerName -Context $ctx -Permission blob
      

   3. Execute o comando Set-AzStorageBlobContent para carregar um arquivo. O exemplo a seguir carrega textfile.csv da pasta D:\testFiles na memória local para o contêiner que você criou.

      Set-AzStorageBlobContent -File "D:\testFiles\textfile.csv" -Container $containerName -Blob "textfile.csv" -Context $ctx
      

   Para obter mais informações sobre como trabalhar com o Armazenamento do Azure no PowerShell, siga este guia do PowerShell de Armazenamento do Azure.

2. Execute o comando New-AzDataShare para criar seu compartilhamento de dados:

   New-AzDataShare -ResourceGroupName <String> -AccountName <String> -Name <String> -Description <String> -TermsOfUse <String>
   

3. Use o comando New-AzDataShareInvitation para criar o convite para o endereço especificado:

   New-AzDataShareInvitation -ResourceGroupName <String> -AccountName <String> -ShareName <String> -Name <String> -TargetEmail <String>
   

4. Use o comando New-AzDataShareSynchronizationSetting para definir uma recorrência de sincronização para seu compartilhamento. Isso pode ser diário, de hora em hora ou em um horário específico.

   New-AzDataShareSynchronizationSetting -ResourceGroupName <String> -AccountName <String> -ShareName <String> -Name <String> -RecurrenceInterval <String> -SynchronizationTime <DateTime>
   

Seu Compartilhamento de Dados do Azure já foi criado e o destinatário do seu Compartilhamento de Dados está pronto para aceitar seu convite.

Clean up resources (Limpar recursos)

Quando o recurso não for mais necessário, vá para a página Visão Geral do Compartilhamento de Dados e selecione Excluir para removê-lo.

Próximos passos

Neste tutorial, você aprendeu como criar um Compartilhamento de Dados do Azure e convidar destinatários. Para saber como um consumidor de dados pode aceitar e receber um compartilhamento de dados, continue para o tutorial aceitar e receber dados.

Tutorial: Aceitar e receber dados usando o Compartilhamento de Dados do Azure