Guia de início rápido: criar um espaço de trabalho de sinapse do Azure com a CLI do Azure

A CLI do Azure é a experiência da linha de comandos do Azure para a gestão de recursos do Azure. Pode utilizá-la no seu browser com o Azure Cloud Shell. Também pode instalá-la no macOS, Linux ou Windows e executá-la a partir da linha de comandos.

Neste início rápido, você aprende a criar um espaço de trabalho Synapse usando a CLI do Azure.

Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.

Pré-requisitos

• Baixe e instale o jq, um processador JSON de linha de comando leve e flexível

• Conta de armazenamento do Azure Data Lake Storage Gen2

  Importante

  O espaço de trabalho do Azure Synapse precisa ser capaz de ler e gravar na conta ADLS Gen2 selecionada. Além disso, para qualquer conta de armazenamento vinculada como a conta de armazenamento principal, você deve ter habilitado o 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, consulte Guia de início rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

  • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

Criar um espaço de trabalho do Azure Synapse usando a CLI do Azure

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

   Nome da Variável de Ambiente	Descrição
   StorageAccountName	Nome da sua conta de armazenamento ADLS Gen2 existente.
   StorageAccountResourceGroup	Nome do grupo de recursos da conta de armazenamento ADLS Gen2 existente.
   FileShareName	Nome do sistema de arquivos de armazenamento existente.
   SynapseResourceGroup	Escolha um novo nome para seu grupo de recursos do Azure Synapse.
   Região	Escolha uma das regiões do Azure.
   SynapseWorkspaceName	Escolha um nome exclusivo para seu novo Espaço de Trabalho do Azure Sinapse.
   SqlUser	Escolha um valor para um novo nome de usuário.
   SqlPassword	Escolha uma palavra-passe segura.

2. Crie um grupo de recursos como um contêiner para seu espaço de trabalho do Azure Synapse:

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

3. Crie um espaço de trabalho 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. Obter URL da Web e de Desenvolvimento para o Espaço de Trabalho Sinapse do Azure:

   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 seu acesso ao Azure Synapse Workspace a partir do 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 Azure Synapse Workspace armazenado na variável WorkspaceWeb de ambiente para acessar seu espaço de trabalho:

   echo "Open your Azure Synapse Workspace Web URL in the browser: $WorkspaceWeb"
   

   

7. Uma vez implantadas, permissões adicionais são necessárias.

• No portal do Azure, atribua outros usuários do espaço de trabalho à função de Colaborador no espaço de trabalho. Para obter os passos detalhados, veja o artigo Atribuir funções do Azure com o portal do Azure.
• Atribua a outros usuários as funções apropriadas do Synapse RBAC usando o Synapse Studio.
• Um membro da função Proprietário da conta de Armazenamento do Azure deve atribuir a função de Colaborador de Dados de Blob de Armazenamento ao MSI do espaço de trabalho Sinapse do Azure e a outros usuários.

Clean up resources (Limpar recursos)

Siga as etapas abaixo para excluir o espaço de trabalho do Azure Synapse.

Aviso

A exclusão de um espaço de trabalho do Azure Synapse removerá os mecanismos de análise e os dados armazenados no banco de dados dos pools SQL e metadados do espaço de trabalho contidos. Não será mais possível se conectar aos pontos de extremidade SQL ou Apache Spark. Todos os artefatos de código serão excluídos (consultas, blocos de anotações, definições de trabalho e pipelines).

A exclusão do espaço de trabalho não afetará os dados no Data Lake Store Gen2 vinculados ao espaço de trabalho.

Se você quiser excluir o espaço de trabalho do Azure Synapse, conclua o seguinte comando:

az synapse workspace delete --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup

Próximos passos

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