Início Rápido: Usar .NET e C# no Visual Studio para se conectar a um banco de dados e consultá-lo

Aplica-se a: Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics

Este guia de início rápido mostra como usar o .NET e o código C# no Visual Studio para consultar um banco de dados no SQL do Azure ou no SQL do Synapse com as instruções Transact-SQL.

Pré-requisitos

Para concluir este início rápido, você precisa de:

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.

• Visual Studio 2022 Community, Professional ou Enterprise Edition.

• Um banco de dados no qual você pode executar uma consulta.

  Você pode usar um dos seguintes guias de início rápido para criar e configurar um banco de dados:

  Ação	Banco de Dados SQL	Instância Gerenciada do SQL	SQL Server na VM do Azure	Azure Synapse Analytics
  Criar	Portal	Portal	Portal	Portal
  	CLI			CLI
  	PowerShell	PowerShell	PowerShell	PowerShell
  	Modelo de implantação	Modelo de implantação	Modelo de implantação	Modelo de implantação
  Configurar	Regra de firewall de IP no nível do servidor	Conectividade de uma VM		Configurações de conectividade
  		Conectividade do local	Conectar-se a uma Instância do SQL Server
  Obter informações de conexão	SQL do Azure	SQL do Azure	SQL VM	SQL do Synapse

Criar código para consultar o banco de dados no Banco de Dados SQL do Azure

1. No Visual Studio, crie um novo projeto.

2. Na caixa de diálogo Novo Projeto, selecione Aplicativo de Console C#.

3. Insira sqltest para o nome do projeto e escolha Avançar.

4. Selecione uma opção do Framework (Suporte de longo prazo), como o .NET 6.0 e escolha Criar. Quando um novo projeto é criado.

5. Selecione Projeto>Gerenciar Pacotes do NuGet.

6. Na Gerenciador de Pacotes NuGet, selecione a guia Procurar e pesquise e selecione Microsoft.Data.SqlClient.

7. Na página Microsoft.Data.SqlClient, selecione Instalar.

   • Se solicitado, selecione OK para continuar com a instalação.
   • Se uma janela Aceitação da Licença for exibida, selecione Aceito.

8. Quando a instalação for concluída, você poderá fechar Gerenciador de Pacotes NuGet.

9. No editor de códigos, substitua o conteúdo de Program.cs pelo código a seguir. Substitua os valores para <your_server>, <your_username>, <your_password> e <your_database>.

   using System;
   using Microsoft.Data.SqlClient;
   using System.Text;
   
   namespace sqltest
   {
       class Program
       {
           static void Main(string[] args)
           {
               try 
               { 
                   SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder();
                   builder.DataSource = "<your_server>.database.windows.net"; 
                   builder.UserID = "<your_username>";            
                   builder.Password = "<your_password>";     
                   builder.InitialCatalog = "<your_database>";
   
                   using (SqlConnection connection = new SqlConnection(builder.ConnectionString))
                   {
                       Console.WriteLine("\nQuery data example:");
                       Console.WriteLine("=========================================\n");
   
                       String sql = "SELECT name, collation_name FROM sys.databases";
   
                       using (SqlCommand command = new SqlCommand(sql, connection))
                       {
                           connection.Open();
                           using (SqlDataReader reader = command.ExecuteReader())
                           {
                               while (reader.Read())
                               {
                                   Console.WriteLine("{0} {1}", reader.GetString(0), reader.GetString(1));
                               }
                           }
                       }                    
                   }
               }
               catch (SqlException e)
               {
                   Console.WriteLine(e.ToString());
               }
               Console.ReadLine();
           }
       }
   }
   

Executar o código

1. Para executar o aplicativo, selecione Depurar>Iniciar Depuração ou Iniciar na barra de ferramentas ou pressione F5.
2. Verifique se nomes e agrupamentos de bancos de dados são retornados e feche a janela do aplicativo.

Próximas etapas

• Saiba como se conectar a um banco de dados no Banco de Dados SQL do Azure e consultá-lo usando o .NET por meio da linha de comando no Windows/no Linux/no macOS.
• Saiba mais sobre a Introdução ao .NET no Windows/no Linux/no macOS usando o VS Code.
• Saiba mais sobre o desenvolvimento com o .NET e o SQL.
• Saiba como Criar seu primeiro banco de dados no Banco de Dados SQL do Azure usando o SSMS.
• Para saber mais sobre o .NET, veja a documentação do .NET.
• Exemplo de lógica de repetição: Conectar-se de maneira resiliente ao Azure SQL com o ADO.NET.