Início Rápido: Criar um workspace do Azure Synapse com o Azure PowerShell

O Azure PowerShell é um conjunto de cmdlets para gerenciar recursos do Azure diretamente do PowerShell. Você pode usá-la em seu navegador com o Azure Cloud Shell. Você também pode instalá-lo no macOS, Linux ou Windows.

Neste guia de início rápido, você aprenderá a criar um workspace do Azure Synapse usando o Azure PowerShell.

Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.

Pré-requisitos

• Conta de armazenamento do Azure Data Lake Storage Gen2

  Importante

  O workspace do Azure Synapse precisa conseguir fazer leituras e gravações na conta do ADLS Gen2 selecionada. Para qualquer conta de armazenamento vinculada como a conta de armazenamento primária, você precisa habilitar o namespace hierárquico na criação da conta de armazenamento, conforme descrito em Criar uma Conta de Armazenamento.

Se você optar por usar o Cloud Shell, confira Visão geral do Azure Cloud Shell para obter mais informações.

Instalar o módulo do Azure PowerShell localmente

Se você optar por usar o PowerShell localmente, este artigo exigirá que você instale o módulo Az PowerShell e conecte-se à sua conta do Azure usando o cmdlet Connect-AzAccount. Para obter mais informações sobre como instalar o módulo Az PowerShell, confira Instalar o Azure PowerShell.

Para obter mais informações sobre a autenticação com o Azure PowerShell, confira Entrar com o Azure PowerShell.

Instalar o módulo do PowerShell do Azure Synapse

Importante

Enquanto o módulo Az.Synapse do PowerShell está em versão prévia, você precisa instalá-lo separadamente usando o cmdlet Install-Module. Depois que esse módulo do PowerShell estiver em disponibilidade geral, ele fará parte das versões futuras do módulo Az PowerShell e estará disponível por padrão no Azure Cloud Shell.

Install-Module -Name Az.Synapse

Criar um workspace do Azure Synapse usando o Azure PowerShell

1. Defina as variáveis de ambiente necessárias para criar recursos para o workspace do Azure Synapse.

   Nome da variável	Descrição
   StorageAccountName	Nome de sua conta de armazenamento existente do ADLS Gen2.
   StorageAccountResourceGroup	Nome do seu grupo de recursos da conta de armazenamento do ADLS Gen2.
   FileShareName	Nome do sistema de arquivos de armazenamento existente.
   SynapseResourceGroup	Escolha um novo nome para o grupo de recursos do Azure Synapse.
   Região	Escolha uma das regiões do Azure.
   SynapseWorkspaceName	Escolha um nome exclusivo para seu novo workspace do Azure Synapse.
   SqlUser	Escolha um valor para um novo nome de usuário.
   SqlPassword	Escolha uma senha segura.
   ClientIP	Endereço IP público do sistema do qual você está executando o PowerShell.

2. Crie um grupo de recursos como um contêiner para seu workspace do Azure Synapse:

   New-AzResourceGroup -Name $SynapseResourceGroup -Location $Region
   

3. Crie um workspace do Azure Synapse:

   $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. Obtenha a URL da Web e de desenvolvimento para o workspace do Azure Synapse:

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

5. Crie uma regra de firewall para permitir o acesso ao workspace do Azure Synapse em seu computador:

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

6. Abra o endereço URL da Web do workspace do Azure Synapse armazenado na variável de ambiente WorkspaceWeb para acessar seu workspace:

   Start-Process $WorkspaceWeb
   

   

7. Após a implantação, são necessárias permissões adicionais.

• No portal do Azure, atribua outros usuários do workspace à função Colaborador no workspace. Para ver as etapas detalhadas, confira Atribuir funções do Azure usando o portal do Azure.
• Atribua outros usuários às funções apropriadas de RBAC do Azure Synapse usando o Synapse Studio.
• Um membro da função Proprietário da conta do Armazenamento do Azure precisa atribuir a função Colaborador de Dados do Blob de Armazenamento à MSI do workspace do Azure Synapse e a outros usuários.

Limpar os recursos

Siga as etapas abaixo para excluir o workspace do Azure Synapse.

Aviso

A exclusão de um workspace do Azure Synapse removerá os mecanismos de análise e os dados armazenados no banco de dados dos metadados do workspace e dos pools de SQL independentes. Não será mais possível se conectar aos pontos de extremidade do SQL ou do Apache Spark. Todos os artefatos de código serão excluídos (consultas, notebooks, definições de trabalho e pipelines). A exclusão do workspace não afetará os dados do Data Lake Storage Gen2 vinculados ao workspace.

Se o workspace do Azure Synapse criado neste artigo não for necessário, você poderá excluí-lo executando o exemplo a seguir.

Remove-AzSynapseWorkspace -Name $SynapseWorkspaceNam -ResourceGroupName $SynapseResourceGroup

Próximas etapas

Em seguida, você poderá criar pools de SQL ou criar pools do Apache Spark para começar a analisar e explorar seus dados.