Snabbstart: Skapa en Azure Synapse-arbetsyta med Azure CLI

Azure CLI är Azures kommandoradsmiljö för att hantera Azure-resurser. Du kan använda det i din webbläsare med Azure Cloud Shell. Du kan även installera det på macOS, Linux eller Windows och köra det från kommandoraden.

I den här snabbstarten lär du dig att skapa en Synapse-arbetsyta med hjälp av Azure CLI.

Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.

Förutsättningar

• Ladda ned och installera jq, en enkel och flexibel JSON-processor med kommandorad

• Azure Data Lake Storage Gen2-lagringskonto

  Viktigt!

  Azure Synapse-arbetsytan måste kunna läsa och skriva till det valda ADLS Gen2-kontot. För alla lagringskonton som du länkar som det primära lagringskontot måste du dessutom ha aktiverat hierarkiskt namnområde när lagringskontot skapas, enligt beskrivningen på sidan Skapa ett lagringskonto .

• Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Snabbstart för Bash i Azure Cloud Shell.

  

• Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.

  • Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Andra inloggningsalternativ finns i Logga in med Azure CLI.

  • När du uppmanas att installera Azure CLI-tillägget vid första användningen. Mer information om tillägg finns i Använda tillägg med Azure CLI.

  • Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Skapa en Azure Synapse-arbetsyta med hjälp av Azure CLI

1. Definiera nödvändiga miljövariabler för att skapa resurser för Azure Synapse-arbetsytan.

   Miljövariabelns namn	Beskrivning
   StorageAccountName	Namn på ditt befintliga ADLS Gen2-lagringskonto.
   StorageAccountResourceGroup	Namnet på din befintliga resursgrupp för ADLS Gen2-lagringskontot.
   FileShareName	Namnet på ditt befintliga lagringsfilsystem.
   SynapseResourceGroup	Välj ett nytt namn för din Azure Synapse-resursgrupp.
   Region	Välj en av Azure-regionerna.
   SynapseWorkspaceName	Välj ett unikt namn för din nya Azure Synapse-arbetsyta.
   SqlUser	Välj ett värde för ett nytt användarnamn.
   SqlPassword	Välj ett säkert lösenord.

2. Skapa en resursgrupp som en container för din Azure Synapse-arbetsyta:

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

3. Skapa en Azure Synapse-arbetsyta:

   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. Hämta webb- och utvecklings-URL för Azure Synapse-arbetsyta:

   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. Skapa en brandväggsregel för att tillåta din åtkomst till Azure Synapse-arbetsytan från datorn:

   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. Öppna webbadressen till Azure Synapse-arbetsytan som lagras i miljövariabeln WorkspaceWeb för att få åtkomst till din arbetsyta:

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

   

7. När du har distribuerat krävs ytterligare behörigheter.

• I Azure-portalen tilldelar du andra användare av arbetsytan rollen Deltagare på arbetsytan. Läs mer om att tilldela roller i Tilldela Azure-roller via Azure Portal.
• Tilldela andra användare lämpliga Synapse RBAC-roller med Synapse Studio.
• En medlem av ägarrollen för Azure Storage-kontot måste tilldela rollen Storage Blob Data Contributor till Azure Synapse-arbetsytan MSI och andra användare.

Rensa resurser

Följ stegen nedan för att ta bort Azure Synapse-arbetsytan.

Varning

Om du tar bort en Azure Synapse-arbetsyta tas analysmotorerna och data som lagras i databasen för de inneslutna SQL-poolerna och arbetsytemetadata bort. Det går inte längre att ansluta till SQL- eller Apache Spark-slutpunkterna. Alla kodartefakter tas bort (frågor, notebook-filer, jobbdefinitioner och pipelines).

Om du tar bort arbetsytan påverkas inte data i Data Lake Store Gen2 som är länkade till arbetsytan.

Om du vill ta bort Azure Synapse-arbetsytan slutför du följande kommando:

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

Nästa steg

Sedan kan du skapa SQL-pooler eller skapa Apache Spark-pooler för att börja analysera och utforska dina data.