Snabbstart: Skapa en Azure Synapse-arbetsyta med Azure PowerShell

Azure PowerShell är en uppsättning cmdletar för att hantera Azure-resurser direkt från PowerShell. Du kan använda det i din webbläsare med Azure Cloud Shell. Du kan också installera det på macOS, Linux eller Windows.

I den här snabbstarten lär du dig att skapa en Synapse-arbetsyta med Azure PowerShell.

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

Förutsättningar

• Azure Data Lake Storage Gen2 lagringskonto

  Viktigt

  Den 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 aktivera hierarkiskt namnområde när lagringskontot skapas enligt beskrivningen i Skapa ett lagringskonto.

Mer information finns i Översikt över Azure Cloud Shell om du väljer att använda Cloud Shell.

Installera Azure PowerShell-modulen lokalt

Om du väljer att använda PowerShell lokalt kräver den här artikeln att du installerar Az PowerShell-modulen och ansluter till ditt Azure-konto med cmdleten Connect-AzAccount . Mer information om hur du installerar Az PowerShell-modulen finns i Installera Azure PowerShell.

Mer information om autentisering med Azure PowerShell finns i Logga in med Azure PowerShell.

Installera Azure Synapse PowerShell-modulen

Viktigt

Även om Az.Synapse PowerShell-modulen är i förhandsversion måste du installera den separat med hjälp av cmdleten Install-Module . När modulen blir allmänt tillgänglig kommer den att ingå i framtida versioner av Az PowerShell-modulen och vara tillgänglig som standard i Azure Cloud Shell.

Install-Module -Name Az.Synapse

Skapa en Azure Synapse arbetsyta med Azure PowerShell

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

   Variabelnamn	Description
   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.
   ClientIP	Offentlig IP-adress för det system som du kör PowerShell från.

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

   New-AzResourceGroup -Name $SynapseResourceGroup -Location $Region
   

3. Skapa en Azure Synapse arbetsyta:

   $Cred = New-Object -TypeName System.Management.Automation.PSCredential ($SqlUser, (ConvertTo-SecureString $SqlPassword -AsPlainText -Force))
   
   $WorkspaceParams = @{
     Name = $SynapseWorkspaceName
     ResourceGroupName = $SynapseResourceGroup
     DefaultDataLakeStorageAccountName = $StorageAccountName
     DefaultDataLakeStorageFilesystem = $FileShareName
     SqlAdministratorLoginCredential = $Cred
     Location = $Region
   }
   New-AzSynapseWorkspace @WorkspaceParams
   

4. Hämta webb- och utvecklings-URL för Azure Synapse-arbetsyta:

   $WorkspaceWeb = (Get-AzSynapseWorkspace -Name $SynapseWorkspaceName -ResourceGroupName $StorageAccountResourceGroup).ConnectivityEndpoints.web
   $WorkspaceDev = (Get-AzSynapseWorkspace -Name $SynapseWorkspaceName -ResourceGroupName $StorageAccountResourceGroup).ConnectivityEndpoints.dev
   

5. Skapa en brandväggsregel för att tillåta åtkomst till Azure Synapse arbetsyta från datorn:

   $FirewallParams = @{
     WorkspaceName = $SynapseWorkspaceName
     Name = 'Allow Client IP'
     ResourceGroupName = $StorageAccountResourceGroup
     StartIpAddress = $ClientIP
     EndIpAddress = $ClientIP
   }
   New-AzSynapseFirewallRule @FirewallParams
   

6. Öppna webbadressen Azure Synapse arbetsyta som lagras i miljövariabeln WorkspaceWeb för att få åtkomst till din arbetsyta:

   Start-Process $WorkspaceWeb
   

   

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

• I Azure Portal tilldelar du andra användare av arbetsytan till 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 hjälp av Synapse Studio.
• En medlem av ägarrollen för Azure Storage-kontot måste tilldela rollen Storage Blob Data-deltagare till Azure Synapse arbetsytans 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 den Azure Synapse arbetsyta som skapats i den här artikeln inte behövs kan du ta bort den genom att köra följande exempel.

Remove-AzSynapseWorkspace -Name $SynapseWorkspaceNam -ResourceGroupName $SynapseResourceGroup

Nästa steg

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