Samouczek: akceptowanie i odbieranie danych — Azure Data Share

Z tego samouczka dowiesz się, jak zaakceptować zaproszenie do udostępniania danych przy użyciu usługi Azure Data Share. Dowiesz się, jak odbierać dane udostępniane Tobie oraz jak włączyć regularny interwał odświeżania, aby upewnić się, że zawsze masz najnowszą migawkę danych, które są Ci udostępniane.

Jak zaakceptować zaproszenie usługi Azure Data Share
Tworzenie konta usługi Azure Data Share
Określanie miejsca docelowego dla danych
Tworzenie subskrypcji udostępniania danych w celu zaplanowanego odświeżania

Wymagania wstępne

Przed zaakceptowaniem zaproszenia do udostępnienia danych, należy utworzyć pewne zasoby platformy Azure wymienione poniżej.

Przed zaakceptowaniem zaproszenia do udostępnienia danych upewnij się, że wszystkie warunki wstępne zostały spełnione.

Subskrypcja platformy Azure: jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto .
Zaproszenie do udostępniania danych: zaproszenie z platformy Microsoft Azure z tematem "Zaproszenie do usługi Azure Data Share z yourdataprovider@domain.com".
Zarejestruj dostawcę zasobów Microsoft.DataShare w subskrypcji platformy Azure, w której utworzysz zasób usługi Data Share i subskrypcję platformy Azure, w której znajdują się docelowe magazyny danych platformy Azure.

Odbieranie danych do konta magazynu

Konto usługi Azure Storage: jeśli jeszcze go nie masz, możesz utworzyć konto usługi Azure Storage.
Uprawnienie do zapisu na koncie magazynowym, które jest obecne w Microsoft.Storage/storageAccounts/write. To uprawnienie istnieje w roli Współtwórca konta magazynowania.
Uprawnienie do dodawania przypisania roli do konta magazynu, znajdujące się w Microsoft.Authorization/role assignments/write. To uprawnienie istnieje w roli Właściciel.

Odbieranie danych do obiektu docelowego opartego na języku SQL

Jeśli zdecydujesz się odbierać dane do usługi Azure SQL Database lub Azure Synapse Analytics, poniżej znajduje się lista wymagań wstępnych.

Wymagania wstępne dotyczące odbierania danych do usługi Azure SQL Database lub Azure Synapse Analytics (dawniej Azure SQL DW)

Usługa Azure SQL Database lub Azure Synapse Analytics (dawniej Azure SQL DW).
Uprawnienie do zapisywania w bazach danych na serwerze SQL, który znajduje się w programie Microsoft.Sql/servers/databases/write. To uprawnienie istnieje w roli Współautor .
Microsoft Entra Admin programu SQL Server
Dostęp do zapory programu SQL Server. Można to zrobić, wykonując następujące czynności:
1. W programie SQL Server w witrynie Azure Portal przejdź do pozycji Zapory i sieci wirtualne
2. Wybierz pozycję Tak , aby zezwalać usługom i zasobom platformy Azure na dostęp do tego serwera.
3. Wybierz pozycję +Dodaj adres IP klienta. Adres IP klienta może ulec zmianie. Ten proces może być powtarzany przy następnym udostępnianiu danych SQL z witryny Azure Portal. Można również dodać zakres adresów IP.
4. Wybierz Zapisz.

Wymagania wstępne dotyczące odbierania danych do puli SQL usługi Azure Synapse Analytics (obszaru roboczego)

Dedykowana pula SQL usługi Azure Synapse Analytics (obszar roboczy). Odbieranie danych do bezserwerowej puli SQL nie jest obecnie obsługiwane.
Uprawnienie do zapisu w puli SQL w obszarze roboczym Synapse, znajdującego się w Microsoft.Synapse/workspaces/sqlPools/write. To uprawnienie istnieje w roli Współautor .
Uprawnienie dla tożsamości zarządzanej zasobu Data Share na dostęp do puli SQL w obszarze roboczym Synapse. Można to zrobić, wykonując następujące czynności:
1. W witrynie Azure Portal przejdź do obszaru roboczego usługi Synapse. Wybierz pozycję Microsoft Entra admin z lewej nawigacji i ustaw siebie jako administrator firmy Microsoft Entra.
2. Otwórz program Synapse Studio, wybierz pozycję Zarządzaj w obszarze nawigacji po lewej stronie. Wybierz pozycję Kontrola dostępu w obszarze Zabezpieczenia. Przypisz sobie rolę administratora SQL lub administratora obszaru roboczego .
3. W Synapse Studio wybierz pozycję Rozwijaj z lewego panelu nawigacyjnego. Wykonaj następujący skrypt w puli SQL, aby dodać tożsamość zarządzaną zasobu usługi 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<> jest nazwą zasobu usługi Data Share. Jeśli nie utworzono jeszcze zasobu usługi Data Share, możesz wrócić do tego wymagania wstępnego później.
Dostęp do zapory obszaru roboczego Synapse. Można to zrobić, wykonując następujące czynności:
1. W witrynie Azure Portal przejdź do obszaru roboczego usługi Synapse. Wybierz Zapory z nawigacji z lewej.
2. Wybierz pozycję WŁ.w obszarze Zezwalaj usługom i zasobom platformy Azure na dostęp do tego obszaru roboczego.
3. Wybierz pozycję +Dodaj adres IP klienta. Adres IP klienta może ulec zmianie. Ten proces może być powtarzany przy następnym udostępnianiu danych SQL z witryny Azure Portal. Można również dodać zakres adresów IP.
4. Wybierz Zapisz.

Odbieranie danych do klastra usługi Azure Data Explorer:

Klaster usługi Azure Data Explorer w tym samym centrum danych platformy Azure co klaster eksploratora danych dostawcy danych: jeśli jeszcze go nie masz, możesz utworzyć klaster usługi Azure Data Explorer. Jeśli nie znasz centrum danych platformy Azure klastra dostawcy danych, możesz utworzyć klaster w dalszej części procesu.
Uprawnienie do zapisu w klastrze usługi Azure Data Explorer, który jest dostępny pod Microsoft.Kusto/clusters/write. To uprawnienie istnieje w roli Współautor.

Zaloguj się do witryny Azure Portal.

Otwórz zaproszenie

Możesz otworzyć zaproszenie pocztą e-mail lub bezpośrednio w witrynie Azure Portal.

Aby otworzyć zaproszenie z e-maila, sprawdź skrzynkę odbiorczą, aby znaleźć zaproszenie od dostawcy danych. Zaproszenie pochodzi z platformy Microsoft Azure zatytułowanej Zaproszenie do usługi Azure Data Share z witryny yourdataprovider@domain.com. Wybierz pozycję Wyświetl zaproszenie , aby zobaczyć zaproszenie na platformie Azure.

Aby otworzyć zaproszenie bezpośrednio z witryny Azure Portal, wyszukaj pozycję Zaproszenia do udostępniania danych w witrynie Azure Portal. Ta akcja powoduje przejście do listy zaproszeń do wymiany danych.

Jeśli jesteś użytkownikiem-gościem dzierżawy, zostanie wyświetlony monit o zweryfikowanie adresu e-mail dzierżawy przed wyświetleniem zaproszenia do udziału danych po raz pierwszy. Po zweryfikowaniu jego ważność trwa 12 miesięcy.
Wybierz zaproszenie, które chcesz wyświetlić.

Przygotuj środowisko Azure CLI, a następnie wyświetl swoje zaproszenia.

Rozpocznij od przygotowania środowiska dla interfejsu wiersza polecenia platformy Azure:

Użyj środowiska Bash w Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Get started with Azure Cloud Shell.
Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj Azure CLI. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie Azure CLI w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić Azure CLI w kontenerze Docker.
- Jeśli korzystasz z instalacji lokalnej, zaloguj się do Azure CLI za pomocą polecenia az login. Aby zakończyć proces uwierzytelniania, wykonaj kroki wyświetlane na Twoim terminalu. Aby uzyskać inne opcje logowania, zobacz Uwierzytelnianie na platformie Azure przy użyciu interfejsu wiersza polecenia platformy Azure.
- Gdy zostaniesz o to poproszony/a, zainstaluj rozszerzenie Azure CLI przy pierwszym użyciu. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Używanie rozszerzeń i zarządzanie nimi za pomocą interfejsu wiersza polecenia platformy Azure.
- Uruchom az version, aby sprawdzić zainstalowaną wersję i biblioteki zależne. Aby zaktualizować do najnowszej wersji, uruchom az upgrade.

Uruchom polecenie az datashare consumer-invitation list-invitation, aby wyświetlić bieżące zaproszenia:

az datashare consumer-invitation list-invitation

Skopiuj identyfikator zaproszenia do użycia w następnej sekcji.

Zacznij od przygotowania środowiska do programu PowerShell. Polecenia programu PowerShell można uruchamiać lokalnie lub w środowisku Bash w usłudze Azure Cloud Shell.

Jeśli zdecydujesz się używać programu Azure PowerShell lokalnie:
- Zainstaluj najnowszą wersję modułu Az programu PowerShell.
- Połącz się z kontem platformy Azure przy użyciu polecenia cmdlet Connect-AzAccount .
Jeśli zdecydujesz się używać usługi Azure Cloud Shell:
- Aby uzyskać więcej informacji, zobacz Omówienie usługi Azure Cloud Shell .

Użyj polecenia Connect-AzAccount , aby nawiązać połączenie z kontem platformy Azure.
```
Connect-AzAccount
```
Uruchom polecenie Set-AzContext , aby ustawić poprawną subskrypcję, jeśli masz wiele subskrypcji.
```
Set-AzContext [SubscriptionID/SubscriptionName]
```
Uruchom polecenie Get-AzDataShareReceivedInvitation , aby wyświetlić bieżące zaproszenia:
```
Get-AzDataShareReceivedInvitation
```

Skopiuj identyfikator zaproszenia do użycia w następnej sekcji.

Zaakceptuj zaproszenie

Upewnij się, że wszystkie pola są przeglądane, w tym warunki użytkowania. Jeśli zgadzasz się na warunki użytkowania, musisz zaznaczyć pole wyboru, aby wskazać, że zgadzasz się.
W obszarze Docelowe konto udostępniania danych wybierz subskrypcję i grupę zasobów, w której będziesz wdrażać udostępnianie danych.

W polu Data Share Account wybierz Utwórz nowe, jeśli nie masz istniejącego konta Data Share. W przeciwnym razie wybierz istniejące konto Data Share, do którego chcesz przyjąć swój udział danych.

W polu Nazwa odebranego udziału można pozostawić wartość domyślną określoną przez podane dane lub określić nową nazwę odebranego udziału.

Po zaakceptowaniu warunków użytkowania i określeniu konta usługi Data Share do zarządzania odebranym udziałem wybierz pozycję Akceptuj i skonfiguruj. Zostanie utworzona subskrypcja udziału.

Ta akcja spowoduje przejście do otrzymanego zasobu na koncie usługi Data Share.

Jeśli nie chcesz zaakceptować zaproszenia, wybierz pozycję Odrzuć.

Użyj polecenia az datashare share-subscription create , aby utworzyć udział danych.

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"

Użyj polecenia New-AzDataShareSubscription , aby utworzyć udział danych. "InvitationId będzie identyfikatorem zebranym z poprzedniego kroku."

New-AzDataShareSubscription -ResourceGroupName share-rg -AccountName FabrikamDataShareAccount -Name "Fabrikam Solutions" -InvitationId "89abcdef-0123-4567-89ab-cdef01234567"

Wykonaj poniższe kroki, aby skonfigurować miejsce odbierania danych.

Wybierz kartę Zestawy danych . Zaznacz pole wyboru obok zestawu danych, do którego chcesz przypisać miejsce docelowe. Wybierz + Mapuj do celu, aby wybrać docelowy magazyn danych.
Wybierz docelowy typ magazynu danych, w którym chcesz wylądować dane. Wszelkie pliki danych lub tabele w docelowym magazynie danych o tej samej ścieżce i nazwie zostaną zastąpione. Jeśli odbierasz dane do usługi Azure SQL Database lub Azure Synapse Analytics (dawniej Azure SQL DW), zaznacz pole wyboru Zezwalaj usłudze Data Share na uruchamianie powyższego skryptu "utwórz użytkownika" w moim imieniu.

W przypadku udostępniania w miejscu wybierz magazyn danych w określonej lokalizacji. Lokalizacja to centrum danych platformy Azure, w którym znajduje się źródłowy magazyn danych dostawcy danych. Po zamapowanym zestawie danych możesz skorzystać z linku w ścieżce docelowej, aby uzyskać dostęp do danych.
W przypadku udostępniania opartego na migawkach, jeśli dostawca danych utworzył harmonogram migawek w celu zapewnienia regularnej aktualizacji danych, możesz również włączyć harmonogram migawek, wybierając kartę Harmonogram migawek . Zaznacz pole wyboru obok harmonogramu migawek i wybierz pozycję + Włącz. Pierwsza zaplanowana migawka rozpocznie się w ciągu jednej minuty od czasu harmonogramu, a kolejne migawki zostaną uruchomione w ciągu kilku sekund od zaplanowanego czasu.

Metadane skopiowanych plików nie są utrwalane po każdym uruchomieniu. Jest to celowe.

Użyj tych poleceń, aby skonfigurować miejsce odbierania danych.

Uruchom polecenie az datashare consumer-source-data-set list , aby uzyskać identyfikator zestawu danych:

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

Jeśli potrzebujesz konta magazynowania, uruchom polecenie az storage account create , aby utworzyć konto magazynowania dla tego udostępniania danych.
```
az storage account create --resource-group "share-rg" --name "FabrikamDataShareStorageAccount" \
```

Użyj polecenia az storage account show , aby uzyskać identyfikator konta magazynu:

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

Użyj następującego polecenia, aby uzyskać identyfikator główny konta:

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

Użyj polecenia az role assignment create, aby utworzyć przypisanie roli dla głównego konta, używając identyfikatora głównego konta i identyfikatora twojego konta magazynu:

az role assignment create --role "Contributor" \
  --assignee-object-id aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 
  --assignee-principal-type ServicePrincipal --scope "your\storage\account\id\path"

Utwórz zmienną dla mapowania na podstawie identyfikatora zestawu danych z kroku 1:

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

Użyj polecenia az datashare data-set-mapping create, aby utworzyć mapowanie zestawu danych.

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

Uruchom polecenie az datashare share-subscription sync , aby rozpocząć synchronizację zestawów danych.

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

Uruchom polecenie az datashare share-subscription list-synchronization , aby wyświetlić listę synchronizacji:

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

Użyj polecenia az datashare share-subscription list-source-share-synchronization-setting , aby wyświetlić ustawienia synchronizacji ustawione w udziale.

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

Użyj tych poleceń, aby skonfigurować miejsce odbierania danych.

Uruchom polecenie Get-AzDataShareSourceDataSet , aby uzyskać identyfikator zestawu danych:

Get-AzDataShareSourceDataSet -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions"

Jeśli nie masz jeszcze lokalizacji, w której chciałbyś przechowywać udostępnione dane, możesz wykonać następujące kroki, aby utworzyć konto magazynowe. Jeśli masz już magazyn, możesz przejść do następnych kroków.
1. Uruchom polecenie New-AzStorageAccount , aby utworzyć konto usługi Azure Storage:
```
$storageAccount = New-AzStorageAccount -ResourceGroupName "share-rg" -AccountName FabrikamStorageAccount -Location "East US 2" -SkuName Standard_GRS

$ctx = $storageAccount.Context
```
2. Uruchom polecenie New-AzStorageContainer , aby utworzyć kontener na nowym koncie usługi Azure Storage, które będzie przechowywać dane:
```
$containerName = "StorageContainer"

New-AzStorageContainer -Name $containerName -Context $ctx -Permission blob
```
3. Uruchom polecenie Set-AzStorageBlobContent , aby przekazać plik. Poniższy przykład przekazuje textfile.csv z folderu D:\testFiles w pamięci lokalnej do utworzonego kontenera.
```
Set-AzStorageBlobContent -File "D:\testFiles\textfile.csv" -Container $containerName -Blob "textfile.csv" -Context $ctx
```
Aby uzyskać więcej informacji na temat pracy z usługą Azure Storage w programie PowerShell, postępuj zgodnie z tym przewodnikiem programu PowerShell usługi Azure Storage.

Użyj polecenia Get-AzStorageAccount , aby uzyskać identyfikator konta magazynu:

Get-AzStorageAccount -ResourceGroupName "share-rg" -Name FabrikamStorageAccount

Użyj identyfikatora zestawu danych z pierwszego kroku, a następnie uruchom polecenie New-AzDataShareDataSetMapping , aby utworzyć mapowanie zestawu danych:

New-AzDataShareDataSetMapping -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -Name "Fabrikam Solutions" -StorageAccountResourceId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"  -DataSetId "0123abcd-ef01-2345-6789-abcdef012345"  -Container "StorageContainer"

Uruchom polecenie Start-AzDataShareSubscriptionSynchronization , aby rozpocząć synchronizację zestawów danych.

Start-AzDataShareSubscriptionSynchronization -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -SynchronizationMode "Incremental"

Uruchom polecenie Get-AzDataShareSubscriptionSynchronization , aby wyświetlić listę synchronizacji:

Get-AzDataShareSubscriptionSynchronization -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions"

Użyj polecenia Get-AzDataShareSubscriptionSynchronizationDetail , aby wyświetlić ustawienia synchronizacji ustawione w udziale.

Get-AzDataShareSubscriptionSynchronizationDetail -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -SynchronizationId "a6ee5c8d-0ce0-485e-b2f2-966b187dc6c7"

Wyzwalanie migawki

Te kroki dotyczą tylko udostępniania opartego na migawkach.

Migawkę można wyzwolić, wybierając kartę Szczegóły, a następnie Wyzwolenie migawki. W tym miejscu możesz wyzwolić pełny lub przyrostowy zrzut danych. Jeśli po raz pierwszy otrzymujesz dane od dostawcy danych, wybierz pełną kopię.
Po pomyślnym zakończeniu ostatniego uruchomienia przejdź do docelowego magazynu danych, aby wyświetlić odebrane dane. Wybierz pozycję Zestawy danych i wybierz link w ścieżce docelowej.

Uruchom polecenie az datashare trigger create , aby wyzwolić migawkę:

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"

Te kroki dotyczą tylko udostępniania opartego na migawkach.

Uruchom polecenie New-AzDataShareTrigger , aby wyzwolić migawkę:

New-AzDataShareTrigger -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -Name "Fabrikam Solutions" -RecurrenceInterval "Day" -SynchronizationTime "2018-11-14T04:47:52.9614956Z"

Wyświetl historię

Ten krok dotyczy tylko udostępniania opartego na migawkach. Aby wyświetlić historię migawek, wybierz kartę Historia . W tym miejscu znajdziesz historię wszystkich migawek wygenerowanych w ciągu ostatnich 30 dni.

Uprzątnij zasoby

Gdy zasób nie jest już potrzebny, przejdź do strony Przegląd udziału danych i wybierz pozycję Usuń , aby go usunąć.

Dalsze kroki

W tym samouczku nauczyłeś się, jak akceptować i odbierać współdzielenie danych w Azure. Aby dowiedzieć się więcej na temat pojęć związanych z usługą Azure Data Share, przejdź do terminologii dotyczącej usługi Azure Data Share.

Pojęcia dotyczące usługi Azure Data Share

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-10-08