Kurz: Přijetí a příjem dat pomocí služby Azure Data Share

V tomto kurzu se dozvíte, jak přijmout pozvánku ke sdílení dat pomocí služby Azure Data Share. Dozvíte se, jak přijímat data, která s vámi někdo sdílí, a jak povolit pravidelný interval aktualizace, abyste měli vždy nejnovější snímek dat, která s vámi někdo sdílí.

• Přijetí pozvánky ke službě Azure Data Share
• Vytvoření účtu Azure Data Share
• Určení cíle pro data
• Vytvoření předplatného sdílené složky dat pro plánovanou aktualizaci

Požadavky

Než budete moct přijmout pozvánku ke sdílení dat, musíte vytvořit některé prostředky Azure, které jsou uvedené níže.

Před přijetím pozvánky ke sdílené složce dat se ujistěte, že jsou splněné všechny požadavky.

• Předplatné Azure: Pokud nemáte předplatné Azure, vytvořte si před zahájením bezplatný účet .
• Pozvánka ke službě Data Share: Pozvánka z Microsoft Azure s předmětem s názvem "Pozvánka ke službě Azure Data Share z yourdataprovider@domain.com".
• Zaregistrujte poskytovatele prostředků Microsoft.DataShare v předplatném Azure, kde vytvoříte prostředek služby Data Share a předplatné Azure, ve kterém se nachází vaše cílové úložiště dat Azure.

Příjem dat do účtu úložiště

• Účet Azure Storage: Pokud ho ještě nemáte, můžete si vytvořit účet Azure Storage.
• Oprávnění k zápisu do účtu úložiště, který se nachází v Microsoft.Storage/storageAccounts/write. Toto oprávnění existuje v roli Přispěvatel účtu úložiště.
• Oprávnění k přidání přiřazení role k účtu úložiště, který je k dispozici v Microsoft.Authorization/přiřazení rolí/zápis. Toto oprávnění existuje v roli Vlastník.

Příjem dat do cíle založeného na SQL

Pokud se rozhodnete přijímat data do služby Azure SQL Database, azure Synapse Analytics najdete níže uvedený seznam požadavků.

Předpoklady pro příjem dat do služby Azure SQL Database nebo Azure Synapse Analytics (dříve Azure SQL DW)

• Azure SQL Database nebo Azure Synapse Analytics (dříve Azure SQL DW).
• Oprávnění k zápisu do databází na SQL Serveru, které se nachází v Microsoft.Sql/servers/databases/write. Toto oprávnění existuje v roli Přispěvatel.
• Microsoft Entra Správa SQL Serveru
• Přístup k bráně firewall SQL Serveru Můžete to provést pomocí následujících kroků:
  1. Na SQL Serveru na webu Azure Portal přejděte do bran firewall a virtuálních sítí.
  2. U možnosti Povolit službám a prostředkům Azure přístup k tomuto serveru vyberte Ano.
  3. Vyberte +Přidat IP adresu klienta. IP adresa klienta se může změnit. Tento proces může být potřeba opakovat při příštím sdílení dat SQL z webu Azure Portal. Můžete také přidat rozsah IP adres.
  4. Zvolte Uložit.

Požadavky pro příjem dat do fondu SQL služby Azure Synapse Analytics (pracovní prostor)

• Vyhrazený fond SQL služby Azure Synapse Analytics (pracovní prostor). Příjem dat do bezserverového fondu SQL se v současné době nepodporuje.

• Oprávnění k zápisu do fondu SQL v pracovním prostoru Synapse, který se nachází v Microsoft.Synapse/workspaces/sqlPools/write. Toto oprávnění existuje v roli Přispěvatel.

• Oprávnění pro spravovanou identitu prostředku služby Data Share pro přístup k fondu SQL pracovního prostoru Synapse Můžete to provést pomocí následujících kroků:

  1. Na webu Azure Portal přejděte do pracovního prostoru Synapse. V levém navigačním panelu vyberte správce SLUŽBY SQL Active Directory a nastavte se jako správce Microsoft Entra.

  2. Otevřete Synapse Studio a v levém navigačním panelu vyberte Spravovat . V části Zabezpečení vyberte Řízení přístupu. Přiřaďte si roli správce SQL nebo správce pracovního prostoru.

  3. V nástroji Synapse Studio vyberte v levém navigačním panelu možnost Vývoj . Spuštěním následujícího skriptu ve fondu SQL přidejte spravovanou identitu prostředku služby Data Share jako 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 <> je název vašeho prostředku služby Data Share. Pokud jste ještě nevytvořili prostředek služby Data Share, můžete se k tomuto požadavku vrátit později.

• Přístup k bráně firewall pracovního prostoru Synapse Můžete to provést pomocí následujících kroků:

  1. Na webu Azure Portal přejděte do pracovního prostoru Synapse. V levém navigačním panelu vyberte brány firewall.
  2. V části Povolit službám a prostředkům Azure přístup k tomuto pracovnímu prostoru vyberte ZAPNUTO.
  3. Vyberte +Přidat IP adresu klienta. IP adresa klienta se může změnit. Tento proces může být potřeba opakovat při příštím sdílení dat SQL z webu Azure Portal. Můžete také přidat rozsah IP adres.
  4. Zvolte Uložit.

Příjem dat do clusteru Azure Data Exploreru:

• Cluster Azure Data Exploreru ve stejném datovém centru Azure jako cluster Data Exploreru poskytovatele dat: Pokud ho ještě nemáte, můžete vytvořit cluster Azure Data Exploreru. Pokud neznáte datové centrum Azure clusteru poskytovatele dat, můžete cluster vytvořit později v procesu.
• Oprávnění k zápisu do clusteru Azure Data Exploreru, který se nachází v Microsoft.Kusto/clusters/write. Toto oprávnění existuje v roli Přispěvatel.

Přihlaste se k portálu Azure Portal.

Přihlaste se k portálu Azure.

Otevřít pozvánku

Azure Portal

1. Pozvánku můžete otevřít z e-mailu nebo přímo z webu Azure Portal.

   Pokud chcete otevřít pozvánku z e-mailu, zkontrolujte doručenou poštu u pozvánky od poskytovatele dat. Pozvánka je z Microsoft Azure s názvem Pozvánka ke službě Azure Data Share z yourdataprovider@domain.com. Výběrem možnosti Zobrazit pozvánku zobrazíte pozvánku v Azure.

   Pokud chcete pozvánku otevřít přímo z webu Azure Portal, vyhledejte na webu Azure Portal pozvánky ke sdílení dat. Tato akce vás provede seznamem pozvánek ke službě Data Share.

   Pokud jste uživatelem typu host tenanta, zobrazí se výzva k ověření e-mailové adresy tenanta před prvním zobrazením pozvánky ke službě Data Share. Po ověření platí 12 měsíců.

   

2. Vyberte pozvánku, kterou chcete zobrazit.

Azure CLI

Připravte prostředí Azure CLI a zobrazte pozvánky.

Začněte přípravou prostředí pro rozhraní příkazového řádku Azure:

• Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Rychlý start pro Bash v Azure Cloud Shellu.

  

• Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.

  • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Přihlášení pomocí Azure CLI.

  • Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.

  • Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

Spuštěním příkazu az datashare consumer-invitation list-invitation zobrazte aktuální pozvánky:

az datashare consumer consumer-invitation list-invitation

Zkopírujte ID pozvánky pro použití v další části.

PowerShell

Začněte přípravou prostředí pro PowerShell. Příkazy PowerShellu můžete spouštět místně nebo pomocí prostředí Bash v Azure Cloud Shellu.

• Pokud se rozhodnete používat Azure PowerShell místně:
  • Nainstalujte nejnovější verzi modulu Az PowerShell.
  • Připojení k účtu Azure pomocí rutiny Připojení-AzAccount.
• Pokud se rozhodnete použít Azure Cloud Shell:
  • Další informace najdete v přehledu služby Azure Cloud Shell .

1. Pomocí příkazu Připojení-AzAccount se připojte ke svému účtu Azure.

   Connect-AzAccount
   

2. Spuštěním příkazu Set-AzContext nastavte správné předplatné, pokud máte více předplatných.

   Set-AzContext [SubscriptionID/SubscriptionName]
   

3. Spuštěním příkazu Get-AzDataShareReceivedInvitation zobrazte aktuální pozvánky:

   Get-AzDataShareReceivedInvitation
   

Zkopírujte ID pozvánky pro použití v další části.

Přijmout pozvánku

Azure Portal

1. Ujistěte se, že jsou zkontrolována všechna pole včetně podmínek použití. Pokud souhlasíte s podmínkami použití, budete muset toto políčko zaškrtnout, aby bylo uvedeno, že souhlasíte.

   

2. V části Účet cílové sdílené složky dat vyberte předplatné a skupinu prostředků, do které nasadíte sdílenou složku dat.

   Pokud nemáte existující účet služby Data Share, vyberte možnost Vytvořit nový. V opačném případě vyberte existující účet služby Data Share, do kterého chcete svoji sdílenou složku dat přijmout.

   U pole Název přijaté sdílené složky můžete ponechat výchozí hodnotu určenou zadanými daty nebo zadat nový název přijaté sdílené složky.

   Jakmile souhlasíte s podmínkami použití a zadáte účet služby Data Share pro správu přijaté sdílené složky, vyberte Přijmout a nakonfigurujte. Vytvoří se předplatné sdílené složky.

   

   Tato akce vás provede přijatou sdílenou složkou ve vašem účtu Data Share.

   Pokud pozvánku nechcete přijmout, vyberte Odmítnout.

Azure CLI

Pomocí příkazu az datashare share-subscription create vytvořte sdílenou složku dat.

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

K vytvoření sdílené datové složky použijte příkaz New-AzDataShareSubscription. Id pozvánky bude ID, které jste shromáždili z předchozího kroku.

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

Konfigurace přijaté sdílené složky

Azure Portal

Podle následujících kroků nakonfigurujte, kam chcete přijímat data.

1. Vyberte kartu Datové sady . Zaškrtněte políčko vedle datové sady, ke které chcete přiřadit cíl. Pokud chcete vybrat cílové úložiště dat, vyberte + Mapovat .

   

2. Vyberte cílový typ úložiště dat, do kterého chcete data přistát. Všechny datové soubory nebo tabulky v cílovém úložišti dat se stejnou cestou a názvem budou přepsány. Pokud přijímáte data do služby Azure SQL Database nebo Azure Synapse Analytics (dříve Azure SQL DW), zaškrtněte políčko Povolit službě Data Share spustit výše uvedený skript create user (vytvořit uživatele) mým jménem.

   Pro místní sdílení vyberte úložiště dat v zadaném umístění. Umístění je datové centrum Azure, ve kterém se nachází zdrojové úložiště dat poskytovatele dat. Po namapování datové sady můžete pomocí odkazu v cílové cestě získat přístup k datům.

   

3. Pokud poskytovatel dat vytvořil plán snímků pro pravidelné aktualizace dat, můžete plán snímků povolit také tak , že vyberete kartu Plán snímků. Zaškrtněte políčko vedle plánu snímků a vyberte + Povolit. První naplánovaný snímek se spustí během jedné minuty od času plánu a následné snímky se spustí během sekund naplánovaného času.

   

   Metadata zkopírovaných souborů se po každém spuštění neuchovávají. Toto chování je úmyslné.

Azure CLI

Pomocí těchto příkazů můžete nakonfigurovat, kam chcete přijímat data.

1. Spuštěním příkazu az datashare consumer-source-data-set list získejte ID sady dat:

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

2. Pokud potřebujete účet úložiště, spusťte příkaz az storage account create a vytvořte účet úložiště pro tuto sdílenou složku dat:

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

3. Pomocí příkazu az storage account show získejte ID účtu úložiště:

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

4. Pomocí následujícího příkazu získejte ID objektu zabezpečení účtu:

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

5. Pomocí příkazu az role assignment create vytvořte přiřazení role pro instanční objekt pomocí ID objektu zabezpečení účtu a ID účtu úložiště:

   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. Vytvořte proměnnou pro mapování na základě ID sady dat z kroku 1:

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

7. K vytvoření mapování datové sady použijte příkaz az datashare data-set-mapping create:

   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. Spuštěním příkazu az datashare share-subscription sync spusťte synchronizaci datových sad.

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

   Spuštěním příkazu az datashare share-subscription list-synchronization zobrazte seznam vašich synchronizací:

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

   Pomocí příkazu az datashare share-subscription list-source-share-synchronization-setting zobrazte nastavení synchronizace nastavené ve sdílené složce.

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

PowerShell

Pomocí těchto příkazů můžete nakonfigurovat, kam chcete přijímat data.

1. Spuštěním příkazu Get-AzDataShareSourceDataSet získejte ID sady dat:

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

2. Pokud ještě nemáte umístění, kam chcete uložit sdílená data, můžete pomocí těchto kroků vytvořit účet úložiště. Pokud už úložiště máte, můžete přejít k dalším krokům.

   1. Spuštěním příkazu New-AzStorageAccount vytvořte účet Azure Storage:

      $storageAccount = New-AzStorageAccount -ResourceGroupName <String> -AccountName <String> -Location <String> -SkuName <String>
      
      $ctx = $storageAccount.Context
      

   2. Spuštěním příkazu New-AzStorageContainer vytvořte kontejner v novém účtu Azure Storage, který bude obsahovat vaše data:

      $containerName = <String>
      
      New-AzStorageContainer -Name $containerName -Context $ctx -Permission blob
      

   3. Spuštěním příkazu Set-AzStorageBlobContent nahrajte soubor. Následující příklad nahraje textfile.csv ze složky D:\testFiles v místní paměti do kontejneru, který jste vytvořili.

      Set-AzStorageBlobContent -File "D:\testFiles\textfile.csv" -Container $containerName -Blob "textfile.csv" -Context $ctx
      

   Další informace o práci se službou Azure Storage v PowerShellu najdete v tomto průvodci Prostředím PowerShell služby Azure Storage.

3. Pomocí příkazu Get-AzStorageAccount získejte ID účtu úložiště:

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

4. Použijte ID sady dat z prvního kroku a pak spuštěním příkazu New-AzDataShareDataSetMapping vytvořte mapování datové sady:

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

5. Spuštěním příkazu Start-AzDataShareSubscriptionSynchronization spusťte synchronizaci datových sad.

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

   Spuštěním příkazu Get-AzDataShareSubscriptionSynchronization zobrazte seznam vašich synchronizací:

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

   Pomocí příkazu Get-AzDataShareSubscriptionSynchronizationDetail zobrazte nastavení synchronizace nastavené ve sdílené složce.

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

Aktivace snímku

Azure Portal

Tento postup platí jenom pro sdílení na základě snímků.

1. Snímek můžete aktivovat tak , že vyberete kartu Podrobnosti a snímek aktivační události. Tady můžete aktivovat úplný nebo přírůstkový snímek dat. Pokud data od poskytovatele dat přijímáte poprvé, vyberte úplnou kopii.

   

2. Po úspěšném dokončení posledního spuštění přejděte do cílového úložiště dat a zobrazte přijatá data. Vyberte Datové sady a vyberte odkaz v cílové cestě.

   

Azure CLI

Spuštěním příkazu az datashare trigger create aktivujte snímek:

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

Tento postup platí jenom pro sdílení na základě snímků.

Spuštěním příkazu New-AzDataShareTrigger aktivujte snímek:

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

Zobrazit historii

Tento krok platí jenom pro sdílení založené na snímcích. Pokud chcete zobrazit historii snímků, vyberte kartu Historie . Tady najdete historii všech snímků, které byly vygenerovány za posledních 30 dnů.

Vyčištění prostředků

Pokud už prostředek nepotřebujete, přejděte na stránku Přehled služby Data Share a výběrem možnosti Odstranit ho odeberte.

Další kroky

V tomto kurzu jste se dozvěděli, jak přijmout a přijmout službu Azure Data Share. Další informace o konceptech služby Azure Data Share najdete v terminologii služby Azure Data Share.

Koncepty služby Azure Data Share