Tutorial: Aceitar e receber dados – Azure Data Share

Neste tutorial, você aprenderá a aceitar um convite de compartilhamento de dados usando o Azure Data Share. Você aprenderá a receber dados compartilhados com você e como habilitar um intervalo de atualização regular para garantir que você sempre tenha o instantâneo mais recente dos dados que estão sendo compartilhados com você.

Como aceitar um convite do Azure Data Share
Criar uma conta do Azure Data Share
Especificar um destino para seus dados
Criar uma assinatura para seu compartilhamento de dados para a atualização agendada

Pré-requisitos

Antes de aceitar um convite de compartilhamento de dados, você deve criar alguns recursos do Azure, que estão listados abaixo.

Verifique se todos os pré-requisitos estão concluídos antes de aceitar um convite de compartilhamento de dados.

Assinatura do Azure: se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
Um convite do Data Share: um convite do Microsoft Azure com o assunto intitulado "Convite do Azure Data Share de yourdataprovider@domain.com".
Registre o provedor de recursos Microsoft.DataShare na assinatura do Azure em que você criará um recurso do Data Share e a assinatura do Azure em que os armazenamentos de dados do Azure de destino estão localizados.

Receber dados em uma conta de armazenamento

Uma conta de Armazenamento do Azure: se você ainda 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 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.

Receber dados em um destino baseado em SQL

Se você optar por receber dados no Banco de Dados SQL do Azure, o Azure Synapse Analytics, abaixo está a lista de pré-requisitos.

Pré-requisitos para receber dados no Banco de Dados SQL do Azure ou no 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).
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 .
Microsoft Entra Admin do servidor SQL
Acesso ao Firewall do SQL Server. Isso pode ser feito por meio das seguintes etapas:
1. No SQL Server, no portal do Azure, navegue até Firewalls e redes virtuais
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. Clique em Salvar.

Pré-requisitos para receber dados no pool de SQL do Azure Synapse Analytics (workspace)

Um pool de SQL dedicado do Azure Synapse Analytics (workspace). No momento, não há suporte para o recebimento de dados no 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 Data Share acesse o pool de SQL no espaço de trabalho do Synapse. Isso pode ser feito por meio das seguintes etapas:
1. No portal do Azure, navegue até o workspace do Synapse. Selecione o administrador do Microsoft Entra 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 o controle de acesso em Segurança. Atribua a si mesmo a função de administrador do SQL ou administrador do workspace .
3. No Synapse Studio, selecione Desenvolver na navegação à esquerda. Execute o script a seguir no SQL pool para adicionar a Identidade Gerenciada do recurso Data Share como 'db_datareader, db_datawriter, db_ddladmin'.
```
create user "<share_acc_name>" from external provider; 
exec sp_addrolemember db_datareader, "<share_acc_name>"; 
exec sp_addrolemember db_datawriter, "<share_acc_name>"; 
exec sp_addrolemember db_ddladmin, "<share_acc_name>";
```
  O <share_acc_name> é o nome do recurso do Data Share. Se você ainda não criou um recurso do Data Share, poderá voltar para esse pré-requisito mais tarde.
Acesso ao Firewall do workspace do Synapse. Isso pode ser feito por meio das seguintes etapas:
1. No portal do Azure, navegue até o workspace do Synapse. Selecione Firewalls na navegação à esquerda.
2. Selecione ON para permitir que os serviços e recursos do Azure acessem esse workspace.
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. Clique em Salvar.

Receber dados em um cluster do Azure Data Explorer:

Um cluster do Azure Data Explorer no mesmo data center do Azure que o cluster do Data Explorer do provedor de dados: se você ainda não tiver um, poderá criar um cluster do Azure Data Explorer. Se você não souber o data center do Azure do cluster do provedor de dados, poderá criar o cluster mais adiante no processo.
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.

Convite aberto

Você pode abrir o convite por email ou diretamente do portal do Azure.

Para abrir o convite por email, verifique sua caixa de entrada em busca de um convite do seu provedor de dados. O convite é do Microsoft Azure, intitulado convite do Azure Data Share.yourdataprovider@domain.com Selecione em Exibir convite para ver seu convite no Azure.

Para abrir o convite diretamente do portal do Azure, pesquise convites de compartilhamento de dados no portal do Azure. Essa ação leva você à lista de convites do Data Share.

Se você for um usuário convidado de um locatário, precisará confirmar seu endereço de email para o locatário antes de ver o convite do Data Share pela primeira vez. Depois de confirmado, ele será válido por 12 meses.
Selecione o convite que você deseja exibir.

Prepare seu ambiente da CLI do Azure e exiba seus convites.

Comece preparando seu ambiente para a CLI do Azure:

Utilize o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.
Se você preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se você estiver executando 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 você estiver usando uma instalação local, entre na CLI do Azure usando o comando az login . Para concluir o processo de autenticação, siga as etapas exibidas em seu terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando 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 e gerenciar extensões com a CLI do Azure.
- Execute o comando az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.

Execute o comando az datashare consumer-invitation list-invitation para ver seus convites atuais:

az datashare consumer-invitation list-invitation

Copie sua ID de convite para uso na próxima seção.

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 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 o comando Connect-AzAccount para se conectar à sua conta do Azure.
```
Connect-AzAccount
```
Execute o comando Set-AzContext para definir a assinatura correta, se você tiver várias assinaturas.
```
Set-AzContext [SubscriptionID/SubscriptionName]
```
Execute o comando Get-AzDataShareReceivedInvitation para ver seus convites atuais:
```
Get-AzDataShareReceivedInvitation
```

Copie sua ID de convite para uso na próxima seção.

Aceitar convite

Verifique se todos os campos foram revisados, incluindo os Termos de Uso. Se você concordar com os termos de uso, será necessário marcar a caixa para indicar que concorda.
Em Conta do Data Share de Destino, selecione a assinatura e o Grupo de Recursos em que você vai implantar seu Data Share.

Para o campo Conta de Compartilhamento de Dados , selecione Criar novo se você não tiver uma conta do Data Share existente. Caso contrário, selecione uma conta existente do Data Share na qual você gostaria de aceitar seu compartilhamento de dados.

Para o campo Nome do Compartilhamento Recebido , você pode deixar o padrão especificado pelos dados fornecidos ou especificar um novo nome para o compartilhamento recebido.

Depois de concordar com os termos de uso e especificar uma conta do Data Share para gerenciar o compartilhamento recebido, selecione Aceitar e configurar. Uma assinatura de compartilhamento será criada.

Essa ação levará você para o compartilhamento recebido na sua conta do Data Share.

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

Use o comando az datashare share-subscription create para criar o Data Share.

az datashare share-subscription create --resource-group share-rg \
  --name "fabrikamsolutions" --account-name FabrikamDataShareAccount \
  --invitation-id 89abcdef-0123-4567-89ab-cdef01234567 \
  --source-share-location "East US 2"

Use o comando New-AzDataShareSubscription para criar o Data Share. O ID de Convite será o ID coletado da etapa anterior.

New-AzDataShareSubscription -ResourceGroupName share-rg -AccountName FabrikamDataShareAccount -Name "Fabrikam Solutions" -InvitationId "89abcdef-0123-4567-89ab-cdef01234567"

Siga as etapas abaixo para configurar onde você deseja receber dados.

Selecione a guia Conjuntos de dados . Marque a caixa ao lado do conjunto de dados ao qual você gostaria de atribuir um destino. Selecione + Mapear para o destino para escolher um armazenamento de dados de destino.
Selecione um tipo de armazenamento de dados de destino no qual você gostaria que os dados caíssem. Todos os arquivos de dados ou tabelas no armazenamento de dados de destino com o mesmo caminho e nome serão substituídos. Se você estiver recebendo dados no Banco de Dados SQL do Azure ou no Azure Synapse Analytics (antigo SQL DW do Azure), marque a caixa de seleção Permitir que o Data Share execute o script "criar usuário" acima em meu nome.

Para compartilhar no local, selecione um datastore na localização especificada. O Local é o data center do Azure no qual o armazenamento de dados de origem do provedor de dados está localizado. Depois que o conjunto de dados for mapeado, você poderá seguir o link no Caminho de Destino para acessar os dados.
Para compartilhamento baseado em instantâneo, se o provedor de dados tiver criado um agendamento de instantâneo para fornecer atualização regular aos dados, você também poderá habilitar o agendamento de instantâneos selecionando a guia Agendamento de Instantâneos . Marque a caixa ao lado do agendamento do instantâneo e selecione + Habilitar. O primeiro instantâneo agendado começará dentro de um minuto após a hora agendada e os instantâneos posteriores começarão em segundos da hora agendada.

Os metadados de arquivos copiados não são mantidos após cada execução. Isso ocorre por design.

Use esses comandos para configurar onde você deseja receber dados.

Execute o comando az datashare consumer-source-data-set list para obter a ID do conjunto de dados:

az datashare consumer-source-data-set list --resource-group "share-rg" \
 --account-name "FabrikamDataShareAccount" \
   --share-subscription-name "fabrikamsolutions" \

Se você precisar de uma conta de armazenamento, execute o comando az storage account create para criar uma conta de armazenamento para este Data Share:
```
az storage account create --resource-group "share-rg" --name "FabrikamDataShareStorageAccount" \
```

Use o comando az storage account show para obter a ID da conta de armazenamento:

az storage account show --resource-group "share-rg" --name "FabrikamDataShareStorageAccount" \
 --query "id"

Use o seguinte comando para obter a ID do principal da conta:

az datashare account show --resource-group "share-rg" --name "FabrikamDataShareAccount" \
  --query "identity.principalId"

Use o comando az role assignment create para criar uma atribuição de função para a entidade de conta usando a ID da entidade de conta e a ID da conta de armazenamento:

az role assignment create --role "Contributor" \
  --assignee-object-id aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 
  --assignee-principal-type ServicePrincipal --scope "your\storage\account\id\path"

Crie uma variável para o mapeamento com base na ID do conjunto de dados da etapa 1:

$mapping='{\"data_set_id\":\"' + $dataset_id + '\",\"container_name\":\"newcontainer\",
  \"storage_account_name\":\"datashareconsumersa\",\"kind\":\"BlobFolder\",\"prefix\":\"consumer\"}'

Use o comando az datashare data-set-mapping create para criar o mapeamento do conjunto de dados:

az datashare data-set-mapping create --account-name "FabrikamDataShareAccount" \
 --data-set-mapping-name "datasetmapping" --resource-group "share-rg" \
 --share-subscription-name "fabrikamsolutions" --blob-folder-data-set-mapping $mapping

Execute o comando az datashare share-subscription synchronize para iniciar a sincronização do conjunto de dados.

az datashare share-subscription synchronize \
  --resource-group "share-rg" --account-name "FabrikamDataShareAccount"  \
  --name "Fabrikam Solutions" --synchronization-mode "Incremental" \

Execute o comando az datashare share-subscription list-synchronization para ver uma lista de suas sincronizações:

az datashare share-subscription list-synchronization \
  --resource-group "share-rg" --account-name "FabrikamDataShareAccount" \
  --share-subscription-name "Fabrikam Solutions" \

Use o comando az datashare share-subscription list-source-share-synchronization-setting para ver as configurações de sincronização definidas no compartilhamento.

az datashare share-subscription list-source-share-synchronization-setting \
  --resource-group "share-rg" --account-name "FabrikamDataShareAccount" \
  --share-subscription-name "Fabrikam Solutions"

Use esses comandos para configurar onde você deseja receber dados.

Execute o comando Get-AzDataShareSourceDataSet para obter a ID do conjunto de dados:

Get-AzDataShareSourceDataSet -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions"

Se você ainda não tiver um local em que gostaria de armazenar os dados compartilhados, siga estas etapas para criar uma conta de armazenamento. Se você já tiver armazenamento, poderá pular para as próximas etapas.
1. Execute o comando New-AzStorageAccount para criar uma conta de Armazenamento do Azure:
```
$storageAccount = New-AzStorageAccount -ResourceGroupName "share-rg" -AccountName FabrikamStorageAccount -Location "East US 2" -SkuName Standard_GRS

$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 = "StorageContainer"

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.

Use o comando Get-AzStorageAccount para obter a ID da conta de armazenamento:

Get-AzStorageAccount -ResourceGroupName "share-rg" -Name FabrikamStorageAccount

Use a ID do conjunto de dados da primeira etapa e execute o comando New-AzDataShareDataSetMapping para criar o mapeamento do conjunto de dados:

New-AzDataShareDataSetMapping -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -Name "Fabrikam Solutions" -StorageAccountResourceId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"  -DataSetId "0123abcd-ef01-2345-6789-abcdef012345"  -Container "StorageContainer"

Execute o comando Start-AzDataShareSubscriptionSynchronization para iniciar a sincronização do conjunto de dados.

Start-AzDataShareSubscriptionSynchronization -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -SynchronizationMode "Incremental"

Execute o comando Get-AzDataShareSubscriptionSynchronization para ver uma lista de suas sincronizações:

Get-AzDataShareSubscriptionSynchronization -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions"

Use o comando Get-AzDataShareSubscriptionSynchronizationDetail para ver as configurações de sincronização definidas em seu compartilhamento.

Get-AzDataShareSubscriptionSynchronizationDetail -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -SynchronizationId "a6ee5c8d-0ce0-485e-b2f2-966b187dc6c7"

Disparar um instantâneo

Essas etapas se aplicam apenas ao compartilhamento baseado em instantâneo.

Você pode disparar um instantâneo selecionando a guia Detalhes seguida por Disparar instantâneo. Aqui, você pode disparar um instantâneo completo ou incremental de seus dados. Se for a primeira vez que você recebe dados do seu provedor de dados, selecione a cópia completa.
Quando o status da última execução for bem-sucedido, vá para o armazenamento de dados de destino para exibir os dados recebidos. Selecione Conjuntos de Dados e selecione o link no Caminho de Destino.

Execute o comando az datashare trigger create para disparar um instantâneo:

az datashare trigger create --account-name "FabrikamDataShareAccount" --resource-group "share-rg" --share-subscription-name "Fabrikam Solutions" --scheduled-trigger recurrence-interval="Day" synchronization-mode="Incremental" synchronization-time="2018-11-14T04:47:52.9614956Z" --name "Trigger1"

Essas etapas se aplicam apenas ao compartilhamento baseado em instantâneo.

Execute o comando New-AzDataShareTrigger para disparar uma captura:

New-AzDataShareTrigger -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -Name "Fabrikam Solutions" -RecurrenceInterval "Day" -SynchronizationTime "2018-11-14T04:47:52.9614956Z"

Exibir histórico

Esta etapa só se aplica ao compartilhamento baseado em instantâneo. Para exibir o histórico de seus instantâneos, selecione a guia Histórico . Aqui você encontrará o histórico de todos os instantâneos que foram gerados nos últimos 30 dias.

Limpar os 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óximas etapas

Neste tutorial, você aprendeu a aceitar e receber um Azure Data Share. Para saber mais sobre os conceitos do Azure Data Share, continue para a Terminologia do Azure Data Share.

Conceitos do Azure Data Share

Comentários

Esta página foi útil?

Last updated on 2025-10-08