Szybki start: tworzenie obszaru roboczego usługi Azure Synapse Analytics przy użyciu interfejsu wiersza polecenia platformy Azure

Interfejs wiersza polecenia Azure to narzędzie do zarządzania zasobami Azure. Można używać go w przeglądarce za pośrednictwem usługi Azure Cloud Shell. Istnieje także możliwość zainstalowania go w systemach macOS, Linux lub Windows, a następnie uruchomienia z poziomu wiersza polecenia.

Z tego przewodnika Szybki start dowiesz się, jak utworzyć obszar roboczy usługi Azure Synapse Analytics przy użyciu interfejsu wiersza polecenia platformy Azure.

Jeśli nie masz jeszcze konta platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Wymagania wstępne

• Pobierz i zainstaluj procesor jq, lekki i elastyczny procesor JSON wiersza polecenia.

• Konto magazynu Azure Data Lake Storage Gen2.

  Ważne

  Obszar roboczy usługi Azure Synapse Analytics musi mieć możliwość odczytu i zapisu na wybranym koncie usługi Data Lake Storage Gen2. Ponadto w przypadku dowolnego konta magazynu, które łączysz jako podstawowe konto magazynu, należy włączyć hierarchiczną przestrzeń nazw podczas tworzenia konta magazynu, zgodnie z opisem w temacie Tworzenie konta magazynu.

• Użyj środowiska Bash w środowisku 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 interfejs wiersza polecenia platformy Azure. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie interfejsu wiersza polecenia platformy Azure w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić interfejs wiersza polecenia platformy Azure w kontenerze platformy Docker.

  • Jeśli korzystasz z instalacji lokalnej, zaloguj się do interfejsu wiersza polecenia platformy Azure za pomocą 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.

  • Gdy pojawi się monit, 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 polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.

Tworzenie obszaru roboczego usługi Azure Synapse Analytics przy użyciu interfejsu wiersza polecenia platformy Azure

1. Zdefiniuj niezbędne zmienne środowiskowe, aby utworzyć zasoby dla obszaru roboczego usługi Azure Synapse Analytics.

   Nazwa zmiennej środowiskowej	Opis
   NazwaKontaPrzechowywania	Nazwa konta magazynowego w usłudze Data Lake Storage Gen2.
   StorageAccountResourceGroup	Nazwa istniejącej grupy zasobów konta magazynu usługi Data Lake Storage Gen2.
   NazwaUdostępnianiaPlików	Nazwa istniejącego systemu plików przechowywania.
   SynapseResourceGroup	Wybierz nową nazwę grupy zasobów usługi Azure Synapse Analytics.
   Rejon	Wybierz jeden z regionów świadczenia usługi Azure.
   NazwaPrzestrzeniRoboczejSynapse	Wybierz unikatową nazwę nowego obszaru roboczego usługi Azure Synapse Analytics.
   SqlUser	Wybierz wartość nowej nazwy użytkownika.
   SqlPassword	Wybierz bezpieczne hasło.

2. Utwórz grupę zasobów jako kontener dla obszaru roboczego usługi Azure Synapse Analytics:

   az group create --name $SynapseResourceGroup --location $Region
   

3. Tworzenie obszaru roboczego usługi Azure Synapse Analytics:

   az synapse workspace create \
     --name $SynapseWorkspaceName \
     --resource-group $SynapseResourceGroup \
     --storage-account $StorageAccountName \
     --file-system $FileShareName \
     --sql-admin-login-user $SqlUser \
     --sql-admin-login-password $SqlPassword \
     --location $Region
   

4. Pobierz adresy URL sieci Web i deweloperskie dla obszaru roboczego usługi Azure Synapse Analytics:

   WorkspaceWeb=$(az synapse workspace show --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup | jq -r '.connectivityEndpoints | .web')
   
   WorkspaceDev=$(az synapse workspace show --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup | jq -r '.connectivityEndpoints | .dev')
   

5. Utwórz regułę zapory, aby zezwolić na dostęp do obszaru roboczego usługi Azure Synapse Analytics z komputera:

   ClientIP=$(curl -sb -H "Accept: application/json" "$WorkspaceDev" | jq -r '.message')
   ClientIP=${ClientIP##'Client Ip address : '}
   echo "Creating a firewall rule to enable access for IP address: $ClientIP"
   
   az synapse workspace firewall-rule create --end-ip-address $ClientIP --start-ip-address $ClientIP --name "Allow Client IP" --resource-group $SynapseResourceGroup --workspace-name $SynapseWorkspaceName
   

6. Otwórz internetowy adres URL obszaru roboczego usługi Azure Synapse Analytics przechowywany w zmiennej środowiskowej WorkspaceWeb , aby uzyskać dostęp do obszaru roboczego:

   echo "Open your Azure Synapse Workspace Web URL in the browser: $WorkspaceWeb"
   

   

7. Po wdrożeniu wymagane są więcej uprawnień:

   • W portalu Azure przypisz innych użytkowników obszaru roboczego do roli Współtwórca w obszarze roboczym. Aby uzyskać więcej informacji, zobacz przypisywanie ról Azure za pomocą portalu Azure.
   • Przypisz innym użytkownikom odpowiednie role kontroli dostępu opartej na rolach usługi Azure Synapse Analytics przy użyciu programu Synapse Studio.
   • Posiadający rolę Właściciela konta usługi Azure Storage musi nadać rolę Współautora danych obiektów Blob w usłudze Storage dla zarządzanej tożsamości usługi obszaru roboczego Azure Synapse Analytics i innych użytkowników.

Czyszczenie zasobów

Wykonaj następujące kroki, aby usunąć obszar roboczy usługi Azure Synapse Analytics.

Ostrzeżenie

Usunięcie obszaru roboczego Azure Synapse Analytics powoduje likwidację silników analitycznych oraz usunięcie danych przechowywanych w bazie danych powiązanych pul SQL oraz metadanych obszaru roboczego. Połączenie z punktami końcowymi SQL lub Apache Spark nie będzie już możliwe. Wszystkie artefakty kodu zostaną usunięte (zapytania, notatniki, definicje zadań i przepływy).

Usunięcie obszaru roboczego nie wpłynie na dane na koncie usługi Data Lake Storage Gen2 połączonym z obszarem roboczym.

Jeśli chcesz usunąć obszar roboczy usługi Azure Synapse Analytics, wykonaj następujące polecenie:

az synapse workspace delete --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup

Powiązana zawartość

Następnie możesz utworzyć pule SQL lub utworzyć pule platformy Apache Spark, aby rozpocząć analizowanie i eksplorowanie danych.