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

Interfejs wiersza polecenia platformy Azure to środowisko wiersza polecenia platformy Azure do zarządzania jej zasobami. 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 subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.

Wymagania wstępne

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

• Konto magazynu usługi 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 powłoki Bash w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący powłoki Bash w usłudze 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 Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure.

  • Po wyświetleniu monitu zainstaluj rozszerzenie interfejsu wiersza polecenia platformy Azure podczas pierwszego użycia. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Korzystanie z rozszerzeń w interfejsie 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
   StorageAccountName	Nazwa istniejącego konta magazynu usługi Data Lake Storage Gen2.
   StorageAccountResourceGroup	Nazwa istniejącej grupy zasobów konta magazynu usługi Data Lake Storage Gen2.
   FileShareName	Nazwa istniejącego systemu plików magazynu.
   SynapseResourceGroup	Wybierz nową nazwę grupy zasobów usługi Azure Synapse Analytics.
   Region (Region)	Wybierz jeden z regionów świadczenia usługi Azure.
   SynapseWorkspaceName	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 deweloperów 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 witrynie Azure Portal przypisz innych użytkowników obszaru roboczego do roli Współautor 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.
   • Członek roli Właściciel konta usługi Azure Storage musi przypisać rolę Współautor danych obiektu blob usługi Storage do tożsamości usługi zarządzanej obszaru roboczego usługi 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 usługi Azure Synapse Analytics powoduje usunięcie aparatów analitycznych i danych przechowywanych w bazie danych zawartych pul SQL i 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, notesy, definicje zadań i potoki).

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.