Conectar ao Banco de Dados do Azure SQL: Um Guia Completo

Tutoriais

Azure SQL Database é um serviço gerenciado de banco de dados SQL construído para que desenvolvedores e administradores não precisem realizar as tarefas tediosas de instalar o servidor SQL ou passar horas configurando clusters de failover.

O Microsoft Azure facilitou a configuração da camada do banco de dados, então tudo o que resta a fazer é se conectar a ele, e é isso que este artigo vai abordar. Aqui estão várias maneiras diferentes de se conectar a um banco de dados Azure SQL.

Pré-requisitos

Se você deseja se conectar ao banco de dados Azure SQL, precisará atender a alguns pré-requisitos com antecedência.

  1. Uma conta Azure ou acesso a uma
  2. Um Banco de Dados SQL do Azure (você pode usar o seu próprio, se preferir, mas vou usar o exemplo).
  3. A Windows 10, Mac OS, or Linux laptop or desktop with PowerShell, Visual Studio Code and SQL Server Management Studio installed. The screenshots are all from Windows 10.

Há dezenas de maneiras diferentes de se conectar ao Azure SQL, e infelizmente não posso abordar todas, mas as que vou cobrir neste post são:

  • O Portal Azure
  • SQL Server Management Studio
  • Visual Studio Code
  • PowerShell

Configurando o Banco de Dados Azure SQL

Antes de começar, você deve garantir que tenha um banco de dados disponível e consiga se conectar a ele. Usando as instruções do documento de início rápido, configurei um banco de dados de amostra chamado ata-demo. Este banco de dados possui um usuário de administrador SQL (sa) chamado AtaAdmin e a senha é Admin123.

A senha que estou usando não é a mais segura, mas servirá para fins de demonstração. Pelo amor da Equifax, por favor, utilize as melhores práticas para senhas ao configurar algo assim em QA ou Produção!

Em seguida, você precisará fazer login no Portal Azure para garantir que seu dispositivo possa se conectar ao banco de dados. Você pode conectá-lo a uma rede virtual do Azure existente ou definir um intervalo de IP que pode acessar o banco de dados, que é o que é feito nos exemplos abaixo. Vá para a página de recurso do Banco de Dados SQL ao qual deseja se conectar e procure por uma opção chamada Definir Firewall do Servidor.

Setting an Azure SQL Server firewall rule

Uma vez aqui, você terá a opção de escolher um intervalo de IP. Esta página também mostra o endereço IP do seu dispositivo, que é o que usarei para a demonstração. Mas na prática, este será o intervalo de sub-rede ou rede virtual da sua camada de aplicativo. Depois disso, você estará pronto para passar para a primeira demonstração!

Conectando-se a um Banco de Dados SQL do Azure com o Portal Azure

Já que você já está no Portal Azure, pode continuar aqui mesmo para a primeira demonstração.

Volte para a página de Visão Geral usando o menu de navegação à esquerda e procure pelo Editor de Consultas. Assim que estiver lá, você será solicitado a fazer login com uma conta da Microsoft ou Credenciais do SQL. Use a conta SA que você configurou anteriormente para fazer login (AtaAdmin:Admin123).

Depois de fazer o login, você verá um painel com as Tabelas, Visualizações e Procedimentos Armazenados à esquerda do Editor de Consultas. Até o momento desta redação, não há funcionalidade de clique com o botão direito nesta interface, então sua única opção para interagir com o banco de dados é através do Editor de Consultas. Se estiver usando o banco de dados de exemplo, pode usar a consulta de exemplo abaixo.

SELECT pc.Name as CategoryName, p.name as ProductName
FROM [SalesLT].[ProductCategory] pc
JOIN [SalesLT].[Product] p
ON pc.productcategoryid = p.productcategoryid;
Querying the Azure SQL server database

Agora que você sabe que as regras do firewall foram configuradas, podemos começar a tentar isso em outras plataformas.

Conectando-se a um Banco de Dados do Azure SQL com o SQL Server Management Studio (SSMS)

A ferramenta mais robusta para gerenciar um servidor de banco de dados SQL é, de longe, o SSMS. Testado pelo tempo e com experiência prática, esta tem sido a ferramenta de escolha para administradores de banco de dados do SQL Server por mais de uma década.

O SSMS também é totalmente compatível com os bancos de dados do Azure SQL. Se você ainda não o tem instalado, pode baixar a versão mais recente da Microsoft ou instalá-lo usando um gerenciador de pacotes.

Volte para a sua página de recursos do Banco de Dados SQL e copie o Nome do Servidor. O nome do servidor será <Nome do seu Banco de Dados>.database.windows.net.

Abra o SQL Server Management Studio para se conectar ao nome do banco de dados usando autenticação do SQL Server e o usuário SA que você configurou anteriormente. Se você ainda não configurou a regra do firewall, será solicitado pela SSMS que você se autentique com sua conta do Azure.

Agora que você se autenticou no banco de dados e o firewall está configurado, você pode começar a executar suas consultas indo para <Nome do Servidor> -> Bancos de Dados, clicando com o botão direito no seu banco de dados e selecionando Nova Consulta. Agora execute a consulta que você usou anteriormente e veja a mágica acontecer.

Connecting to an Azure SQL Database with SSMS

Conectando-se a um Banco de Dados SQL do Azure com o Visual Studio Code (Code)

Para se conectar a um banco de dados SQL do Azure com o Visual Studio Code, você precisará instalar a extensão mssql para o Visual Studio Code. Uma vez instalado, pressione Ctrl + Shift + P para abrir a caixa de diálogo e procure por MS SQL: Conectar.

Using the MSSql extension in Visual Studio Code

Assim que você selecionar isso, o Visual Studio Code irá guiá-lo através de um assistente solicitando que você insira as informações do banco de dados para se conectar. Você será solicitado pelo nome do servidor, nome do banco de dados, nome de usuário e senha. Uma vez que você fornecer tudo isso, será salvo em um perfil de conexão que pode ser usado para executar consultas contra esse banco de dados.

Utilize um comando SQL para executar na sua base de dados na janela do editor. Com a consulta aberta, pressione Ctrl + Shift + E. Você será solicitado a escolher a conexão com a qual deseja executar essa consulta. Escolha aquela que você criou, e o Code abrirá outra janela com os resultados sem sair da tela!

Connecting to mySql in Visual Studio Code

Conectando a um Banco de Dados SQL do Azure com o PowerShell

Para se conectar a um banco de dados SQL do Azure com o PowerShell, você precisará instalar o módulo Az do PowerShell. Você pode encontrar este módulo na PowerShell Gallery. Faça o download e instale o módulo executando o comando Install-Module Az. No momento desta escrita, o módulo está na versão 2.5

O módulo só precisa ser instalado uma vez na máquina da qual você deseja executar o script. Em seguida, autentique-se no Azure executando Connect-AzAccount. Saiba mais sobre como usar o cmdlet Connect-AzAccount, se quiser saber mais.

Para verificar se tudo funciona, você pode encontrar o banco de dados executando Get-AzSqlServer -ResourceGroupName <Seu Grupo de Recursos>. Se isso retornar o banco de dados ao qual você deseja se conectar, você está pronto para executar o script.

Agora que você está autenticado e pode ver o banco de dados, pode consultá-lo executando o script abaixo. Este código importará o módulo Azure SQL, configurará os parâmetros (banco de dados, nome de usuário, credenciais e consulta) e executará Invoke-SqlCmd para iniciar a consulta SQL.

# Importe o módulo
Import-Module Az.Sql -Force
 
# Configure seus parâmetros
$Params = @{
   'ServerInstance' = 'atademo.database.windows.net';
   'Database' = 'ata-demo';
   'Username' = 'ataadmin';
   'Password' = 'Admin123';
   'Query' = 'SELECT pc.Name as CategoryName, p.name as ProductName
FROM [SalesLT].[ProductCategory] pc
JOIN [SalesLT].[Product] p
ON pc.productcategoryid = p.productcategoryid;'
}
 
# Espalhe
Invoke-Sqlcmd @Params

Você também pode usar o PowerShell para ler o servidor e banco de dados SQL do Azure e usar essas informações para passar para a consulta conforme visto abaixo. Supondo que você tenha $rgName definido e esteja passando a senha como uma string segura, não há diferença funcional entre o primeiro script e o segundo.

Import-Module Az.Sql -Force
 
$rgName = '<Resource Group Name>'
$sqlServer = Get-AzSqlServer -ResourceGroupName $rgName
$sqlDatabase = Get-AzSqlDatabase -ServerName $sqlServer.ServerName -ResourceGroupName $rgName
 
$Params = @{
   'ServerInstance' = $sqlServer.FullyQualifiedDomainName;
   'Database' = $sqlDatabase.DatabaseName[0];
   'Username' = $sqlServer.SqlAdministratorLogin;
   'Password' = ‘<Password>’;
   'Query' = 'SELECT pc.Name as CategoryName, p.name as ProductName
       FROM [SalesLT].[ProductCategory] pc
       JOIN [SalesLT].[Product] p
       ON pc.productcategoryid = p.productcategoryid;'
}
 
Invoke-Sqlcmd @Params

Concluindo

Agora que você se conectou a um Banco de Dados SQL do Azure de algumas maneiras diferentes, você deve se sentir confortável usando-o tanto com quanto em vez de uma instalação tradicional do SQL Server!

Leitura adicional

Source:
https://adamtheautomator.com/connect-to-azure-sql-database/