Samouczek: udostępnianie danych przy użyciu usługi Azure Data Share

Important

Azure Data Share jest wycofywany. Nie możesz już tworzyć nowych kont Azure Data Share, a istniejące funkcje pozostaną w trybie utrzymania do 12 listopada 2029 roku. Aby poznać harmonogram wycofania, wskazówki dotyczące przejścia oraz zalecane kolejne kroki, zobacz ogłoszenie o wycofaniu Azure Data Share.

W tym samouczku nauczysz się, jak skonfigurować nowe udostępnianie danych w Azure i rozpocząć udostępnianie danych klientom i partnerom spoza Twojej organizacji w Azure.

W tym poradniku nauczysz się, jak:

• Utwórz Data Share.
• Dodaj zestawy danych do usługi Data Share.
• Włącz harmonogram migawek dla Data Share.
• Dodaj odbiorców do usługi Data Share.

Wymagania wstępne

• Subskrypcja platformy Azure: jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto .
• Adres e-mail odbiorcy platformy Azure (użycie aliasu e-mail nie zadziała).
• Jeśli źródłowy magazyn danych platformy Azure znajduje się w innej subskrypcji platformy Azure niż ten, którego użyjesz do utworzenia zasobu usługi Data Share, zarejestruj dostawcę zasobów Microsoft.DataShare w subskrypcji, w której znajduje się magazyn danych platformy Azure.

Udostępnianie z konta magazynu danych

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

Udostępnianie ze źródła opartego na języku SQL

Poniżej znajduje się lista wymagań wstępnych dotyczących udostępniania danych ze źródła SQL.

Wymagania wstępne dotyczące udostępniania z 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) z tabelami i widokami, które chcesz udostępnić.
• Uprawnienie do zapisu w bazach danych na serwerze SQL, które jest obecne w Microsoft.Sql/servers/databases/write. To uprawnienie istnieje w roli Współautor.
• Microsoft Entra Administrator serwera SQL
• Dostęp do zapory programu SQL Server. Można to zrobić, wykonując następujące czynności:
  1. W witrynie Azure portal przejdź do serwera SQL. Wybierz pozycję Zapory i sieci wirtualne w obszarze nawigacji po lewej stronie.
  2. Wybierz pozycję Tak dla opcji Zezwalaj 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 wymagać powtórzenia następnym razem, gdy będziesz udostępniać dane SQL w portalu Azure. Można również dodać zakres adresów IP.
  4. Wybierz pozycję Zapisz.

Wymagania wstępne dotyczące udostępniania z puli SQL usługi Azure Synapse Analytics (obszar roboczy)

• • Dedykowana pula SQL usługi Azure Synapse Analytics (obszar roboczy) z tabelami, które chcesz udostępnić. Udostępnianie widoku nie jest obecnie obsługiwane. Udostępnianie z bezserwerowej puli SQL nie jest obecnie obsługiwane.

• Uprawnienie do zapisu w puli SQL w obszarze roboczym usługi Synapse, obecne w Microsoft.Synapse/workspaces/sqlPools/write. To uprawnienie istnieje w roli Contributor.

• Uprawnienie dla tożsamości zarządzanej zasobu usługi Data Share w celu uzyskania dostępu do puli SQL obszaru roboczego usługi Synapse. Można to zrobić, wykonując następujące czynności:

  1. W portalu Azure przejdź do obszaru roboczego usługi Synapse. Wybierz pozycję Administrator usługi SQL Active Directory z lewej nawigacji i ustaw siebie jako Microsoft Entra admin.

  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ę SQL admin lub Workspace admin.

  3. W programie Synapse Studio wybierz pozycję Develop (Programowanie ) w obszarze nawigacji po lewej stronie. Wykonaj następujący skrypt w puli SQL, aby dodać tożsamość zarządzaną zasobu usługi Data Share jako db_datareader.

     create user "<share_acct_name>" from external provider;     
     exec sp_addrolemember db_datareader, "<share_acct_name>"; 
     

     Share_acc_name <> to nazwa 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 usługi 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ę Zapory w obszarze nawigacji po lewej stronie.
  2. Wybierz opcję WŁ. dla ustawienia Zezwalaj usługom i zasobom 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 wymagać powtórzenia następnym razem, gdy będziesz udostępniać dane SQL w witrynie Azure Portal. Można również dodać zakres adresów IP.
  4. Wybierz pozycję Zapisz.

Udostępnianie z usługi Azure Data Explorer

• Klaster usługi Azure Data Explorer z bazami danych, które chcesz udostępnić.
• Uprawnienie do zapisu w klastrze usługi Azure Data Explorer, które jest obecne w Microsoft.Kusto/clusters/write. To uprawnienie istnieje w roli Współautor.

Zaloguj się do portalu Azure.

Zaloguj się w witrynie Azure Portal.

Tworzenie konta udziału danych

Portal

Utwórz zasób usługi Azure Data Share w grupie zasobów platformy Azure.

1. Wybierz przycisk menu w lewym górnym rogu portalu, a następnie wybierz pozycję Utwórz zasób (+).

2. Wyszukaj Data Share.

3. Wybierz pozycję Data Share i wybierz pozycję Utwórz.

4. Wypełnij podstawowe informacje dotyczące zasobu usługi Azure Data Share, podając następujące informacje.

   Ustawienie	Wartość sugerowana	Opis pola
   Subskrypcja	Twoja subskrypcja	Wybierz subskrypcję platformy Azure, której chcesz użyć dla konta usługi Data Share.
   Grupa zasobów	testresourcegroup	Użyj istniejącej grupy zasobów lub utwórz nową grupę zasobów.
   Lokalizacja	East US 2	Wybierz region dla konta Data Share.
   Nazwa	datashareaccount	Określ nazwę konta Data Share.

5. Wybierz pozycję Przejrzyj i utwórz, a następnie pozycję Utwórz , aby utworzyć konto udziału danych. Utworzenie nowego konta usługi Data Share zwykle zajmuje około 2 minut lub mniej.

6. Po zakończeniu wdrażania wybierz Przejdź do zasobu.

Azure CLI

Utwórz zasób usługi Azure Data Share w grupie zasobów platformy Azure.

Rozpocznij od przygotowania środowiska dla Azure CLI:

• Użyj środowiska powłoki Bash w usłudze 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 platformy Docker.

  • Jeśli korzystasz z instalacji lokalnej, zaloguj się do Azure CLI przy użyciu polecenia az login. Aby ukończyć proces uwierzytelniania, wykonaj kroki wyświetlane w terminalu. Aby uzyskać inne opcje logowania, zobacz Uwierzytelnianie na platformie Azure przy użyciu interfejsu wiersza polecenia platformy Azure.

  • Po wyświetleniu monitu zainstaluj rozszerzenie Azure CLI podczas pierwszego użycia. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Używanie rozszerzeń i zarządzanie nimi za pomocą interfejsu wiersza polecenia platformy Azure.

  • Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby zaktualizować do najnowszej wersji, uruchom polecenie az upgrade.

Użyj tych poleceń, aby utworzyć zasób:

1. Użyj polecenia az account set, aby ustawić subskrypcję jako bieżącą subskrypcję domyślną:

   az account set --subscription 00000000-0000-0000-0000-000000000000
   

2. Uruchom polecenie az provider register, aby zarejestrować dostawcę zasobów:

   az provider register --name "Microsoft.DataShare"
   

3. Uruchom polecenie az group create, aby utworzyć grupę zasobów lub użyć istniejącej grupy zasobów:

   az group create --name testresourcegroup --location "East US 2"
   

4. Uruchom polecenie az datashare account create, aby utworzyć konto usługi Data Share:

   az datashare account create --resource-group testresourcegroup --name datashareaccount --location "East US 2" 
   

   Uruchom polecenie az datashare account list, aby wyświetlić konta usługi Data Share:

   az datashare account list --resource-group testresourcegroup
   

PowerShell

Utwórz zasób usługi Azure Data Share w grupie zasobów platformy Azure.

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

• Jeśli zdecydujesz się używać programu Azure PowerShell lokalnie:
  • Zainstaluj najnowszą wersję modułu PowerShell Az.
  • Połącz się ze swoim kontem Azure za pomocą 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 tych poleceń, aby utworzyć zasób:

1. Użyj polecenia Connect-AzAccount, aby nawiązać połączenie z kontem platformy Azure.

   Connect-AzAccount
   

2. Uruchom polecenie Set-AzContext, aby ustawić poprawną subskrypcję, jeśli masz wiele subskrypcji.

   Set-AzContext [SubscriptionID/SubscriptionName]
   

3. Uruchom polecenie New-AzResourceGroup, aby utworzyć grupę zasobów, lub możesz użyć istniejącej grupy zasobów:

   New-AzResourceGroup -Name <String> -Location <String>
   

4. Uruchom polecenie New-AzDataShare, aby utworzyć konto Data Share:

    New-AzDataShareAccount -ResourceGroupName <String> -Name <String> -Location <String>
   

   Uruchom polecenie Get-AzDataShareAccount, aby wyświetlić konta usługi Data Share:

   Get-AzDataShareAccount
   

Utwórz udział

Portal

1. Przejdź do strony Przegląd Data Share.

   

2. Wybierz pozycję Rozpocznij udostępnianie danych.

3. Wybierz pozycję Utwórz.

4. Wypełnij szczegóły zasobu udostępnionego. Określ nazwę, typ udziału, opis zawartości udziału i warunki użytkowania (opcjonalnie).

   

5. Wybierz Kontynuuj.

6. Aby dodać zestawy danych do udziału, wybierz pozycję Dodaj zestawy danych.

   

7. Wybierz typ zestawu danych, który chcesz dodać. Zobaczysz inną listę typów zestawów danych w zależności od wybranego w poprzednim kroku typu udziału (migawka lub na miejscu). Jeśli korzystasz z udostępniania danych z usługi Azure SQL Database lub Azure Synapse Analytics (dawniej Azure SQL DW), zostanie wyświetlony monit o podanie metody uwierzytelniania w celu wyświetlenia listy tabel. Wybierz pozycję Uwierzytelnianie firmy Microsoft Entra i zaznacz pole wyboru Zezwalaj usłudze Data Share na uruchomienie powyższego skryptu „utwórz użytkownika” w moim imieniu.

   

8. Przejdź do obiektu, który chcesz udostępnić, i wybierz pozycję "Dodaj zestawy danych".

   

9. Na karcie Odbiorcy wprowadź adresy e-mail Konsumenta danych, wybierając pozycję „+ Dodaj adresata”.

   

10. Wybierz Kontynuuj.

11. Jeśli wybrano typ udostępniania migawek, możesz skonfigurować harmonogram migawek w celu udostępnienia aktualizacji danych odbiorcy danych.

    

12. Wybierz czas rozpoczęcia i interwał cyklu.

13. Wybierz Kontynuuj.

14. Na karcie Przegląd + tworzenie przejrzyj zawartość pakietu, ustawienia, adresatów i ustawienia synchronizacji. Wybierz pozycję Utwórz.

Azure CLI

1. Uruchom polecenie az storage account create, aby utworzyć konto usługi Storage dla tej usługi Data Share:

   az storage account create --resource-group testresourcegroup --name ContosoMarketplaceAccount
   

2. Użyj polecenia az storage container create, aby utworzyć kontener w koncie magazynu utworzonym w poprzednim poleceniu:

   az storage container create --name ContosoMarketplaceContainer --account-name ContosoMarketplaceAccount
   

3. Uruchom polecenie az datashare create, aby utworzyć udział danych:

   az datashare create --resource-group testresourcegroup \
     --name ContosoMarketplaceDataShare --account-name ContosoMarketplaceAccount \
     --description "Data Share" --share-kind "CopyBased" --terms "Confidential"
   

4. Użyj polecenia az datashare invitation create, aby utworzyć zaproszenie dla podanego adresu:

   az datashare invitation create --resource-group testresourcegroup \
     --name DataShareInvite --share-name ContosoMarketplaceDataShare \
     --account-name ContosoMarketplaceAccount --target-email "jacob@fabrikam.com"
   

PowerShell

1. Jeśli nie masz jeszcze danych, które chcesz udostępnić, możesz wykonać poniższe czynności, aby utworzyć konto magazynu. Jeśli masz już usługę Storage, możesz przejść do kroku 2.

   1. Uruchom polecenie New-AzStorageAccount, aby utworzyć konto usługi Azure Storage:

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

   2. Uruchom polecenie New-AzStorageContainer, aby utworzyć kontener w Twoim nowym koncie usługi Azure Storage, który będzie przechowywać Twoje dane:

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

   3. Uruchom polecenie Set-AzStorageBlobContent, aby przesłać 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.

2. Uruchom polecenie New-AzDataShare, aby utworzyć Data Share:

   New-AzDataShare -ResourceGroupName <String> -AccountName <String> -Name <String> -Description <String> -TermsOfUse <String>
   

3. Użyj polecenia New-AzDataShareInvitation, aby utworzyć zaproszenie dla określonego adresu:

   New-AzDataShareInvitation -ResourceGroupName <String> -AccountName <String> -ShareName <String> -Name <String> -TargetEmail <String>
   

4. Użyj polecenia New-AzDataShareSynchronizationSetting, aby ustawić cykl synchronizacji dla udziału. Może to być codziennie, co godzinę lub w określonym czasie.

   New-AzDataShareSynchronizationSetting -ResourceGroupName <String> -AccountName <String> -ShareName <String> -Name <String> -RecurrenceInterval <String> -SynchronizationTime <DateTime>
   

Uwaga: Azure Data Share używa czasu UTC (uniwersalnego czasu koordynowanego) we wszystkich zaplanowanych operacjach, w tym harmonogramach migawek. Upewnij się, że odpowiednio dostosujesz czas lokalny podczas ustawiania harmonogramu.

Usługa Azure Data Share została utworzona, a odbiorca usługi Data Share jest teraz gotowy do zaakceptowania zaproszenia.

Oczyszczanie zasobów

Gdy zasób nie jest już potrzebny, przejdź do strony Data Share Overview i wybierz pozycję Usuń, aby go usunąć.

Następny krok

W tym samouczku przedstawiono sposób tworzenia usługi Azure Data Share i zapraszania adresatów. Aby dowiedzieć się, jak użytkownik danych może zaakceptować i otrzymać element Data Share, przejdź do samouczka akceptowania i odbierania danych.

Samouczek: Akceptuj i odbieraj dane za pomocą Azure Data Share