Självstudie: Acceptera & ta emot data – Azure Data Share

Artikel
11/20/2021
11 minuter för att läsa

I den här självstudien lär du dig att acceptera en dataresursinbjudan med hjälp av Azure Data Share. Du får lära dig hur du tar emot data som delas med dig och hur du aktiverar ett regelbundet uppdateringsintervall för att säkerställa att du alltid har den senaste ögonblicksbilden av de data som delas med dig.

Så här accepterar du en Azure Data Share inbjudan
Skapa ett Azure Data Share konto
Ange ett mål för dina data
Skapa en prenumeration på din dataresurs för schemalagd uppdatering

Förutsättningar

Innan du kan acceptera en dataresursinbjudan måste du skapa ett antal Azure-resurser, som anges nedan.

Se till att alla krav är uppfyllda innan du godkänner en dataresursinbjudan.

Azure-prenumeration: Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.
En Data Share: En inbjudan från Microsoft Azure med ämnet "Azure Data Share inbjudan från yourdataprovider@domain.com ".
Registrera resursprovidern Microsoft.DataShare i Azure-prenumerationen där du skapar en Data Share-resurs och Azure-prenumerationen där dina Azure-måldatalager finns.

Ta emot data till ett lagringskonto

Ett Azure Storage konto: Om du inte redan har ett kan du skapa ett Azure Storage konto.
Behörighet att skriva till lagringskontot, som finns i Microsoft.Storage /storageAccounts/write. Den här behörigheten finns i Storage rollen Blob Data-deltagare.
Behörighet att lägga till rolltilldelning till lagringskontot, som finns i Microsoft.Authorization/rolltilldelningar/skriva. Den här behörigheten finns i ägarrollen.

Ta emot data SQL ett SQL mål

Om du väljer att ta emot data Azure SQL Database Azure Synapse Analytics listan nedan en lista över förhandskrav.

Krav för att ta emot data till Azure SQL Database eller Azure Synapse Analytics (tidigare Azure SQL DW)

En Azure SQL Database eller Azure Synapse Analytics (tidigare Azure SQL DW).
Behörighet att skriva till databaser på SQL-servern, som finns i Microsoft.Sql/servers/databases/write. Den här behörigheten finns i deltagarrollen.
Azure Active Directory administratör för SQL server
SQL Server Firewall-åtkomst. Detta kan göras med hjälp av följande steg:
1. I SQL server i Azure Portal navigerar du till Brandväggar och virtuella nätverk
2. Välj Ja för Tillåt Att Azure-tjänster och -resurser får åtkomst till den här servern.
3. Välj +Lägg till klient-IP. Klientens IP-adress kan komma att ändras. Den här processen kan behöva upprepas nästa gång du delar SQL data från Azure Portal. Du kan också lägga till ett IP-intervall.
4. Välj Spara.

Krav för att ta emot data till Azure Synapse Analytics (arbetsyta) SQL poolen

En Azure Synapse Analytics (arbetsyta) dedikerad SQL pool. Det finns för närvarande inte stöd SQL ta emot data till en serverlös SQL pool.
Behörighet att skriva till SQL i Synapse-arbetsytan, som finns i Microsoft.Synapse/workspaces/sqlPools/write. Den här behörigheten finns i deltagarrollen.
Behörighet för den Data Share resursens hanterade identitet för åtkomst till Synapse-arbetsytan SQL poolen. Detta kan göras med hjälp av följande steg:
1. I Azure Portal du till Synapse-arbetsytan. Välj SQL Active Directory-administratör från det vänstra navigeringsfönstret och ange dig själv som Azure Active Directory administratör.
2. Öppna Synapse Studio väljer du Hantera i det vänstra navigeringsfönstret. Välj Åtkomstkontroll under Säkerhet. Tilldela dig själv SQL administratörs- eller arbetsyteadministratörsroll.
3. I Synapse Studio du Utveckla i det vänstra navigeringsfönstret. Kör följande skript i SQL poolen för att lägga till Data Share-resurs hanterad identitet som en "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>";
```
  Observera att <share_acc_name> är namnet på din Data Share resurs. Om du inte har skapat Data Share resurs ännu kan du komma tillbaka till det här kravet senare.
Åtkomst till Synapse-arbetsytans brandvägg. Detta kan göras med hjälp av följande steg:
1. I Azure Portal du till Synapse-arbetsytan. Välj Brandväggar i det vänstra navigeringsfönstret.
2. Välj PÅ för Allow Azure services and resources to access this workspace (Tillåt Azure-tjänster och resurser att komma åt den här arbetsytan).
3. Välj +Lägg till klient-IP. Klientens IP-adress kan komma att ändras. Den här processen kan behöva upprepas nästa gång du delar SQL data från Azure Portal. Du kan också lägga till ett IP-intervall.
4. Välj Spara.

Ta emot data till ett Azure Data Explorer kluster:

Ett Azure Data Explorer i samma Azure-datacenter som dataleverantörens Datautforskaren-kluster: Om du inte redan har ett kan du skapa ett Azure Data Explorer kluster. Om du inte känner till Azure-datacentret för dataleverantörens kluster kan du skapa klustret senare i processen.
Behörighet att skriva till Azure Data Explorer som finns i Microsoft.Kusto/clusters/write. Den här behörigheten finns i deltagarrollen.

Logga in på Azure-portalen.

Öppna inbjudan

Du kan öppna inbjudan via e-post eller direkt från Azure Portal.

Om du vill öppna en inbjudan via e-post kontrollerar du om det finns en inbjudan från dataleverantören i din inkorg. Inbjudan kommer från Microsoft Azure, med namnet Azure Data Share inbjudan yourdataprovider@domain.com från. Välj Visa inbjudan för att se din inbjudan i Azure.

Om du vill öppna inbjudan Azure Portal direkt söker du efter Data Share inbjudningar i Azure Portal. Den här åtgärden tar dig till listan över Data Share inbjudningar.

Om du är gästanvändare för en klientorganisation uppmanas du att verifiera din e-postadress för klienten innan du visar en Data Share inbjudan för första gången. När det har verifierats är det giltigt i 12 månader.
Välj den inbjudan som du vill visa.

Förbered Din Azure CLI-miljö och visa sedan dina inbjudningar.

Börja med att förbereda din miljö för Azure CLI:

Använd bash-miljön i Azure Cloud Shell.
Om du vill kan du i stället installera Azure CLI för att köra CLI-referenskommandon.
- Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Fler inloggningsalternativ finns i Logga in med Azure CLI.
- När du uppmanas till det installerar du Azure CLI-tillägg vid första användning. Mer information om tillägg finns i Använda tillägg med Azure CLI.
- Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Kör kommandot az datashare consumer invitation list för att se dina aktuella inbjudningar:

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

Kopiera ditt inbjudnings-ID för användning i nästa avsnitt.

Börja med att förbereda din miljö för PowerShell. Du kan antingen köra PowerShell-kommandon lokalt eller använda Bash-miljön i Azure Cloud Shell.

Om du väljer att använda Azure PowerShell lokalt:
- Installera Az PowerShell-modulen.
- Anslut till ditt Azure-konto med hjälp av cmdleten Anslut-AzAccount.
Om du väljer att använda Azure Cloud Shell:
- Se Översikt över Azure Cloud Shell för mer information.

Använd kommandot Anslut-AzAccount för att ansluta till ditt Azure-konto.
```
Connect-AzAccount
```
Kör kommandot Set-AzContext för att ange rätt prenumeration om du har flera prenumerationer.
```
Set-AzContext [SubscriptionID/SubscriptionName]
```
Kör kommandot Get-AzDataShareReceivedInvitation för att se dina aktuella inbjudningar:
```
Get-AzDataShareReceivedInvitation
```

Kopiera ditt inbjudnings-ID för användning i nästa avsnitt.

Acceptera inbjudan

Kontrollera att alla fält granskas, inklusive användningsvillkoren. Om du godkänner användningsvillkoren måste du markera kryssrutan för att visa att du accepterar.
Under Målkonto Data Share väljer du den prenumeration och resursgrupp som du ska distribuera din Data Share till.

I fältet Data Share konto väljer du Skapa nytt om du inte har ett befintligt Data Share konto. Annars väljer du ett Data Share konto som du vill godkänna din dataresurs till.

I fältet Mottaget resursnamn kan du lämna standardvärdet som anges av den angivna informationen eller ange ett nytt namn för den mottagna resursen.

När du har godkänt användningsvillkoren och angett ett Data Share för att hantera din mottagna resurs väljer du Godkänn och konfigurerar. En resursprenumeration skapas.

Den här åtgärden tar dig till den mottagna resursen i ditt Data Share konto.

Om du inte vill acceptera inbjudan väljer du Avvisa.

Använd kommandot az datashare consumer share-subscription create för att skapa Data Share.

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

Använd kommandot New-AzDataShareSubscription för att skapa Data Share. InvitationId är det ID som du samlade in från föregående steg.

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

Följ stegen nedan för att konfigurera var du vill ta emot data.

Välj fliken Datauppsättningar. Markera kryssrutan bredvid den datauppsättning som du vill tilldela ett mål till. Välj + Mappa till mål för att välja ett måldatalager.
Välj en typ av måldatalager som du vill att data ska landa i. Alla datafiler eller tabeller i måldatalagret med samma sökväg och namn skrivs över. Om du tar emot data till Azure SQL Database eller Azure Synapse Analytics (tidigare Azure SQL DW) markerar du kryssrutan Tillåt Data Share att köra ovanstående skript "skapa användare" för min räkning.

För delning på plats väljer du ett datalager i den angivna platsen. Platsen är det Azure-datacenter där dataleverantörens källdatalager finns. När datauppsättningen har mappats kan du följa länken i målsökvägen för att komma åt data.
För ögonblicksbildsbaserad delning, om dataleverantören har skapat ett schema för ögonblicksbilder för att tillhandahålla regelbundna uppdateringar av data, kan du också aktivera schemat för ögonblicksbilder genom att välja fliken Schema för ögonblicksbilder. Markera kryssrutan bredvid schemat för ögonblicksbilden och välj + Aktivera. Observera att den första schemalagda ögonblicksbilden startar inom en minut efter schematiden och efterföljande ögonblicksbilder startar inom några sekunder från den schemalagda tiden.

Använd de här kommandona för att konfigurera var du vill ta emot data.

Kör kommandot az datashare consumer share-subscription list-source-dataset för att hämta datauppsättnings-ID:t:

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"

Kör kommandot az storage account create för att skapa ett lagringskonto för den här Data Share:

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

Använd kommandot az storage account show för att hämta lagringskontots ID:

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

Använd följande kommando för att hämta kontots huvudnamns-ID:

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

Använd kommandot az role assignment create för att skapa en rolltilldelning för kontots huvudnamn:

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

Skapa en variabel för mappningen baserat på datauppsättningens ID:

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

Använd kommandot az datashare consumer dataset-mapping create för att skapa datauppsättningsmappningen:

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

Kör startkommandot az datashare consumer share-subscription synchronization start för att starta synkroniseringen av datauppsättningen.

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

Kör kommandot az datashare consumer share-subscription synchronization list för att visa en lista över dina synkroniseringar:

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

Använd kommandot az datashare consumer share-subscription list-source-share-synchronization-setting för att se synkroniseringsinställningar som angetts på resursen.

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

Använd de här kommandona för att konfigurera var du vill ta emot data.

Kör kommandot Get-AzDataShareSourceDataSet för att hämta datauppsättningens ID:

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

Om du inte redan har en plats där du vill lagra delade data kan du följa dessa steg för att skapa ett lagringskonto. Om du redan har lagring kan du gå vidare till nästa steg.
1. Kör kommandot New-AzStorageAccount för att skapa ett Azure Storage konto:
```
$storageAccount = New-AzStorageAccount -ResourceGroupName <String> -AccountName <String> -Location <String> -SkuName <String>

$ctx = $storageAccount.Context
```
2. Kör kommandot New-AzStorageContainer för att skapa en container i ditt nya Azure Storage som ska innehålla dina data:
```
$containerName = <String>

New-AzStorageContainer -Name $containerName -Context $ctx -Permission blob
```
3. Kör kommandot Set-AzStorageBlobContent för att ladda upp en fil. I följande exempel laddas textfile.csv från mappen D:\testFiles lokalt minne till den container som du skapade.
```
Set-AzStorageBlobContent -File "D:\testFiles\textfile.csv" -Container $containerName -Blob "textfile.csv" -Context $ctx
```
Mer information om hur du arbetar med Azure Storage i PowerShell finns i den här Azure Storage PowerShell-guiden.
Använd kommandot Get-AzStorageAccount för att hämta lagringskontots ID:
```
Get-AzStorageAccount -ResourceGroupName <String> -Name <String>
```

Använd datauppsättnings-ID:t från det första steget och kör sedan kommandot New-AzDataShareDataSetMapping för att skapa datauppsättningsmappningen:

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

Kör kommandot Start-AzDataShareSubscriptionSynchronization för att starta synkroniseringen av datauppsättningen.

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

Kör kommandot Get-AzDataShareSubscriptionSynchronization för att se en lista över dina synkroniseringar:

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

Använd kommandot Get-AzDataShareSubscriptionSynchronizationDetail för att se synkroniseringsinställningar som angetts för resursen.

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

Utlösa en ögonblicksbild

De här stegen gäller endast för ögonblicksbildbaserad delning.

Du kan utlösa en ögonblicksbild genom att välja fliken Information följt av Utlösarögonblicksbild. Här kan du utlösa en fullständig eller inkrementell ögonblicksbild av dina data. Om det är första gången du tar emot data från dataleverantören väljer du fullständig kopia.
När den senaste körningsstatusen är lyckad går du till måldatalagret för att visa mottagna data. Välj Datauppsättningar och välj länken i Målsökväg.

Kör kommandot az datashare consumer trigger create för att utlösa en ögonblicksbild:

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

Anteckning

Använd endast det här kommandot för ögonblicksbildbaserad delning.

De här stegen gäller endast för ögonblicksbildbaserad delning.

Kör kommandot New-AzDataShareTrigger för att utlösa en ögonblicksbild:

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

Visa historik

Det här steget gäller endast för ögonblicksbildbaserad delning. Om du vill visa historiken för dina ögonblicksbilder väljer du fliken Historik. Här hittar du historik över alla ögonblicksbilder som har genererats under de senaste 30 dagarna.

Rensa resurser

När resursen inte längre behövs går du till sidan Översikt Data Share och väljer Ta bort för att ta bort den.

Nästa steg

I den här självstudien har du lärt dig hur du accepterar och tar emot Azure Data Share. Om du vill veta mer Azure Data Share begrepp kan du fortsätta Azure Data Share terminologi.

Azure Data Share koncept

Självstudier: Acceptera och ta emot data med Azure Data Share

Betygsätta din upplevelse