Snabbstart: Skapa en Azure Synapse Analytics-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 får du lära dig hur du skapar en Azure Synapse Analytics-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!

  En Azure Synapse Analytics-arbetsyta måste kunna läsa och skriva till det valda Data Lake Storage 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 i 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 Analytics-arbetsyta med hjälp av Azure CLI

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

   Miljövariabelnamn	Beskrivning
   StorageAccountName	Namn på ditt befintliga Data Lake Storage Gen2-lagringskonto.
   StorageAccountResourceGroup	Namnet på din befintliga resursgrupp för Data Lake Storage Gen2-lagringskontot.
   FileShareName	Namnet på ditt befintliga lagringsfilsystem.
   SynapseResourceGroup	Välj ett nytt namn för din Azure Synapse Analytics-resursgrupp.
   Region	Välj en av Azure-regionerna.
   SynapseWorkspaceName	Välj ett unikt namn för din nya Azure Synapse Analytics-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 Analytics-arbetsyta:

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

3. Skapa en Azure Synapse Analytics-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:er för Azure Synapse Analytics-arbetsytan:

   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 åtkomst till din Azure Synapse Analytics-arbetsyta 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 Analytics-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 den har distribuerats krävs fler behörigheter:

   • I Azure Portal tilldelar du andra användare av arbetsytan rollen Deltagare på arbetsytan. Mer information finns i Tilldela Azure-roller med Azure-portalen.
   • Tilldela andra användare lämpliga rollbaserade åtkomstkontrollroller i Azure Synapse Analytics med hjälp av Synapse Studio.
   • En medlem av ägarrollen för Azure Storage-kontot måste tilldela rollen Storage Blob Data Contributor till azure Synapse Analytics-arbetsytans hanterade tjänstidentitet och andra användare.

Rensa resurser

Följ de här stegen för att ta bort Azure Synapse Analytics-arbetsytan.

Varning

Om du tar bort en Azure Synapse Analytics-arbetsyta tas analysmotorerna bort och data som lagras i databasen för de sql-pooler och arbetsytemetadata som finns. 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 Storage Gen2-kontot som är länkat till arbetsytan.

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

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

Relaterat innehåll

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