Zelfstudie: Delen buiten uw organisatie - Azure Data Share

Artikel
12/19/2023

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

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 geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.
Het Azure-e-mailadres van de geadresseerde (met behulp van hun e-mailalias werkt niet).
Als het Azure-brongegevensarchief zich in een ander Azure-abonnement bevindt dan het abonnement dat u gebruikt om een Data Share-resource te maken, registreert u de Microsoft.DataShare-resourceprovider in het abonnement waarin het Azure-gegevensarchief zich bevindt.

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.

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.
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 Azure Portal naar SQL-server. Selecteer Firewalls en virtuele netwerken in de linkernavigatiebalk.
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.

- 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 het linkernavigatievenster 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.
```
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 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.

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 het Azure-portaal.

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	Veldomschrijving
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 datashare-account te maken. Het maken van een nieuw datashare-account duurt doorgaans ongeveer 2 minuten of minder.
Selecteer Naar resource gaan zodra de implementatie is voltooid.

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

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

Gebruik deze opdrachten om de resource te maken:

Gebruik de opdracht 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-account te maken:
```
 New-AzDataShareAccount -ResourceGroupName <String> -Name <String> -Location <String>
```
Voer de opdracht Get-AzDataShareAccount uit om uw Data Share-accounts te 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. U ziet een andere lijst met gegevenssettypen, 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 geven. Selecteer Microsoft Entra-verificatie en schakel het selectievakje Gegevensshare toestaan om het bovenstaande script 'create user' namens mij uit te voeren.
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 opslagaccount te maken voor deze gegevensshare:
```
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 in de vorige opdracht is 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.com"

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 doorgaan naar stap 2.
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.

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

New-AzDataShare -ResourceGroupName <String> -AccountName <String> -Name <String> -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 in te stellen voor uw share. 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 maakt 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 behulp van Azure Data Share

Zelfstudie: Gegevens delen met Behulp van Azure Data Share

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

Meld u aan bij Azure Portal

Een Data Share-account maken

Een share maken

Resources opschonen

Volgende stappen

Aanvullende resources