Tutorial: Compartilhar dados usando o Azure Data Share

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

Neste tutorial, você aprenderá como:

• Criar um Data Share.
• Adicionar conjuntos de dados a seu Data Share.
• Habilitar uma agenda de instantâneo para seu Data Share.
• Adicionar destinatários a seu 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 de seus destinatários (usar o alias de email 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 do Data Share, registre o provedor de recursos Microsoft.DataShare na assinatura em que o armazenamento de dados do Azure está localizado.

Compartilhamento por meio de uma conta de armazenamento

• Uma conta de Armazenamento do Azure: Se você não tiver uma, poderá 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 Colaborador da Conta de Armazenamento.
• Permissão para adicionar uma atribuição de função à conta de armazenamento, que está presente em Microsoft.Authorization/role assignments/write. Essa permissão existe na função Proprietário.

Compartilhamento por meio de uma fonte baseada em SQL

Veja abaixo a lista de pré-requisitos para o compartilhamento de dados de uma fonte SQL.

Pré-requisitos para o compartilhamento por meio do Banco de Dados SQL do Azure ou do Azure Synapse Analytics (antigo SQL DW do Azure)

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

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

• • Um pool de SQL dedicado do Azure Synapse Analytics (workspace) com as tabelas que você deseja compartilhar. Atualmente, não há suporte para o compartilhamento de exibição. No momento, também não há suporte para o compartilhamento por meio do pool de SQL sem servidor.

• Permissão de gravação no pool de SQL no workspace do Azure Synapse, que está presente em Microsoft.Synapse/workspaces/sqlPools/write. Essa permissão existe na função Colaborador.

• Permissão para que a identidade gerenciada do recurso do Data Share acesse o pool de SQL do workspace do Azure Synapse. Isso pode ser feito executando as seguintes etapas:

  1. No portal do Azure, navegue até o workspace do Azure Synapse. Selecione o administrador do Active Directory do SQL na navegação à esquerda e defina-se como o administrador do Microsoft Entra.

  2. Abra o Synapse Studio e selecione Gerenciar no painel de navegação à esquerda. Escolha Controle de acesso em Segurança. Atribua a você mesmo a função Administrador do SQL ou Administrador do workspace.

  3. No Synapse Studio, selecione Desenvolver no painel de navegação à esquerda. Execute o script a seguir no pool de SQL para adicionar a identidade gerenciada do recurso do Data Share 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 do Data Share. Se ainda não criou um recurso de partilha de dados, poderá voltar a esse pré-requisito mais tarde.

• Acesso ao Firewall do workspace do Azure Synapse. Isso pode ser feito executando as seguintes etapas:

  1. No portal do Azure, navegue até o workspace do Azure Synapse. Selecione Firewalls no painel de navegação à esquerda.
  2. Selecione ATIVADO na opção Permitir que serviços e recursos do Azure acessem este workspace.
  3. Selecione +Adicionar IP de cliente. O endereço IP do cliente está sujeito a alterações. Esse processo talvez precise ser repetido na próxima vez em que você estiver compartilhando dados SQL do portal do Azure. Você também pode adicionar um intervalo de IP.
  4. Selecione Salvar.

Compartilhar 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. Essa permissão existe na função Colaborador.

Entre no Portal do Azure

Entre no portal do Azure.

Criar uma conta do Data Share

Portal

Crie um recurso do Azure Data Share em um grupo de recursos do Azure.

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

2. Pesquise Data Share.

3. Selecione Data Share (versão prévia) e selecione Criar.

4. Preencha os detalhes básicos de seu recurso do Azure Data Share com as informações a seguir.

   Configuração	Valor sugerido	Descrição do campo
   Subscription	Sua assinatura	Selecione a assinatura do Azure que deseja usar para sua conta de compartilhamento de dados.
   Grupo de recursos	testresourcegroup	Use um grupo de recursos existente ou crie um novo.
   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 Examinar + criar e Criar para criar sua conta do data share. Criar uma conta do data share normalmente leva cerca de dois minutos ou menos.

6. Depois que a implantação estiver concluída, selecione Ir para o recurso.

CLI do Azure

Crie um recurso do Azure Data Share em um grupo de recursos do Azure.

Comece preparando seu ambiente para a CLI do Azure:

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.

  • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

Use estes comandos para criar o recurso:

1. Use o comando az account set para definir sua assinatura como 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 usar 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 do Data Share:

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

   Execute o comando az datashare account list para ver suas contas do Data Share:

   az datashare account list --resource-group testresourcegroup
   

PowerShell

Crie um recurso do Azure Data Share em um grupo de recursos do Azure.

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

• Se você optar por usar o Azure PowerShell localmente:
  • Instale a versão mais recente do módulo do Az PowerShell.
  • Conecte-se à sua conta do Azure usando o cmdlet Connect-AzAccount.
• Se você optar por usar o Azure Cloud Shell:
  • Confira 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 do Data Share:

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

   Execute o comando Get-AzDataShareAccount para ver suas contas do Data Share:

   Get-AzDataShareAccount
   

Criar um compartilhamento

Portal

1. Navegue até sua página de Visão Geral do Data Share.

   

2. Selecione Começar a compartilhar seus dados.

3. Selecione Criar.

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

   

5. Selecione Continuar.

6. Para adicionar conjuntos de dados ao 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) que você selecionou na etapa anterior. Se você estiver compartilhando dados em um Banco de Dados SQL do Azure ou no Azure Synapse Analytics (antigo SQL DW do Azure), precisará fornecer o método de autenticação para listar tabelas. Selecione autenticação do Microsoft Entra e marque a caixa de seleção Permitir que o Data Share execute o script 'create user' acima em meu nome.

   

8. Navegue até o objeto que você gostaria de compartilhar e selecione "Adicionar Conjuntos de Dados".

   

9. Na guia Destinatários, insira os endereços de email de seu Consumidor de Dados selecionando "+ Adicionar Destinatário".

   

10. Selecione Continuar.

11. Se você tiver selecionado o tipo de compartilhamento de instantâneo, poderá configurar a agenda de instantâneo para fornecer atualizações de seus dados para o consumidor de dados.

    

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

13. Selecione Continuar.

14. Na guia Examinar + Criar, examine o Conteúdo do Pacote, Configurações, Destinatários e Configuraçõ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 Data Share:

   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 Data Share:

   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 você ainda não tiver os dados que gostaria de compartilhar, siga estas etapas para criar uma conta de armazenamento. Se você já tiver um armazenamento, pule para a etapa 2.

   1. Execute o comando New-AzStorageAccount para criar uma conta do Armazenamento 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 do Armazenamento do Azure que conterá 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 do Armazenamento do Azure.

2. Execute o comando New-AzDataShare para criar o Data Share:

   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 o compartilhamento. A recorrência pode ser diária, por hora ou em um horário específico.

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

O Azure Data Share agora foi criado e o destinatário de seu Compartilhamento de Dados agora está pronto para aceitar seu convite.

Limpar os recursos

Quando o recurso não for mais necessário, acesse a página Visão Geral do Data Share e selecione Excluir para removê-lo.

Próximas etapas

Neste tutorial, você aprendeu a criar um Azure Data Share e a convidar destinatários. Para saber mais sobre como um Consumidor de Dados pode aceitar e receber um compartilhamento de dados, prossiga para o tutorial Aceitar e receber dados.

Tutorial: Aceitar e receber dados usando o Azure Data Share