Självstudie: Acceptera och ta emot data med Hjälp av Azure Data Share

I den här självstudien får du lära dig hur du accepterar 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 några Azure-resurser, som visas nedan.

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

• Azure-prenumeration: Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.
• En dataresursinbjudan: En inbjudan från Microsoft Azure med ett ämne med titeln "Azure Data Share-inbjudan från yourdataprovider@domain.com".
• Registrera resursprovidern Microsoft.DataShare i Azure-prenumerationen där du skapar en dataresurs och den Azure-prenumeration 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 rollen Lagringskontodeltagare.
• Behörighet att lägga till rolltilldelning till lagringskontot, som finns i Microsoft.Authorization/role assignments/write. Den här behörigheten finns i ägarrollen.

Ta emot data till ett SQL-baserat mål

Om du väljer att ta emot data till Azure SQL Database, Azure Synapse Analytics, nedan visas listan över förutsättningar.

Förutsättningar 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.
• Microsoft Entra-administratör för SQL-servern
• SQL Server Firewall-åtkomst. Detta kan göras genom följande steg:
  1. I SQL Server i Azure-portalen går 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-portalen. Du kan också lägga till ett IP-intervall.
  4. Välj Spara.

Förutsättningar för att ta emot data till Azure Synapse Analytics -SQL-pool (arbetsyta)

• En dedikerad SQL-pool för Azure Synapse Analytics (arbetsyta). Det finns för närvarande inte stöd för att ta emot data till en serverlös SQL-pool.

• Behörighet att skriva till SQL-poolen i Synapse-arbetsytan, som finns i Microsoft.Synapse/workspaces/sqlPools/write. Den här behörigheten finns i deltagarrollen.

• Behörighet för dataresursens hanterade identitet för åtkomst till Synapse-arbetsytans SQL-pool. Detta kan göras genom följande steg:

  1. Gå till Synapse-arbetsytan i Azure-portalen. Välj Microsoft Entra-administratör i det vänstra navigeringsfältet och ange dig själv som Microsoft Entra-administratör.

  2. Öppna Synapse Studio och välj Hantera i det vänstra navigeringsfältet. Välj Åtkomstkontroll under Säkerhet. Tilldela dig själv rollen SQL-administratör eller arbetsyteadministratör .

  3. I Synapse Studio väljer du Utveckla i det vänstra navigeringsfältet. Kör följande skript i SQL-poolen för att lägga till den hanterade identiteten för dataresursen 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>";
     

     > Share_acc_name <är namnet på dataresursen. Om du inte har skapat en Data Share-resurs ännu kan du komma tillbaka till den här förutsättningen senare.

• Åtkomst till Synapse-arbetsytans brandvägg. Detta kan göras genom följande steg:

  1. Gå till Synapse-arbetsytan i Azure-portalen. Välj Brandväggar i det vänstra navigeringsfältet.
  2. Välj PÅ för Tillåt att Azure-tjänster och resurser får åtkomst till 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-portalen. 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-kluster i samma Azure-datacenter som dataleverantörens Data Explorer-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-klustret, som finns i Microsoft.Kusto/clusters/write. Den här behörigheten finns i deltagarrollen.

Logga in på Azure-portalen

Logga in på Azure-portalen.

Öppna inbjudan

Portal

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

   Om du vill öppna inbjudan från e-post markerar du inkorgen för en inbjudan från dataleverantören. Inbjudan kommer från Microsoft Azure med titeln Azure Data Share-inbjudan från yourdataprovider@domain.com. Välj Visa inbjudan om du vill se din inbjudan i Azure.

   Om du vill öppna inbjudan direkt från Azure-portalen söker du efter dataresursinbjudningar i Azure-portalen. Den här åtgärden tar dig till listan med dataresursinbjudningar.

   Om du är gästanvändare i en klientorganisation uppmanas du att verifiera din e-postadress för klientorganisationen innan du visar dataresursinbjudan för första gången. När den har verifierats är den giltig i 12 månader.

   

2. Välj den inbjudan som du vill visa.

Azure CLI

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. Mer information finns i Snabbstart för Bash i Azure Cloud Shell.

  

• Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.

  • 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. Andra inloggningsalternativ finns i Logga in med Azure CLI.

  • När du uppmanas att installera Azure CLI-tillägget vid första användningen. 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-invitation för att se dina aktuella inbjudningar:

az datashare consumer consumer-invitation list-invitation

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

PowerShell

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 den senaste versionen av Az PowerShell-modulen.
  • Anslut till ditt Azure-konto med cmdleten Anslut-AzAccount.
• Om du väljer att använda Azure Cloud Shell:
  • Mer information finns i Översikt över Azure Cloud Shell .

1. Använd kommandot Anslut-AzAccount för att ansluta till ditt Azure-konto.

   Connect-AzAccount
   

2. Kör kommandot Set-AzContext för att ange rätt prenumeration om du har flera prenumerationer.

   Set-AzContext [SubscriptionID/SubscriptionName]
   

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

Portal

1. Kontrollera att alla fält granskas, inklusive användningsvillkoren. Om du godkänner användningsvillkoren måste du markera kryssrutan för att ange att du samtycker.

   

2. Under Måldataresurskonto väljer du den prenumeration och resursgrupp som du ska distribuera din dataresurs till.

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

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

   När du har gått med på användningsvillkoren och angett ett Data Share-konto för att hantera din mottagna resurs väljer du Acceptera och konfigurera. 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.

Azure CLI

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

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

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

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

Konfigurera mottagen resurs

Portal

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

1. Välj fliken Datauppsättningar . Markera kryssrutan bredvid den datauppsättning som du vill tilldela ett mål till. Välj + Mappa som mål för att välja ett måldatalager.

   

2. 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 dataresurs att köra skriptet "skapa användare" ovan för min räkning.

   För delning på plats väljer du ett datalager på den angivna platsen. Platsen är det Azure-datacenter där dataleverantörens källdatalager finns på. När datamängden har mappats kan du följa länken i målsökvägen för att komma åt data.

   

3. Om dataprovidern har skapat ett schema för ögonblicksbilder för att tillhandahålla regelbunden uppdatering av data för ögonblicksbildbaserad delning kan du även aktivera schema för ögonblicksbilder genom att välja fliken Schema för ögonblicksbilder. Markera kryssrutan bredvid schemat för ögonblicksbilder och välj + Aktivera. Den första schemalagda ögonblicksbilden startar inom en minut från schematiden och efterföljande ögonblicksbilder startar inom några sekunder efter den schemalagda tiden.

   

   Metadata för kopierade filer sparas inte efter varje körning. Det här är avsiktligt.

Azure CLI

Använd dessa kommandon för att konfigurera var du vill ta emot data.

1. Kör kommandot az datashare consumer-source-data-set list för att hämta datamängds-ID:t:

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

2. Om du behöver ett lagringskonto kör du kommandot az storage account create för att skapa ett lagringskonto för den här dataresursen:

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

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

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

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

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

5. Använd kommandot az role assignment create för att skapa en rolltilldelning för kontots huvudnamn med kontots huvudnamns-ID och ditt lagringskonto-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. Skapa en variabel för mappningen baserat på datamängdens ID från steg 1:

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

7. Använd kommandot az datashare data-set-mapping create för att skapa datauppsättningsmappningen:

   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. Kör kommandot az datashare share-subscription sync för att starta datauppsättningssynkronisering.

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

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

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

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

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

PowerShell

Använd dessa kommandon för att konfigurera var du vill ta emot data.

1. Kör kommandot Get-AzDataShareSourceDataSet för att hämta datamängds-ID:t:

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

2. Om du inte redan har en plats där du vill lagra delade data kan du följa de här stegen 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-konto som innehåller 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 överförs textfile.csv från mappen D:\testFiles på lokalt minne till containern 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.

3. Använd kommandot Get-AzStorageAccount för att hämta lagringskontots ID:

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

4. Använd datamängds-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>
   

5. Kör kommandot Start-AzDataShareSubscriptionSynchronization för att starta datauppsättningssynkronisering.

   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 på din resurs.

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

Utlösa en ögonblicksbild

Portal

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

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

   

2. När den senaste körningsstatusen lyckas 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ägen.

   

Azure CLI

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

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

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 historik 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 över dataresurs 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 en Azure Data Share. Om du vill veta mer om Azure Data Share-begrepp kan du fortsätta till Azure Data Share Terminology.

Begrepp för Azure Data Share