Guia de início rápido: use o .NET (C#) para conectar e consultar dados no Banco de Dados do Azure para PostgreSQL - Servidor Flexível

Artigo
02/26/2025

APLICA-SE A: Banco de Dados do Azure para PostgreSQL - Servidor Flexível

Este guia de início rápido demonstra como se conectar a uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL usando um aplicativo C#. Explica como utilizar as instruções SQL para consultar, inserir, atualizar e eliminar dados da base de dados. As etapas neste artigo pressupõem que você esteja familiarizado com o desenvolvimento usando C# e que seja novo no trabalho com o Banco de Dados do Azure para servidor flexível PostgreSQL.

Pré-requisitos

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

Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
Crie uma instância do Banco de Dados do Azure para PostgreSQL - Servidor Flexível, se você não tiver uma.
Use o banco de dados postgres vazio disponível no servidor ou crie um novo banco de dados.
Instale o SDK do .NET para sua plataforma (Windows, Ubuntu Linux ou macOS) para sua plataforma.
Instale o Visual Studio para criar seu projeto.
Instale o pacote Npgsql NuGet no Visual Studio.

Obter informações da ligação

Obtenha as informações de conexão necessárias para se conectar à instância de servidor flexível do Banco de Dados do Azure para PostgreSQL. Necessita do nome do servidor e das credenciais de início de sessão totalmente qualificados.

Usando o portal do Azure:

No menu à esquerda no portal do Azure, clique em Todos os recursos e procure o servidor que você criou.
Clique no nome do servidor.
No menu de recursos, selecione Visão geral.
Copie os valores mostrados como Endpoint e login de administrador.
Se se esquecer da palavra-passe do início de sessão de administrador, pode redefini-la utilizando o botão Repor palavra-passe .

Etapa 1: Conectar e inserir dados

Utilize o seguinte código para se ligar e carregar os dados com as instruções SQL CREATE TABLE e INSERT INTO. O código usa NpgsqlCommand classe com método:

Open() para estabelecer uma conexão com o Banco de Dados do Azure para banco de dados de servidor flexível PostgreSQL.
CreateCommand() define a propriedade CommandText.
Método ExecuteNonQuery() para executar os comandos do banco de dados.

Importante

Substitua os parâmetros Anfitrião, DBName, Utilizador e Palavra-passe pelos valores que especificou ao criar o servidor e a base de dados.

using System;
using Npgsql;

namespace Driver
{
    public class AzurePostgresCreate
    {
        // Obtain connection string information from the portal
        //
        private static string Host = "mydemoserver.postgres.database.azure.com";
        private static string User = "mylogin";
        private static string  DBname = "postgres";
        private static string Password = "<server_admin_password>";
        private static string Port = "5432";

        static void Main(string[] args)
        {
            // Build connection string using parameters from portal
            //
            string connString =
                String.Format(
                    "Server={0};Username={1};Database={2};Port={3};Password={4};SSLMode=Prefer",
                    Host,
                    User,
                    DBname,
                    Port,
                    Password);


            using (var conn = new NpgsqlConnection(connString))

            {
                Console.Out.WriteLine("Opening connection");
                conn.Open();

                using (var command = new NpgsqlCommand("DROP TABLE IF EXISTS inventory", conn))
                {
                    command.ExecuteNonQuery();
                    Console.Out.WriteLine("Finished dropping table (if existed)");

                }

                using (var command = new NpgsqlCommand("CREATE TABLE inventory(id serial PRIMARY KEY, name VARCHAR(50), quantity INTEGER)", conn))
                {
                    command.ExecuteNonQuery();
                    Console.Out.WriteLine("Finished creating table");
                }

                using (var command = new NpgsqlCommand("INSERT INTO inventory (name, quantity) VALUES (@n1, @q1), (@n2, @q2), (@n3, @q3)", conn))
                {
                    command.Parameters.AddWithValue("n1", "banana");
                    command.Parameters.AddWithValue("q1", 150);
                    command.Parameters.AddWithValue("n2", "orange");
                    command.Parameters.AddWithValue("q2", 154);
                    command.Parameters.AddWithValue("n3", "apple");
                    command.Parameters.AddWithValue("q3", 100);

                    int nRows = command.ExecuteNonQuery();
                    Console.Out.WriteLine(String.Format("Number of rows inserted={0}", nRows));
                }
            }

            Console.WriteLine("Press RETURN to exit");
            Console.ReadLine();
        }
    }
}

Tem algum problema? Deixe-nos saber.

Passo 2: Ler dados

Utilize o código seguinte para se ligar e ler dados com uma instrução SQL SELECT. O código usa NpgsqlCommand classe com método:

Open() para estabelecer uma conexão com o PostgreSQL.
CreateCommand() e ExecuteReader() para executar os comandos do banco de dados.
Read() para avançar para o registro nos resultados.
GetInt32() e GetString() para analisar os valores no registro.

Importante

Substitua os parâmetros Anfitrião, DBName, Utilizador e Palavra-passe pelos valores que especificou ao criar o servidor e a base de dados.

using System;
using Npgsql;

namespace Driver
{
    public class AzurePostgresRead
    {
        // Obtain connection string information from the portal
        //
        private static string Host = "mydemoserver.postgres.database.azure.com";
        private static string User = "mylogin";
        private static string  DBname = "postgres";
        private static string Password = "<server_admin_password>";
        private static string Port = "5432";

        static void Main(string[] args)
        {
            // Build connection string using parameters from portal
            //
            string connString =
                String.Format(
                    "Server={0}; User Id={1}; Database={2}; Port={3}; Password={4};SSLMode=Prefer",
                    Host,
                    User,
                    DBname,
                    Port,
                    Password);

            using (var conn = new NpgsqlConnection(connString))
            {

                Console.Out.WriteLine("Opening connection");
                conn.Open();


                using (var command = new NpgsqlCommand("SELECT * FROM inventory", conn))
                {

                    var reader = command.ExecuteReader();
                    while (reader.Read())
                    {
                        Console.WriteLine(
                            string.Format(
                                "Reading from table=({0}, {1}, {2})",
                                reader.GetInt32(0).ToString(),
                                reader.GetString(1),
                                reader.GetInt32(2).ToString()
                                )
                            );
                    }
                    reader.Close();
                }
            }

            Console.WriteLine("Press RETURN to exit");
            Console.ReadLine();
        }
    }
}

Tem algum problema? Deixe-nos saber.

Etapa 3: Atualizar dados

Utilize o código seguinte para se ligar e atualizar os dados com uma instrução SQL UPDATE. O código usa NpgsqlCommand classe com método:

Open() para estabelecer uma conexão com o Banco de Dados do Azure para servidor flexível PostgreSQL.
CreateCommand(), define a propriedade CommandText.
Método ExecuteNonQuery() para executar os comandos do banco de dados.

Importante

Substitua os parâmetros Anfitrião, DBName, Utilizador e Palavra-passe pelos valores que especificou ao criar o servidor e a base de dados.

using System;
using Npgsql;

namespace Driver
{
    public class AzurePostgresUpdate
    {
        // Obtain connection string information from the portal
        //
        private static string Host = "mydemoserver.postgres.database.azure.com";
        private static string User = "mylogin";
        private static string  DBname = "postgres";
        private static string Password = "<server_admin_password>";
        private static string Port = "5432";

        static void Main(string[] args)
        {
            // Build connection string using parameters from portal
            //
            string connString =
                String.Format(
                    "Server={0}; User Id={1}; Database={2}; Port={3}; Password={4};SSLMode=Prefer",
                    Host,
                    User,
                    DBname,
                    Port,
                    Password);

            using (var conn = new NpgsqlConnection(connString))
            {

                Console.Out.WriteLine("Opening connection");
                conn.Open();

                using (var command = new NpgsqlCommand("UPDATE inventory SET quantity = @q WHERE name = @n", conn))
                {
                    command.Parameters.AddWithValue("n", "banana");
                    command.Parameters.AddWithValue("q", 200);
                    int nRows = command.ExecuteNonQuery();
                    Console.Out.WriteLine(String.Format("Number of rows updated={0}", nRows));
                }
            }

            Console.WriteLine("Press RETURN to exit");
            Console.ReadLine();
        }
    }
}

Tem algum problema? Deixe-nos saber.

Etapa 4: Excluir dados

Utilize o código seguinte para se ligar e eliminar os dados com a instrução SQL DELETE.

O código usa a classe NpgsqlCommand com o método Open() para estabelecer uma conexão com o Banco de Dados do Azure para banco de dados de servidor flexível PostgreSQL. Em seguida, o código utiliza o método CreateCommand(), define a propriedade CommandText e chama o método ExecuteNonQuery() para executar os comandos da base de dados.

Importante

Substitua os parâmetros Anfitrião, DBName, Utilizador e Palavra-passe pelos valores que especificou ao criar o servidor e a base de dados.

using System;
using Npgsql;

namespace Driver
{
    public class AzurePostgresDelete
    {
        // Obtain connection string information from the portal
        //
        private static string Host = "mydemoserver.postgres.database.azure.com";
        private static string User = "mylogin@mydemoserver";
        private static string  DBname = "postgres";
        private static string Password = "<server_admin_password>";
        private static string Port = "5432";

        static void Main(string[] args)
        {
            // Build connection string using parameters from portal
            //
            string connString =
                String.Format(
                    "Server={0}; User Id={1}; Database={2}; Port={3}; Password={4};SSLMode=Prefer",
                    Host,
                    User,
                    DBname,
                    Port,
                    Password);

            using (var conn = new NpgsqlConnection(connString))
            {
                Console.Out.WriteLine("Opening connection");
                conn.Open();

                using (var command = new NpgsqlCommand("DELETE FROM inventory WHERE name = @n", conn))
                {
                    command.Parameters.AddWithValue("n", "orange");

                    int nRows = command.ExecuteNonQuery();
                    Console.Out.WriteLine(String.Format("Number of rows deleted={0}", nRows));
                }
            }

            Console.WriteLine("Press RETURN to exit");
            Console.ReadLine();
        }
    }
}

Clean up resources (Limpar recursos)

Para limpar todos os recursos usados durante este início rápido, exclua o grupo de recursos usando o seguinte comando:

az group delete \
    --name $AZ_RESOURCE_GROUP \
    --yes

Partilhar via

Guia de início rápido: use o .NET (C#) para conectar e consultar dados no Banco de Dados do Azure para PostgreSQL - Servidor Flexível

Pré-requisitos

Obter informações da ligação

Etapa 1: Conectar e inserir dados

Passo 2: Ler dados

Etapa 3: Atualizar dados

Etapa 4: Excluir dados

Clean up resources (Limpar recursos)

Comentários

Recursos adicionais

Partilhar via

Guia de início rápido: use o .NET (C#) para conectar e consultar dados no Banco de Dados do Azure para PostgreSQL - Servidor Flexível

Pré-requisitos

Obter informações da ligação

Etapa 1: Conectar e inserir dados

Passo 2: Ler dados

Etapa 3: Atualizar dados

Etapa 4: Excluir dados

Clean up resources (Limpar recursos)

Conteúdos relacionados

Comentários

Recursos adicionais