Zelfstudie: Gegevens accepteren en ontvangen - Azure Data Share

Artikel
11/20/2021
12 minuten om te lezen

In deze zelfstudie leert u hoe u een uitnodiging voor gegevensshares met behulp van Azure Data Share accepteert. U leert hoe u gegevens ontvangt die met u worden gedeeld en hoe u een regelmatig vernieuwingsinterval kunt inschakelen 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 gegevens delen kunt accepteren, moet u een aantal Azure-resources maken. Deze worden hieronder vermeld.

Zorg ervoor dat alle vereisten zijn voltooid voordat u een uitnodiging voor het delen van gegevens accepteert.

Azure-abonnement: Als u nog geen abonnement op Azure hebt, maak dan een gratis account aan 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 waarin u een Data Share-resource gaat maken, en in het Azure-abonnement waarin uw Azure-doelgegevensarchieven zich bevinden.

Gegevens ontvangen in een opslagaccount

Een Azure Storage-account: Hier kunt u een Azure Storage-account maken als u nog geen account hebt.
Machtiging om naar het opslagaccount te schrijven, aanwezig in Microsoft.Storage/storageAccounts/write. Deze machtiging bestaat in de rol Storage blobgegevens inzender.
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.
Azure Active Directory beheerder van de SQL server
Toegang tot SQL Server-firewall. U kunt dit doen via de volgende stappen:
1. Ga in SQL Server in de Azure-portal naar Firewalls en virtuele netwerken
2. Selecteer Ja bij Azure-services en -resources toegang geven tot deze server.
3. Selecteer +IP van client toevoegen. Het IP-adres van de client kan worden gewijzigd. Dit proces moet mogelijk worden herhaald de volgende keer dat u 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 SQL Active Directory-beheerder in de linkernavigatiebalk en stel uzelf in als de Azure Active Directory-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>";
```
  U ziet dat <share_acc_name> de naam is van uw Data Share-resource. Als u nog geen Data Share-resource hebt gemaakt, kunt u later aan deze vereiste voldoen.
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 bij Azure-services en -resources toegang geven tot deze werkruimte.
3. Selecteer +IP van client toevoegen. Het IP-adres van de client kan worden gewijzigd. Dit proces moet mogelijk worden herhaald de volgende keer dat u 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: Hier kunt u een Azure Data Explorer-account maken als u nog geen account hebt. 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 de Azure-portal.

Uitnodiging openen

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 controleren voordat u de uitnodiging Data Share eerste keer bekijkt. Na verificatie is deze 12 maanden geldig.
Selecteer de uitnodiging die u wilt weergeven.

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.
Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren.
- 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 de 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 uit om uw huidige uitnodigingen te bekijken:

az datashare consumer invitation list --subscription 11111111-1111-1111-1111-111111111111

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

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

Als u ervoor kiest om Azure PowerShell lokaal te gebruiken:
- Installeer de 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.

Gebruik de Verbinding maken-AzAccount om verbinding te maken met uw Azure-account.
```
Connect-AzAccount
```
Voer de opdracht Set-AzContext uit om het juiste abonnement in te stellen als u meerdere abonnementen hebt.
```
Set-AzContext [SubscriptionID/SubscriptionName]
```
Voer de opdracht Get-AzDataShareReceivedInvitation uit om uw huidige uitnodigingen te zien:
```
Get-AzDataShareReceivedInvitation
```

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

Uitnodiging accepteren

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.
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.

In het veld Ontvangen sharenaam kunt u de standaardwaarde laten staan die is opgegeven door de gegevensprovider. U kunt er ook voor kiezen een nieuwe naam op te geven 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.

Gebruik de opdracht az datashare consumer share-subscription create om de Data Share te maken.

az datashare consumer share-subscription create --resource-group share-rg \
  --name "Fabrikam Solutions" --account-name FabrikamDataShareAccount \
  --invitation-id 89abcdef-0123-4567-89ab-cdef01234567 \
  --source-share-location "East US 2" --subscription 11111111-1111-1111-1111-111111111111

Gebruik de opdracht New-AzDataShareSubscription om de Data Share. De InvitationId is de id die u in de vorige stap hebt verzameld.

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

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

Selecteer het tabblad Gegevenssets. Schakel het selectievakje in van de gegevensset waaraan u een bestemming wilt toewijzen. Selecteer + Toewijzen aan doel om een doelgegevensarchief te kiezen.
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), moet u het selectievakje Toestaan dat Data Share het bovenstaande script 'gebruiker maken' namens mij uitvoeren in.

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.
Als u wilt delen met behulp van momentopnamen, en de gegevensprovider een schema heeft opgesteld voor het maken van momentopnamen om de gegevens regelmatig bij te werken, kunt u het schema voor het maken van momentopnamen ook inschakelen door het tabblad Schema voor momentopnamen te selecteren. Schakel het selectievakje naast het schema voor momentopnamen in en selecteer + Inschakelen. Houd er rekening mee dat de eerste geplande momentopname binnen één minuut na de planningstijd start en dat volgende momentopnamen binnen enkele seconden na de geplande tijd starten.

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

Voer de opdracht az datashare consumer share-subscription list-source-dataset uit om de gegevensset-id op te halen:

az datashare consumer share-subscription list-source-dataset \
  --resource-group "share-rg" --account-name "FabrikamDataShareAccount" \
  --share-subscription-name "Fabrikam Solutions" \
  --subscription 11111111-1111-1111-1111-111111111111 --query "[0].dataSetId"

Voer de opdracht az storage account create uit om een opslagaccount voor deze Data Share te maken:

az storage account create --resource-group "share-rg" --name "FabrikamDataShareAccount" \
  --subscription 11111111-1111-1111-1111-111111111111

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

az storage account show --resource-group "share-rg" --name "FabrikamDataShareAccount" \
  --subscription 11111111-1111-1111-1111-111111111111 --query "id"

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

az datashare account show --resource-group "share-rg" --name "cli_test_consumer_account" \
  --subscription 11111111-1111-1111-1111-111111111111 --query "identity.principalId"

Gebruik de opdracht az role assignment create om een roltoewijzing voor de account-principal te maken:

az role assignment create --role "01234567-89ab-cdef-0123-456789abcdef" \
  --assignee-object-id 6789abcd-ef01-2345-6789-abcdef012345 
  --assignee-principal-type ServicePrincipal --scope 456789ab-cdef-0123-4567-89abcdef0123 \
  --subscription 11111111-1111-1111-1111-111111111111

Een variabele voor de toewijzing maken op basis van de gegevensset-id:

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

Gebruik de opdracht az datashare consumer dataset-mapping create om de toewijzing voor de gegevensset te maken:

az datashare consumer dataset-mapping create --resource-group "share-rg" \
  --name "consumer-data-set-mapping" --account-name "FabrikamDataShareAccount" \
  --share-subscription-name "Fabrikam Solutions" --mapping $mapping \
  --subscription 11111111-1111-1111-1111-111111111111

Voer de opdracht az datashare consumer share-subscription synchronization start uit om de synchronisatie van de gegevensset te starten.

az datashare consumer share-subscription synchronization start \
  --resource-group "share-rg" --account-name "FabrikamDataShareAccount"  \
  --share-subscription-name "Fabrikam Solutions" --synchronization-mode "Incremental" \
  --subscription 11111111-1111-1111-1111-111111111111

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

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

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

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

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

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

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

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 verder gaan met de volgende stappen.
1. Voer de opdracht New-AzStorageAccount uit om een Azure Storage 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 worden textfile.csvuit 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
```
Voor meer informatie over het werken met Azure Storage in PowerShell, volgt u Azure Storage PowerShell-handleiding.
Gebruik de opdracht Get-AzStorageAccount om de opslagaccount-id op te halen:
```
Get-AzStorageAccount -ResourceGroupName <String> -Name <String>
```

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>

Voer de opdracht Start-AzDataShareSubscriptionSynchronization uit om de synchronisatie van de gegevensset 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 de synchronisatie-instellingen te zien die zijn ingesteld op uw share.

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

Een momentopname activeren

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

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.
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.

Voer de opdracht az datashare consumer trigger create uit om het maken van een momentopname te activeren:

az datashare consumer trigger create --resource-group "share-rg" \
  --name "share_test_trigger" --account-name "FabrikamDataShareAccount" \
  --share-subscription-name "Fabrikam Solutions" --recurrence-interval "Day" \
  --synchronization-time "2020-04-23 18:00:00 +00:00" --kind ScheduleBased \
  --subscription 11111111-1111-1111-1111-111111111111

Notitie

Gebruik deze opdracht alleen voor delen op basis van een momentopname.

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>

Geschiedenis weergeven

Deze stap geldt alleen voor delen op basis van momentopnamen. Selecteer het tabblad Geschiedenis om de geschiedenis van uw momentopnamen weer te geven. Hier vindt u een geschiedenis van alle momentopnamen die zijn gegenereerd voor de afgelopen dertig dagen.

Resources opschonen

Wanneer u de resource niet langer nodig hebt, gaat u naar de pagina Overzicht Data Share en selecteert u Verwijderen om de resource 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

Zelfstudie: Gegevens accepteren en ontvangen met Azure Data Share

Beoordeel uw ervaring