Partilhar via


Guia de início rápido: criar um pool SQL Synapse com a CLI do Azure

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

Pré-requisitos

  • Use o ambiente Bash na 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 você estiver executando no Windows ou macOS, considere executar a CLI do Azure em um contêiner do 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 az version para descobrir a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.

Como Começar

Utilize estes comandos para iniciar sessão no Azure e configurar um grupo de recursos.

  1. Se você estiver usando uma instalação local, execute o comando az login para entrar no Azure:

    az login
    
  2. Se necessário, use o comando az account set para selecionar sua assinatura:

    az account set --subscription 00000000-0000-0000-0000-000000000000
    
  3. Execute o comando az group create para criar um grupo de recursos:

    az group create --name myResourceGroup --location WestEurope
    
  4. 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 como um grupo.

Configurar uma regra de firewall ao nível do servidor

Crie uma regra de firewall no nível do 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 a um pool SQL por meio do firewall do serviço do pool 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 só é aberto para 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

SQL endpoints communicate over port 1433. Se você estiver tentando se conectar de dentro de uma rede corporativa, o tráfego de saída pela porta 1433 pode não ser permitido pelo firewall da rede. Em caso afirmativo, você não poderá se conectar ao servidor, a menos que o departamento de TI abra a porta 1433.

Criar e gerenciar seu pool SQL

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

Observação

Você precisa de um espaço de trabalho criado anteriormente. Para obter mais informações, consulte Guia de início rápido: criar um espaço de trabalho de sinapse do Azure com a CLI do Azure.

Use o comando az synapse sql pool create para criar o pool 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, consulte az synapse sql pool.

Você pode ver seus pools 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 seu 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 pausado:

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

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

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

Limpar recursos

Outros tutoriais de início rápido nesta coleção se baseiam neste início rápido.

Tip

If you plan to continue on to work with later quickstart tutorials, don't clean up the resources created in this quickstart. 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óximos passos

Agora você criou um pool SQL, criou uma regra de firewall e se conectou ao seu pool SQL. Para saber mais, continue para o artigo Carregar dados no pool SQL .