Guia de Início Rápido: criar um workspace do Azure Synapse Analytics 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.

Nesse guia início rápido, você aprenderá como criar um workspace do Azure Synapse Analytics 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

  Um workspace do Azure Synapse Analytics precisa conseguir fazer leituras e gravações na conta do Data Lake Storage Gen2 selecionada. Além disso, para qualquer conta de armazenamento vinculada como a conta de armazenamento primária, você precisa ter habilitado um namespace hierárquico na criação da conta de armazenamento, conforme descrito na seção 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 obter mais informações, 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.

Crie um workspace do Azure Synapse Analytics usando a CLI do Azure

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

   Nome da variável de ambiente	Descrição
   StorageAccountName	Nome para sua conta de armazenamento existente do Data Lake Storage Gen2.
   StorageAccountResourceGroup	Nome do seu grupo de recursos da conta de armazenamento existente do 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.

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

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

3. Crie um workspace do Azure Synapse Analytics:

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

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

   echo "Open your Azure Synapse Workspace Web URL in the browser: $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 mais informaçõ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 de 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 Data Lake Storage Gen2 vinculada ao workspace.

Se você quiser excluir o workspace do Azure Synapse Analytics, execute o seguinte comando:

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