Início Rápido: Criar um workspace do Azure Synapse com a CLI do Azure

A CLI do Azure é a experiência de linha de comando do Azure para gerenciar recursos do Azure. Você pode usá-la em seu navegador com o Azure Cloud Shell. Você também pode instalá-lo no Windows, no Linux ou no macOS e executá-lo na linha de comando.

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

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

Pré-requisitos

• Baixar e instalar o jq, um processador JSON de linha de comando leve e flexível

• 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. Além disso, para qualquer conta de armazenamento vinculada como a conta de armazenamento primária, você precisa ter habilitado namespace hierárquico na criação da conta de armazenamento, conforme descrito na página Criar uma Conta de Armazenamento.

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para saber mais, confira Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.

  • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

Criar um workspace do Azure Synapse usando a CLI do Azure

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

   Nome de variável de ambiente	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.

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

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

3. Crie um workspace do Azure Synapse:

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

   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. Crie uma regra de firewall para permitir o acesso ao workspace do Azure Synapse em seu computador:

   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. Abra o endereço URL da Web do workspace do Azure Synapse armazenado na variável de ambiente WorkspaceWeb para acessar seu workspace:

   echo "Open your Azure Synapse Workspace Web URL in the browser: $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.

Caso deseje excluir o workspace do Azure Synapse, conclua o seguinte comando:

az synapse workspace delete --name $SynapseWorkspaceName --resource-group $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.