Início rápido: Criar um pool de SQL do Synapse com a CLI do Azure

Artigo
03/10/2023

Crie um pool de SQL do Synapse (data warehouse) no Azure Synapse Analytics usando a CLI do Azure.

Pré-requisitos

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.

Introdução

Use estes comandos para fazer logon no Azure e configurar um grupo de recursos.

Se você estiver usando uma instalação local, execute o comando az login para entrar no Azure:
```
az login
```
Se necessário, use o comando az account set para selecionar sua assinatura:
```
az account set --subscription 00000000-0000-0000-0000-000000000000
```
Execute o comando az group create para criar um grupo de recursos:
```
az group create --name myResourceGroup --location WestEurope
```

Crie um servidor SQL lógico usando o comando az sql server create:

az sql server create --resource-group myResourceGroup --name mysqlserver \
   --admin-user ServerAdmin --admin-password ChangeYourAdminPassword1

Um servidor contém um grupo de bancos de dados gerenciados conjuntamente.

Configurar uma regra de firewall no nível de servidor

Crie uma regra de firewall no nível de servidor. Uma regra de firewall no nível de servidor permite que um aplicativo externo, como o SQL Server Management Studio ou o utilitário SQLCMD, se conecte ao pool de SQL por meio do firewall do pool de SQL.

Execute o comando az sql server firewall-rule create para criar uma regra de firewall:

az sql server firewall-rule create --resource-group myResourceGroup --name AllowSome \
   --server mysqlserver --start-ip-address 0.0.0.0 --end-ip-address 0.0.0.0

Neste exemplo, o firewall está aberto somente para os outros recursos do Azure. Para habilitar a conectividade externa, altere o endereço IP para um endereço apropriado para seu ambiente. Para abrir todos os endereços IP, use 0.0.0.0 como o endereço IP inicial e 255.255.255.255 como o endereço final.

Observação

Os pontos de extremidade SQL comunicam-se pela porta 1433. Se você estiver tentando conectar-se a partir de uma rede corporativa, o tráfego de saída pela porta 1433 poderá não ser permitido pelo firewall de sua rede. Se isso acontecer, você não conseguirá se conectar ao servidor, a menos que o departamento de TI abra a porta 1433.

Criar e gerenciar seu pool de SQL

Crie o pool de SQL. Este exemplo usa o DW100c como o objetivo de serviço, que é um ponto de partida de baixo custo para seu pool de SQL.

Observação

Você precisa de um workspace criado anteriormente. Para saber mais, confira Início Rápido: Criar um workspace do Azure Synapse com a CLI do Azure.

Use o comando az synapse sql pool create para criar o pool de SQL:

az synapse sql pool create --resource-group myResourceGroup --name mySampleDataWarehouse \
   --performance-level "DW1000c" --workspace-name testsynapseworkspace

Para obter mais informações sobre as opções de parâmetro, confira az synapse sql pool.

Você pode ver seus pools de SQL usando o comando az synapse sql pool list:

az synapse sql pool list --resource-group myResourceGroup --workspace-name testsynapseworkspace

Use o comando az synapse sql pool update para atualizar um pool existente:

az synapse sql pool update --resource-group myResourceGroup --name mySampleDataWarehouse \
   --workspace-name testsynapseworkspace

Use o comando az synapse sql pool pause para pausar o pool:

az synapse sql pool pause --resource-group myResourceGroup --name mySampleDataWarehouse \
   --workspace-name testsynapseworkspace

Use o comando az synapse sql pool resume para iniciar um pool em pausa:

az synapse sql pool resume --resource-group myResourceGroup --name mySampleDataWarehouse \
   --workspace-name testsynapseworkspace

Para remover um pool de SQL existente, use o comando az synapse sql pool delete:

az synapse sql pool delete --resource-group myResourceGroup --name mySampleDataWarehouse \
   --workspace-name testsynapseworkspace

Limpar os recursos

Outros tutoriais nesta coleção aproveitam este início rápido.

Dica

Se você planeja continuar trabalhando com os tutoriais de início rápido mais recentes, não limpe os recursos criados neste guia de início rápido. Se você não planeja continuar, use o comando az group delete para excluir todos os recursos criados por este início rápido.

az group delete --ResourceGroupName MyResourceGroup

Próximas etapas

Você acabou de criar um pool de SQL, criar uma regra de firewall e se conectar ao pool de SQL. Para saber mais, prossiga para o artigo Carregar dados para o pool de SQL.