Kurz: Přijetí & dat – Azure Data Share

Článek
11/20/2021
10 min ke čtení

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

Přijetí pozvánky Azure Data Share
Vytvoření Azure Data Share účtu
Určení cíle pro vaše data
Vytvoření předplatného pro plánovanou aktualizaci sdílené datové složky

Požadavky

Než budete moci přijmout pozvánku ke sdílené datové složky, musíte vytvořit několik prostředků Azure, které jsou uvedené níže.

Před přijetím pozvánky ke sdílené datové složky se ujistěte, že jsou všechny požadavky dokončené.

Předplatné Azure: Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet před tím, než začnete.
Pozvánka Data Share: Pozvánka od Microsoft Azure s předmětem s názvem "Azure Data Share pozvánka z yourdataprovider@domain.com ".
Zaregistrujte poskytovatele prostředků Microsoft.DataShare v předplatném Azure, ve kterém vytvoříte prostředek 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 Azure Storage účet.
Oprávnění k zápisu do účtu úložiště, který je k dispozici v Microsoft.Storage /storageAccounts/write. Toto oprávnění existuje v roli přispěvatele Storage objektů blob.
Oprávnění k přidání přiřazení role k účtu úložiště, které se nachází v umístění Microsoft.Authorization/role assignments/write. Toto oprávnění existuje v roli Vlastník.

Příjem dat do SQL na základě dat

Pokud se rozhodnete přijímat data do Azure SQL Database, Azure Synapse Analytics, níže je seznam požadavků.

Požadavky pro příjem dat do Azure SQL Database nebo Azure Synapse Analytics (dříve Azure SQL DW)

Účet 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ý je k dispozici v Microsoft.Sql/servers/databases/write. Toto oprávnění existuje v roli Přispěvatel.
Azure Active Directory správce SQL serveru
SQL Server brány firewall. Můžete to provést pomocí následujících kroků:
1. Na SQL serveru v Azure Portal přejděte na Brány firewall a virtuální sítě.
2. V 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 dat z Azure Portal. Můžete také přidat rozsah IP adres.
4. Vyberte Uložit.

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

Vyhrazený Azure Synapse Analytics (pracovní prostor) SQL fond. Příjem dat do bez serveru SQL se v současné době nepodporuje.
Oprávnění k zápisu do fondu SQL v pracovním prostoru Synapse, který je k dispozici v Microsoft.Synapse/workspaces/sqlPools/write. Toto oprávnění existuje v roli Přispěvatel.
Oprávnění Data Share prostředku služby pro přístup k pracovnímu prostoru Synapse SQL fondu. Můžete to provést pomocí následujících kroků:
1. V Azure Portal přejděte do pracovního prostoru Synapse. V SQL navigace vyberte Správce služby Active Directory a nastavte se jako Azure Active Directory správce.
2. Otevřete Synapse Studio a v levém navigačním panelu vyberte Manage (Spravovat). V části Zabezpečení vyberte Řízení přístupu. Přiřaďte sami SQL roli správce nebo správce pracovního prostoru.
3. V Synapse Studio levém navigačním panelu vyberte Vývoj. Spuštěním následujícího skriptu ve SQL přidejte spravovanou identitu prostředku 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>";
```
  Všimněte si,<share_acc_name> je název vašeho prostředku Data Share. Pokud jste ještě nevytyčili prostředek Data Share, můžete se k tomuto předpokladu 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. V Azure Portal přejděte do pracovního prostoru Synapse. V levém navigačním panelu vyberte Brány firewall.
2. V možnosti Povolit službám a prostředkům Azure přístup k tomuto pracovnímu prostoru vyberte ON .)
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 dat z Azure Portal. Můžete také přidat rozsah IP adres.
4. Vyberte Uložit.

Příjem dat do Azure Data Explorer clusteru:

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

Přihlaste se k webu Azure Portal.

Otevřít pozvánku

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

Pokud chcete otevřít pozvánku z e-mailu, podívejte se do doručené pošty, abyste získali pozvánku od svého poskytovatele dat. Pozvánka pochází z Microsoft Azure s názvem Azure Data Share pozvánky yourdataprovider@domain.com z . Výběrem možnosti Zobrazit pozvánku zobrazíte pozvánku v Azure.

Pokud chcete pozvánku otevřít přímo Azure Portal, vyhledejte v Data Share pozvánky v Azure Portal. Tato akce vás zavede do seznamu Data Share pozvánek.

Pokud jste uživatelem tenanta jako host, budete vyzváni k ověření e-mailové adresy tenanta před prvním zobrazením Data Share pozvánky. Po ověření je platnost 12 měsíců.
Vyberte pozvánku, kterou chcete zobrazit.

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

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

V nástroji použijte prostředí Bash Azure Cloud Shell.
Pokud tomu dáváte přednost, můžete nainstalovat Azure CLI a spouštět referenční příkazy CLI.
- 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í jsou popsané 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 zobrazte aktuální pozvánky:

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

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

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

pokud se rozhodnete použít Azure PowerShell lokálně:
- Nainstalujte modul AZ PowerShell.
- pomocí rutiny Připojení-AzAccount Připojení k účtu Azure.
Pokud se rozhodnete použít Azure Cloud Shell:
- Další informace najdete v tématu přehled Azure Cloud Shell .

Pomocí příkazu Připojení-AzAccount se připojte ke svému účtu Azure.
```
Connect-AzAccount
```
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]
```
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řijetí pozvánky

Zkontrolujte všechna pole, včetně podmínek použití. Pokud souhlasíte s podmínkami použití, budete muset zaškrtnout políčko, abyste naznačili, že souhlasíte.
V části cílový účet sdílení dat vyberte předplatné a skupinu prostředků, do které budete nasazovat sdílenou složku.

V poli účet pro sdílení dat vyberte vytvořit novou , pokud nemáte existující účet pro sdílení dat. V opačném případě vyberte existující účet pro sdílení dat, do kterého chcete vaši sdílenou složku přijmout.

V poli přijatý název sdílené složky můžete ponechat výchozí hodnotu zadanou daty nebo zadat nový název přijaté sdílené složky.

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

Tato akce přejde k přijaté sdílené složce v účtu pro sdílení dat.

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

Pomocí příkazu AZ datashare Consumer Share-Subscription Create vytvořte sdílenou složku dat.

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

Pomocí příkazu New-AzDataShareSubscription vytvořte sdílenou složku dat. InvitationId bude ID, které jste shromáždili v předchozím kroku.

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

Chcete-li nakonfigurovat, kde chcete přijímat data, postupujte podle následujících kroků.

Vyberte kartu datové sady . Zaškrtněte políčko vedle datové sady, ke které chcete přiřadit cíl. Vyberte možnost + mapovat na cíl a zvolte cílové úložiště dat.
Vyberte cílový typ úložiště dat, do kterého chcete data založit. Budou přepsány všechny datové soubory nebo tabulky v cílovém úložišti dat se stejnou cestou a názvem. pokud přidáváte data do Azure SQL Database nebo azure Synapse Analytics (dříve azure SQL DW), zaškrtněte políčko pro povolení sdílení dat pomocí výše uvedeného skriptu pro vytvoření uživatele v mém zastoupení.

V případě místního sdílení vyberte v zadaném umístění úložiště dat. Umístění je datové centrum Azure, kde se nachází zdrojové úložiště dat poskytovatele dat. Po namapování datové sady můžete pro přístup k datům sledovat odkaz v cílové cestě.
Pokud pro sdílení na základě snímků vytvořil poskytovatel dat plán snímků, který poskytuje pravidelnou aktualizaci dat, můžete také povolit plán snímků výběrem karty plán snímku . Zaškrtněte políčko vedle plánu snímku a vyberte + Povolit. Všimněte si, že první naplánovaný snímek začne do jedné minuty od časového plánu a následné snímky se spustí během několika sekund od naplánovaného času.

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

Spuštěním příkazu AZ datashare Consumer Share-Subscription list-source-DataSet Získejte ID datové sady:

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"

Spuštěním příkazu AZ Storage Account Create vytvořte účet úložiště pro tuto sdílenou složku dat:

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

Pomocí příkazu AZ Storage Account show Získejte ID účtu úložiště:

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

ID objektu zabezpečení účtu získáte pomocí následujícího příkazu:

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

Pomocí příkazu AZ role Assignment Create vytvořte přiřazení role pro hlavní povinný účet:

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

Vytvořte proměnnou pro mapování na základě ID datové sady:

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

Pomocí příkazu AZ datashare Consumer DataSet-Mapping Create vytvořte mapování datové sady:

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

Spuštěním příkazu AZ datashare Consumer Share-Subscription Synchronization spusťte synchronizaci datových sad.

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

Spuštěním příkazu AZ datashare Consumer Share-Subscription Synchronization list zobrazíte seznam synchronizací:

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

Pomocí příkazu AZ datashare Consumer Share-Subscription list-source-Share-Synchronization- Settings zobrazte nastavení synchronizace nastavené ve sdílené složce.

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

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

Spuštěním příkazu Get-AzDataShareSourceDataSet Získejte ID datové sady:

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

Pokud ještě nemáte umístění, kam chcete ukládat sdílená data, můžete pomocí těchto kroků vytvořit účet úložiště. Pokud již máte úložiště, 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. Spusťte příkaz set-AzStorageBlobContent pro nahrání souboru. Následující příklad nahraje textfile.csv ze složky D:\testFiles v místní paměti do vytvořeného kontejneru.
```
Set-AzStorageBlobContent -File "D:\testFiles\textfile.csv" -Container $containerName -Blob "textfile.csv" -Context $ctx
```
další informace o práci s Azure Storage v prostředí powershell najdete v tomto Azure Storage příručce k prostředí powershell.
Pomocí příkazu Get-AzStorageAccount Získejte ID účtu úložiště:
```
Get-AzStorageAccount -ResourceGroupName <String> -Name <String>
```

Použijte ID datové sady 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>

Spusťte příkaz Start-AzDataShareSubscriptionSynchronization a spusťte synchronizaci datové sady.

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

Spuštěním příkazu Get-AzDataShareSubscriptionSynchronization zobrazte seznam 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

Tyto kroky platí pouze pro sdílení na základě snímků.

Snímek můžete aktivovat výběrem karty Podrobnosti a snímku triggeru. Tady můžete aktivovat úplný nebo přírůstkový snímek dat. Pokud data od poskytovatele dat přijímáte poprvé, vyberte možnost úplné kopírování.
Po úspěšném stavu posledního spuštění přejdete do cílového úložiště dat a zobrazíte přijatá data. Vyberte datové sady a vyberte odkaz v cílové cestě.

Spusťte příkaz AZ datashare Consumer Trigger Create a aktivujte snímek:

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

Poznámka

Tento příkaz použijte pouze pro sdílení na základě snímků.

Tyto kroky platí pouze 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>

Zobrazení historie

Tento krok platí jenom pro sdílení na základě snímků. Chcete-li zobrazit historii snímků, vyberte kartu Historie . Tady najdete historii všech snímků, které se vygenerovaly za posledních 30 dní.

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

Pokud už prostředek nepotřebujete, přejdete na stránku s přehledem sdílení dat a výběrem Odstranit ho odeberete.

Další kroky

V tomto kurzu jste zjistili, jak přijmout a získat sdílenou složku Azure Data. Další informace o konceptech Azure Data Share najdete v terminologii Azure Data Share.

Koncepty Azure Data Share

Kurz: Přijetí a získání dat prostřednictvím služby Azure Data Share

Ohodnoťte vaše zkušenosti