Udostępnij za pośrednictwem

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

  • Artykuł

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 Synapse 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 musi mieć możliwość odczytu i zapisu na wybranym koncie usługi ADLS 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 na stronie Tworzenie konta magazynu.

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

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

    Nazwa zmiennej środowiskowej Opis
    StorageAccountName Nazwa istniejącego konta magazynu usługi ADLS Gen2.
    StorageAccountResourceGroup Nazwa istniejącej grupy zasobów konta magazynu usługi ADLS Gen2.
    FileShareName Nazwa istniejącego systemu plików magazynu.
    SynapseResourceGroup Wybierz nową nazwę grupy zasobów usługi Azure Synapse.
    Region Wybierz jeden z regionów świadczenia usługi Azure.
    SynapseWorkspaceName Wybierz unikatową nazwę nowego obszaru roboczego usługi Azure Synapse.
    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:

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

  3. Tworzenie obszaru roboczego usługi Azure Synapse:

    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 adres URL sieci Web i dewelopera dla obszaru roboczego usługi Azure Synapse:

    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 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 adres URL sieci Web obszaru roboczego usługi Azure Synapse przechowywany w zmiennej środowiskowej WorkspaceWeb , aby uzyskać dostęp do obszaru roboczego:

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

    Azure Synapse workspace web

  7. Po wdrożeniu wymagane są dodatkowe uprawnienia.

  • W witrynie Azure Portal przypisz innych użytkowników obszaru roboczego do roli Współautor w obszarze roboczym. Aby uzyskać szczegółowe instrukcje, zobacz Przypisywanie ról platformy Azure przy użyciu witryny Azure Portal.
  • Przypisz innym użytkownikom odpowiednie role RBAC usługi Synapse 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 obszaru roboczego usługi Azure Synapse MSI i innych użytkowników.

Czyszczenie zasobów

Wykonaj poniższe kroki, aby usunąć obszar roboczy usługi Azure Synapse.

Ostrzeżenie

Usunięcie obszaru roboczego usługi Azure Synapse spowoduje 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 w usłudze Data Lake Store Gen2 połączone z obszarem roboczym.

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

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

Następne kroki

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