Zelfstudie: Gegevens accepteren en ontvangen met behulp van Azure Data Share

In deze zelfstudie leert u hoe u een uitnodiging voor een gegevensshare accepteert met behulp van Azure Data Share. U leert hoe u gegevens ontvangt die met u worden gedeeld en hoe u een regelmatig vernieuwingsinterval inschakelt om ervoor te zorgen dat u altijd de meest recente momentopname hebt van de gegevens die met u worden gedeeld.

• Een Azure Data Share-uitnodiging accepteren
• Maak een Azure Data Share-account
• Geef een doel op voor de gegevens
• Maak een abonnement voor uw gegevensshare voor geplande vernieuwing

Vereisten

Voordat u een uitnodiging voor een gegevensshare kunt accepteren, moet u enkele Azure-resources maken, die hieronder worden vermeld.

Zorg ervoor dat alle vereisten zijn voltooid voordat u een uitnodiging voor een gegevensshare accepteert.

• Azure-abonnement: Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.
• Een Data Share-uitnodiging: een uitnodiging van Microsoft Azure met een onderwerp met de titel 'Azure Data Share-uitnodiging van yourdataprovider@domain.com'.
• Registreer de Microsoft.DataShare-resourceprovider in het Azure-abonnement waar u een Data Share-resource en het Azure-abonnement maakt waar uw Azure-doelgegevensarchieven zich bevinden.

Gegevens ontvangen in een opslagaccount

• Een Azure Storage-account: als u er nog geen hebt, kunt u een Azure Storage-account maken.
• Machtiging om naar het opslagaccount te schrijven, aanwezig in Microsoft.Storage/storageAccounts/write. Deze machtiging bestaat in de rol Inzender voor opslagaccounts.
• Machtiging om roltoewijzing toe te voegen aan het opslagaccount, aanwezig in Microsoft.Authorization/role assignments/write. Deze machtiging maakt onderdeel uit van de rol Eigenaar.

Gegevens ontvangen in een op SQL gebaseerd doel

Als u ervoor kiest om gegevens te ontvangen in Azure SQL Database of Azure Synapse Analytics, vindt u hieronder de lijst met vereisten.

Vereisten voor het ontvangen van gegevens in Azure SQL Database of Azure Synapse Analytics (voorheen Azure SQL DW)

• Een instantie van Azure SQL Database of Azure Synapse Analytics (voorheen Azure SQL DW).
• Machtiging om naar databases op de SQL-server te schrijven, aanwezig in Microsoft.Sql/servers/databases/write. Deze machtiging maakt onderdeel uit van de rol Inzender.
• Microsoft Entra Beheer van de SQL-server
• Toegang tot SQL Server-firewall. U kunt dit doen door de volgende stappen uit te voeren:
  1. Ga in SQL Server in de Azure-portal naar Firewalls en virtuele netwerken
  2. Selecteer Ja als u Azure-services en -resources toegang wilt geven tot deze server.
  3. Selecteer +CLIENT-IP toevoegen. Het IP-adres van de client kan worden gewijzigd. Dit proces moet mogelijk worden herhaald wanneer u de volgende keer SQL-gegevens deelt vanuit De Azure-portal. U kunt ook een IP-bereik toevoegen.
  4. Selecteer Opslaan.

Vereisten voor het ontvangen van gegevens in de SQL-pool in Azure Synapse Analytics (werkruimte)

• Een toegewezen SQL-pool in de Synapse Analytics-werkruimte. Het ontvangen van gegevens in een serverloze SQL-pool wordt momenteel niet ondersteund.

• Machtiging om te schrijven naar de SQL-pool in de Synapse-werkruimte, die zich in Microsoft.Synapse/workspaces/sqlPools/write bevindt. Deze machtiging maakt onderdeel uit van de rol Inzender.

• Machtiging voor de beheerde identiteit van de Data Share-resource voor toegang tot de SQL-pool in de Synapse-werkruimte. U kunt dit doen via de volgende stappen:

  1. Ga in Azure Portal naar de Synapse-werkruimte. Selecteer Microsoft Entra-beheerder in de linkernavigatiebalk en stel uzelf in als Microsoft Entra-beheerder.

  2. Open Synapse Studio, selecteer Beheren in de linkernavigatiebalk. Selecteer Toegangsbeheer onder Beveiliging. Wijs uzelf de rol van SQL-beheerder of werkruimtebeheerder toe.

  3. Selecteer in Synapse Studio de optie Beheren in de linkernavigatiebalk. Voer in de SQL-pool het volgende script uit om de beheerde identiteit van de Data Share-resource toe te voegen als een 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>";
     

     De <share_acc_name> is de naam van uw Data Share-resource. Als u nog geen Data Share-resource hebt gemaakt, kunt u later terugkeren naar deze vereiste.

• Toegang tot de firewall van de Synapse-werkruimte. U kunt dit doen via de volgende stappen:

  1. Ga in Azure Portal naar de Synapse-werkruimte. Selecteer Firewalls in de linkernavigatiebalk.
  2. Selecteer AAN om Azure-services en -resources toegang te geven tot deze werkruimte.
  3. Selecteer +CLIENT-IP toevoegen. Het IP-adres van de client kan worden gewijzigd. Dit proces moet mogelijk worden herhaald wanneer u de volgende keer SQL-gegevens deelt vanuit De Azure-portal. U kunt ook een IP-bereik toevoegen.
  4. Selecteer Opslaan.

Gegevens ontvangen in een Azure Data Explorer-cluster:

• Een Azure Data Explorer-cluster in hetzelfde Azure-datacenter als het Data Explorer-cluster van de gegevensprovider: Als u er nog geen hebt, kunt u een Azure Data Explorer-cluster maken. Als u het Azure-datacenter van het cluster van de gegevensprovider niet weet, kunt u het cluster later in het proces maken.
• Machtiging om naar het Azure Data Explorer-cluster te schrijven, aanwezig in Microsoft.Kusto/clusters/write. Deze machtiging maakt onderdeel uit van de rol Inzender.

Meld u aan bij Azure Portal

Meld u aan bij het Azure-portaal.

Uitnodiging openen

Portal

1. U kunt de uitnodiging openen vanuit uw e-mail of rechtstreeks vanuit de Azure-portal.

   Als u de uitnodiging wilt openen vanuit uw e-mail, gaat u in uw Postvak IN naar de uitnodiging van de gegevensprovider. De uitnodiging is van Microsoft Azure en heeft de titel Azure Data Share-uitnodiging van yourdataprovider@domain.com. Selecteer uitnodiging weergeven om uw uitnodiging in Azure te bekijken.

   Als u de uitnodiging rechtstreeks vanuit de Azure-portal wilt openen, gaat u in de Azure-portal naar Data Share-uitnodigingen. Met deze actie kunt u de lijst met Data Share-uitnodigingen openen.

   Als u een gastgebruiker van een tenant bent, wordt u gevraagd uw e-mailadres voor de tenant te verifiëren voordat u de Data Share-uitnodiging voor de eerste keer bekijkt. Na verificatie is het 12 maanden geldig.

   

2. Selecteer de uitnodiging die u wilt weergeven.

Azure-CLI

Bereid uw Azure CLI-omgeving voor en bekijk vervolgens uw uitnodigingen.

Begin door de omgeving voor te bereiden op de Azure CLI:

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie quickstart voor Bash in Azure Cloud Shell voor meer informatie.

  

• Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.

  • Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.

Voer de opdracht az datashare consumer-invitation list-invitation uit om uw huidige uitnodigingen te bekijken:

az datashare consumer consumer-invitation list-invitation

Kopieer uw uitnodigings-id om deze in de volgende sectie te gebruiken.

Powershell

Begin met het voorbereiden van uw omgeving voor PowerShell. U kunt PowerShell-opdrachten lokaal uitvoeren of de Bash-omgeving gebruiken in De Azure Cloud Shell.

• Als u ervoor kiest om Azure PowerShell lokaal te gebruiken:
  • Installeer de nieuwste versie van de Az PowerShell-module.
  • Maak verbinding met uw Azure-account met de cmdlet Connect-AzAccount.
• Als u ervoor kiest om Azure Cloud Shell te gebruiken:
  • Raadpleeg Overzicht van Azure Cloud Shell voor meer informatie.

1. Gebruik de opdracht Verbinding maken-AzAccount om verbinding te maken met uw Azure-account.

   Connect-AzAccount
   

2. Voer de opdracht Set-AzContext uit om het juiste abonnement in te stellen als u meerdere abonnementen hebt.

   Set-AzContext [SubscriptionID/SubscriptionName]
   

3. Voer de opdracht Get-AzDataShareReceivedInvitation uit om uw huidige uitnodigingen te bekijken:

   Get-AzDataShareReceivedInvitation
   

Kopieer uw uitnodigings-id om deze in de volgende sectie te gebruiken.

Uitnodiging accepteren

Portal

1. Zorg ervoor dat u alle velden controleert, met inbegrip van de Gebruiksvoorwaarden. Als u akkoord gaat met de gebruiksvoorwaarden, moet u het vakje inschakelen om aan te geven dat u akkoord gaat.

   

2. Selecteer onder Data Share-doelaccount het abonnement en de resourcegroep waarin u de Data Share-gegevens wilt implementeren.

   Selecteer voor het veld Data Share-account de optie Nieuwe maken als u geen bestaand Data Share-account hebt. Anders selecteert u een bestaand Data Share-account waarin u de informatie uit uw gegevensshare wilt accepteren.

   Voor het veld Naam van ontvangen share kunt u de standaardwaarde laten die is opgegeven door de gegevens opgeven of een nieuwe naam opgeven voor de ontvangen share.

   Zodra u akkoord bent gegaan met de gebruiksvoorwaarden en een Data Share-account hebt opgegeven voor het beheren van de ontvangen share, selecteert u Accepteren en configureren. Er wordt een shareabonnement gemaakt.

   

   Met deze actie gaat u naar de ontvangen share in uw Data Share-account.

   Als u de uitnodiging niet wilt accepteren, selecteert u Weigeren.

Azure-CLI

Gebruik de opdracht az datashare share-subscription create om de gegevensshare te maken.

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"

Powershell

Gebruik de opdracht New-AzDataShareSubscription om de gegevensshare te maken. De InvitationId is de id die u hebt verzameld uit de vorige stap.

New-AzDataShareSubscription -ResourceGroupName <String> -AccountName <String> -Name <String> -InvitationId <String>

Ontvangen share configureren

Portal

Volg de onderstaande stappen om te configureren waar u gegevens wilt ontvangen.

1. Selecteer het tabblad Gegevenssets. Schakel het selectievakje in naast de gegevensset waaraan u een bestemming wilt toewijzen. Selecteer + Toewijzen aan doel om een doelgegevensarchief te kiezen.

   

2. Selecteer het type doelgegevensarchief waarin u de gegevens wilt opslaan. Alle gegevensbestanden of tabellen in het doelgegevensarchief met hetzelfde pad en dezelfde naam worden overschreven. Als u gegevens ontvangt in Azure SQL Database of Azure Synapse Analytics (voorheen Azure SQL DW), schakelt u het selectievakje Gegevensshare toestaan om het bovenstaande script gebruiker maken namens mij uit te voeren.

   Selecteer voor in-place delen een gegevensarchief op de opgegeven locatie. De locatie is het Azure-datacenter waar het brongegevensarchief van de gegevensprovider zich bevindt. Zodra de gegevensset is toegewezen, kunt u de koppeling in het doelpad volgen om toegang te krijgen tot de gegevens.

   

3. Als de gegevensprovider voor het delen van momentopnamen een schema voor momentopnamen heeft gemaakt om de gegevens regelmatig bij te werken, kunt u ook het schema voor momentopnamen inschakelen door het tabblad Planning van momentopnamen in te schakelen. Schakel het selectievakje naast het schema voor momentopnamen in en selecteer + Inschakelen. De eerste geplande momentopname begint binnen één minuut van de planningstijd en volgende momentopnamen worden binnen enkele seconden van de geplande tijd gestart.

   

   De metagegevens van gekopieerde bestanden blijven na elke uitvoering niet behouden. Dit is standaard.

Azure-CLI

Gebruik deze opdrachten om te configureren waar u gegevens wilt ontvangen.

1. Voer de opdracht az datashare consumer-source-data-set list uit om de gegevensset-id op te halen:

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

2. Als u een opslagaccount nodig hebt, voert u de opdracht az storage account create uit om een opslagaccount te maken voor deze Data Share:

   az storage account create --resource-group "share-rg" --name "FabrikamDataShareStorageAccount" \
   

3. Gebruik de opdracht az storage account show om de opslagaccount-id op te halen:

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

4. Gebruik de volgende opdracht om de account-principal-id op te halen:

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

5. Gebruik de opdracht az role assignment create om een roltoewijzing te maken voor de account-principal met behulp van de account-principal-id en uw opslagaccount-id:

   az role assignment create --role "Contributor" \
     --assignee-object-id 6789abcd-ef01-2345-6789-abcdef012345 
     --assignee-principal-type ServicePrincipal --scope "your\storage\account\id\path"
   

6. Maak een variabele voor de toewijzing op basis van de gegevensset-id uit stap 1:

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

7. Gebruik de opdracht az datashare data-set-mapping create om de toewijzing van de gegevensset te maken:

   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
   

8. Voer de synchronisatieopdracht az datashare share-subscription uit om de synchronisatie van gegevenssets te starten.

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

   Voer de opdracht az datashare share-subscription list-synchronization uit om een lijst met uw synchronisaties weer te geven:

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

   Gebruik de opdracht az datashare share-subscription list-source-share-synchronization-setting om synchronisatie-instellingen te zien die zijn ingesteld op uw share.

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

Powershell

Gebruik deze opdrachten om te configureren waar u gegevens wilt ontvangen.

1. Voer de opdracht Get-AzDataShareSourceDataSet uit om de gegevensset-id op te halen:

   Get-AzDataShareSourceDataSet -ResourceGroupName <String> -AccountName <String> -ShareSubscriptionName <String>
   

2. Als u nog geen locatie hebt waar u de gedeelde gegevens wilt opslaan, kunt u deze stappen volgen om een opslagaccount te maken. Als u al opslag hebt, kunt u doorgaan met de volgende stappen.

   1. Voer de opdracht New-AzStorageAccount uit om een Azure Storage-account te maken:

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

   2. Voer de opdracht New-AzStorageContainer uit om een container te maken in uw nieuwe Azure Storage-account waarin uw gegevens worden opgeslagen:

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

   3. Voer de opdracht Set-AzStorageBlobContent uit om een bestand te uploaden. In het volgende voorbeeld wordt textfile.csv vanuit de map D:\testFiles in het lokale geheugen geüpload naar de container die u hebt gemaakt.

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

   Volg deze Handleiding voor Azure Storage powershell voor meer informatie over het werken met Azure Storage in PowerShell.

3. Gebruik de opdracht Get-AzStorageAccount om de id van het opslagaccount op te halen:

   Get-AzStorageAccount -ResourceGroupName <String> -Name <String>
   

4. Gebruik de gegevensset-id uit de eerste stap en voer vervolgens de opdracht New-AzDataShareDataSetMapping uit om de toewijzing van de gegevensset te maken:

   New-AzDataShareDataSetMapping -ResourceGroupName <String> -AccountName <String> -ShareSubscriptionName <String> -Name <String> -StorageAccountResourceId <String> -DataSetId <String> -Container <String>
   

5. Voer de opdracht Start-AzDataShareSubscriptionSynchronization uit om de synchronisatie van gegevenssets te starten.

   Start-AzDataShareSubscriptionSynchronization -ResourceGroupName <String> -AccountName <String> -ShareSubscriptionName <String> -SynchronizationMode <String>
   

   Voer de opdracht Get-AzDataShareSubscriptionSynchronization uit om een lijst met uw synchronisaties weer te geven:

   Get-AzDataShareSubscriptionSynchronization -ResourceGroupName <String> -AccountName <String> -ShareSubscriptionName <String>
   

   Gebruik de opdracht Get-AzDataShareSubscriptionSynchronizationDetail om synchronisatie-instellingen te zien die zijn ingesteld op uw share.

   Get-AzDataShareSubscriptionSynchronizationDetail -ResourceGroupName <String> -AccountName <String> -ShareSubscriptionName <String> -SynchronizationId <String>
   

Een momentopname activeren

Portal

Deze stappen zijn alleen van toepassing bij delen op basis van momentopnamen.

1. U kunt een momentopname activeren door Momentopname activeren te selecteren op het tabblad Details. Hier kunt u een volledige of incrementele momentopname van uw gegevens activeren. Als dit de eerste keer is dat u gegevens van uw gegevensprovider ontvangt, selecteert u volledig kopiëren.

   

2. Wanneer de status van de laatste uitvoering Geslaagd is, gaat u naar het doelgegevensarchief om de ontvangen gegevens te bekijken. Selecteer Gegevenssets en selecteer de koppeling in het doelpad.

   

Azure-CLI

Voer de opdracht az datashare trigger create uit om een momentopname te activeren:

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"

Powershell

Deze stappen zijn alleen van toepassing bij delen op basis van momentopnamen.

Voer de opdracht New-AzDataShareTrigger uit om een momentopname te activeren:

New-AzDataShareTrigger -ResourceGroupName <String> -AccountName <String> -Name <String> -RecurrenceInterval <String> -SynchronizationTime <DateTime>

Historie weergeven

Deze stap geldt alleen voor delen op basis van momentopnamen. Als u de geschiedenis van uw momentopnamen wilt bekijken, selecteert u het tabblad Geschiedenis . Hier vindt u de geschiedenis van alle momentopnamen die de afgelopen 30 dagen zijn gegenereerd.

Resources opschonen

Wanneer de resource niet meer nodig is, gaat u naar de overzichtspagina van De gegevensshare en selecteert u Verwijderen om deze te verwijderen.

Volgende stappen

In deze zelfstudie hebt u geleerd hoe u een Azure-gegevensshare accepteert en ontvangt. Voor meer informatie over Azure Data Share-concepten gaat u naar Azure Data Share-terminologie.

Azure Data Share-concepten