Início Rápido: Criar um workspace do Azure Synapse Analytics 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 início rápido, você aprenderá a criar um workspace do Azure Synapse Analytics 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

  Um workspace do Azure Synapse Analytics precisa conseguir fazer leituras e gravações na conta do Azure Data Lake Storage 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 do 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 estiver em versão prévia, você precisará 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 do PowerShell e estará disponível por padrão no Cloud Shell.

Install-Module -Name Az.Synapse

Crie um workspace do Azure Synapse Analytics usando o Azure PowerShell

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

   Nome da variável	Descrição
   StorageAccountName	Nome para sua conta de armazenamento existente do Azure Data Lake Storage Gen2.
   StorageAccountResourceGroup	Nome do seu grupo de recursos da conta de armazenamento existente do Azure Data Lake Storage Gen2.
   FileShareName	Nome do sistema de arquivos de armazenamento existente.
   SynapseResourceGroup	Escolha um novo nome para o grupo de recursos do Azure Synapse Analytics.
   Region	Escolha uma das regiões do Azure.
   SynapseWorkspaceName	Escolha um nome exclusivo para seu novo workspace do Azure Synapse Analytics.
   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 Analytics:

   New-AzResourceGroup -Name $SynapseResourceGroup -Location $Region
   

3. Criar um workspace do Azure Synapse Analytics:

   $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 os URLs Web e de desenvolvimento para o workspace do Azure Synapse Analytics:

   $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 Analytics em seu computador:

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

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

   Start-Process $WorkspaceWeb
   

   

7. Depois de implantado, mais permissões são necessárias.

   • No portal do Azure, atribua outros usuários do workspace à função Colaborador no workspace. Para obter instruções, confira Atribuir funções do Azure usando o portal do Azure.
   • Atribua a outros usuários as funções de controle de acesso baseado em função do Azure Synapse Analytics apropriadas usando o Synapse Studio.
   • Um membro da função Proprietário da conta do Armazenamento do Microsoft Azure deve atribuir a função Colaborador de Dados do Blob de Armazenamento à identidade do serviço gerenciado do workspace do Azure Synapse Analytics e a outros usuários.

Limpar os recursos

Siga estas etapas para excluir o workspace do Azure Synapse Analytics.

Aviso

A exclusão de um workspace do Azure Synapse Analytics remove 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 na conta do Azure Data Lake Storage Gen2 vinculada ao workspace.

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

Remove-AzSynapseWorkspace -Name $SynapseWorkspaceNam -ResourceGroupName $SynapseResourceGroup

Conteúdo relacionado

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