Zelfstudie: Delen buiten uw organisatie - Azure Data Share

Artikel
11/20/2021
9 minuten om te lezen

In deze zelfstudie leert u hoe u een nieuwe Azure Data Share instelt en hoe u uw gegevens met klanten en partners buiten uw Azure-organisatie kunt delen.

In deze zelfstudie leert u het volgende:

Maak een gegevensshare.
Voeg gegevenssets toe aan uw gegevensshare.
Schakel een schema voor momentopnamen in voor uw gegevensshare.
Voeg ontvangers toe aan uw gegevensshare.

Vereisten

Azure-abonnement: Als u nog geen abonnement op Azure hebt, maak dan een gratis account aan voordat u begint.
Het Azure-e-mailadres van de ontvanger (het gebruik van de e-mailalias werkt niet).
Als de bron-Azure-gegevensopslag zich in een ander Azure-abonnement bevindt dan de opslag die u gebruikt om een Data Share-resource te maken, registreert u de resourceprovider Microsoft.DataShare in het abonnement waarin de Azure-gegevensopslag zich bevindt.

Een Azure Storage-account: U kunt een gratis Azure Storage-account aanmaken als u nog niet een hebt
Machtiging om naar het opslagaccount te schrijven, aanwezig in Microsoft.Storage/storageAccounts/write. Deze machtiging bevindt zich 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.

Hieronder ziet u de lijst met vereisten voor het delen van gegevens vanuit een SQL-bron.

Azure SQL Database of Azure Synapse Analytics (voorheen Azure SQL DW) met tabellen en weergaven die u wilt delen.
Machtiging om naar de 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 Azure Portal naar SQL-server. Selecteer Firewalls en virtuele netwerken in de linkernavigatiebalk.
2. Selecteer Ja bij Toegang van Azure-services en -resources tot deze server toestaan.
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.

- Een toegewezen SQL-pool in Azure Synapse Analytics (werkruimte) met tabellen die u wilt delen. Het delen van weergaven wordt momenteel niet ondersteund. Delen vanuit 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.
```
create user "<share_acct_name>" from external provider;     
exec sp_addrolemember db_datareader, "<share_acct_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 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.

Een Azure Data Explorer-cluster met databases die u wilt delen.
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.

Maak een Azure Data Share-resource in een Azure-resourcegroep.

Selecteer de menuknop in de linkerbovenhoek van de portal, en selecteer vervolgens Een resource maken (+).
Zoek naar Data Share.
Selecteer Data Share en selecteer Maken.

Vul de basisgegevens van uw Azure Data Share-resource in met de volgende informatie.

Instelling	Voorgestelde waarde	Beschrijving van veld
Abonnement	Uw abonnement	Selecteer het Azure-abonnement dat u wilt gebruiken voor uw gegevensshare-account.
Resourcegroep	testresourcegroup	Gebruik een bestaande resourcegroep of maak een nieuwe.
Locatie	US - oost 2	Geef een regio op voor uw gegevensshare-account.
Naam	datashareaccount	Geef een naam op voor uw gegevensshare-account.

Selecteer Beoordelen en maken en vervolgens Maken om uw gegevensshare-account in te richten. Het inrichten van een nieuw gegevensshare-account duurt doorgaans 2 minuten of minder.
Nadat de implementatie is voltooid, selecteert u Ga naar resource.

Maak een Azure Data Share-resource in een Azure-resourcegroep.

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.

Gebruik deze opdrachten om de resource te maken:

Gebruik de opdracht az account set om uw abonnement in te stellen als het huidige standaardabonnement:
```
az account set --subscription 00000000-0000-0000-0000-000000000000
```
Voer de opdracht az provider register uit om de resourceprovider te registreren:
```
az provider register --name "Microsoft.DataShare"
```
Voer de opdracht az group create uit om een resourcegroep te maken, of gebruik een bestaande resourcegroep:
```
az group create --name testresourcegroup --location "East US 2"
```

Voer de opdracht az datashare account create uit om een Data Share-account te maken:

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

Voer de opdracht az datashare account list uit om uw Data Share-account weer te geven:

az datashare account list --resource-group testresourcegroup

Maak een Azure Data Share-resource in een Azure-resourcegroep.

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 deze opdrachten om de resource te maken:

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 New-AzResourceGroup uit om een resourcegroep te maken of gebruik een bestaande resourcegroep:
```
New-AzResourceGroup -Name <String> -Location <String>
```
Voer de opdracht New-AzDataShare uit om een Data Share maken:
```
 New-AzDataShareAccount -ResourceGroupName <String> -Name <String> -Location <String>
```
Voer de opdracht Get-AzDataShareAccount uit om uw Data Share zien:
```
Get-AzDataShareAccount
```

Ga naar de overzichtspagina van uw gegevensshare.
Selecteer Beginnen met het delen van uw gegevens.
Selecteer Maken.
Vul de details in voor uw share. Geef een naam, type share, beschrijving van de share-inhoud en gebruiksvoorwaarden (optioneel) op.
Selecteer Doorgaan.
Selecteer Gegevenssets toevoegen om gegevenssets toe te voegen aan de share.
Selecteer het type gegevensset dat u wilt toevoegen. Welke lijst met typen gegevensset wordt weergegeven, is afhankelijk van het type share (momentopname of in-place) dat u in de vorige stap hebt geselecteerd. Als u deelt vanuit een Azure SQL Database of Azure Synapse Analytics (voorheen Azure SQL DW), wordt u gevraagd om de verificatiemethode om tabellen weer te bieden. Selecteer AAD verificatie en schakel het selectievakje Allow Data Share to run the above 'create user' script on my behalf in.
Navigeer naar het object dat u wilt delen en selecteer Gegevenssets toevoegen.
Voer op het tabblad Ontvangers de e-mailadressen in van uw gegevensgebruiker door + Ontvanger toevoegen te selecteren.
Selecteer Doorgaan.
Als u het type share momentopname hebt geselecteerd, kunt u het momentopnameschema configureren om updates van uw gegevens naar uw gegevensgebruiker te sturen.
Selecteer een begintijd en een herhalingsinterval.
Selecteer Doorgaan.
Controleer op het tabblad Beoordelen en maken de inhoud, instellingen, ontvangers en synchronisatie-instellingen van uw pakket. Selecteer Maken.

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

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

Gebruik de opdracht az storage container create om een container te maken in het opslagaccount dat u in de vorige opdracht hebt gemaakt:
```
az storage container create --name ContosoMarketplaceContainer --account-name ContosoMarketplaceAccount
```

Voer de opdracht az datashare create uit om uw Data Share te maken:

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

Gebruik de opdracht az datashare invitation create om de uitnodiging voor het opgegeven adres te maken:

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

Als u nog geen gegevens hebt die u wilt delen, kunt u deze stappen volgen om een opslagaccount te maken. Als u al opslag hebt, kunt u naar stap 2 gaan.
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.csv uit 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 Azure Storage PowerShell-handleiding.

Voer de opdracht New-AzDataShare uit om uw Data Share:

New-AzDataShare -ResourceGroupName <String> -AccountName <String> -Name <String> -ShareKind "CopyBased" -Description <String> -TermsOfUse <String>

Gebruik de opdracht New-AzDataShareInvitation om de uitnodiging voor het opgegeven adres te maken:

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

Gebruik de opdracht New-AzDataShareSynchronizationSetting om een synchronisatiepatroon voor uw share in te stellen. Dit kan dagelijks, elk uur of op een bepaald tijdstip zijn.

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

Uw Azure-gegevensshare is nu gemaakt en de ontvanger van uw gegevensshare kan nu uw uitnodiging accepteren.

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 Data Share en ontvangers uitnodigt. Voor meer informatie over hoe een gegevensgebruiker een gegevensshare kan accepteren en ontvangen, gaat u door naar de zelfstudie voor het accepteren en ontvangen van gegevens.

Zelfstudie: Gegevens accepteren en ontvangen met Azure Data Share

Zelfstudie: Gegevens delen met Azure Data Share

Beoordeel uw ervaring

Vereisten

Delen vanuit een opslagaccount

Delen vanuit een bron op basis van SQL

Vereisten voor het delen vanuit Azure SQL Database of Azure Synapse Analytics (voorheen Azure SQL DW)

Vereisten voor het delen vanuit de SQL-pool in Azure Synapse Analytics (werkruimte)

Delen vanuit Azure Data Explorer

Aanmelden bij Azure Portal

Een Data Share-account maken

Een share maken

Resources opschonen

Volgende stappen