Compartilhar via


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
    

    Captura de tela que mostra a web do workspace do Azure Synapse Analytics.

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

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

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