Como Conectar e Usar o PostgreSQL em Python
Ligações Rápidas
⭐ Descarregar e Instalar o PostgreSQL
⭐ Instalar a Biblioteca Necessária
⭐ Obter Credenciais Usando o pgAdmin4
⭐ Ligar ao Servidor Servidor Postgres
⭐ Como criar uma base de dados Postgres
⭐ Como eliminar uma base de dados Postgres
Principais lições
Para utilizar o PostgreSQL no seu sistema operativo, é necessário primeiro fazer o download e instalar a versão apropriada do software. Uma vez instalado, é possível estabelecer uma conexão com o banco de dados usando psycopg2, que é uma escolha popular entre os desenvolvedores Python para interagir com bancos de dados PostgreSQL.
Utilize o pgAdmin4 como um meio de obter credenciais do servidor para estabelecer uma conexão com um servidor PostgreSQL através da implementação de código Python.
Utilizar comandos Python e SQL para estabelecer, verificar ou eliminar uma base de dados PostgreSQL utilizando a linguagem de script Python.
Para executar código Python que recupera informações armazenadas em um banco de dados PostgreSQL, é necessário estabelecer um meio de comunicação entre os dois sistemas. Esse processo envolve a utilização de protocolos e sintaxe apropriados para facilitar a interação entre a aplicação Python e o servidor de banco de dados PostgreSQL. Consequentemente, uma vez estabelecida com êxito esta ligação, esta pode ser utilizada para realizar várias operações, tais como a execução de comandos SQL, a consulta de dados específicos e a gravação ou atualização de registos na base de dados.
Descarregar e instalar o PostgreSQL
O PostgreSQL apresenta uma opção adequada para a execução de tarefas de codificação, permitindo-lhe obter a versão necessária com base no sistema operativo do seu computador. Este versátil sistema de gestão de bases de dados pode ser descarregado e instalado em plataformas populares, como o Microsoft Windows, o Apple macOS e a distribuição Ubuntu Linux da Canonical.
O procedimento de instalação do software pode variar consoante o sistema operativo utilizado. É essencial seguir as directrizes especificadas para garantir uma experiência de instalação perfeita e sem problemas.
Instalar a biblioteca necessária
Utilizando a linguagem de programação Python, pode-se empregar a biblioteca psycopg2 como um meio de estabelecer comunicação com um banco de dados PostgreSQL via Python.Para verificar se a biblioteca foi instalada com êxito, execute o seguinte comando no interpretador Python:
import psycopg2
Caso encontre uma notificação indicando a ausência de um módulo específico, como ‘psycopg2’, pode resolver o problema executando o processo de instalação utilizando o comando fornecido.
pip install psycopg2
O PIP (Python Package Manager) é uma ferramenta fácil de utilizar para gerir e instalar pacotes Python, disponível em várias plataformas, como Windows, Mac e Linux. Isto simplifica o processo de aquisição dos componentes Python necessários, reduzindo a complexidade frequentemente associada aos procedimentos de instalação.
Obter credenciais usando pgAdmin4
Você pode usar o aplicativo pgAdmin4 para gerenciar seus bancos de dados Postgres em um ambiente GUI. Poderá tê-la instalado ao mesmo tempo que instalou o Postgres, mas pode transferir o pgAdmin4 e instalá-lo separadamente, se necessário.
Para acessar o servidor PostgreSQL utilizando o pgAdmin4, é necessário obter as credenciais do servidor. O processo de aquisição destas credenciais envolve uma série de passos que podem ser executados através da interface da aplicação. Ao fornecer as informações necessárias e os detalhes de autenticação, é possível estabelecer com êxito uma ligação ao servidor de base de dados e prosseguir com outras operações no pgAdmin4.
Para aceder ao pgAdmin4 a partir do menu da aplicação, siga estes passos:1. Abra o seu browser preferido e navegue até à localização onde instalou o pgAdmin4.2. Localize o ícone ou a ligação para o pgAdmin4 no menu da aplicação e clique no mesmo para iniciar a aplicação.
Clique na opção “Servers” (Servidores) localizada no lado esquerdo da interface principal da sua aplicação para obter mais instruções.
⭐ Introduza a palavra-passe Postgres que introduziu durante a configuração. 
⭐ Depois de se conectar ao servidor, clique com o botão direito do mouse no item PostgreSQL 16 e escolha Propriedades . 
Na janela de Propriedades, navegue até a opção “Conexão” e selecione-a.
⭐ Anote o nome do host , o número da porta e o nome de usuário . 
Ligar ao Servidor Postgres
Utilizando as suas qualificações, pode empregar a biblioteca psycopg2 para estabelecer uma ligação com o seu servidor PostgreSQL utilizando a função connect de acordo com o seguinte formato:
conn = psycopg2.connect(host='localhost', port= '5432', user='postgres', password='your password here')
Subsequentemente, deve-se empregar o objeto cursor para emitir comandos PostgreSQL dentro de uma aplicação Python:
cur = conn.cursor()
Para agilizar o processo de commit de código em Python, pode-se optar por ativar o recurso de commit automático. Ao fazê-lo, torna-se desnecessário incluir comandos de confirmação individuais após cada linha de código, uma vez que todo o bloco será automaticamente confirmado após a conclusão.
conn.set_session(autocommit = True)
Pode executar estes comandos coletivamente para estabelecer uma ligação com uma instância local do seu servidor de base de dados PostgreSQL.
Como Criar um Banco de Dados Postgres
Um banco de dados PostgreSQL serve como um repositório essencial para um grupo de tabelas interconectadas, e pode ser estabelecido usando a instrução SQL CREATE DATABASE . Para criar uma nova base de dados, pode utilizar o método execute() de um objeto cursor, passando-lhe o comando SQL adequado.
try:
cur.execute('''CREATE DATABASE DB_NAME''')
except psycopg2.Error as e:
print(e)
É imperativo assegurar que todas as potenciais excepções são cuidadosamente geridas e tratadas, de modo a manter a estabilidade do sistema e evitar que erros imprevistos perturbem as operações. Embora este exemplo específico apresente simplesmente qualquer exceção encontrada para fins educativos, é crucial implementar mecanismos robustos de tratamento de excepções no código de produção real para facilitar a resposta adequada e as estratégias de recuperação quando ocorrem excepções.
Verificação da base de dados no pgAdmin4
Após a execução da consulta mencionada anteriormente, é possível verificar a sua execução bem sucedida navegando para a interface do pgAdmin, actualizando o catálogo atual de bases de dados disponíveis e identificando subsequentemente a base de dados recém-criada nessa listagem.
Incorporando o trecho de código fornecido, pode-se gerar um novo banco de dados chamado “music” quando executado no contexto de uma sessão ativa conectada a uma instância do PostgreSQL com versão 16 ou superior. O banco de dados recém-criado aparecerá subsequentemente entre os bancos de dados listados exibidos sob o título “Postgres16 > Databases.
Como eliminar uma base de dados Postgres
Se alguém desejar eliminar uma determinada base de dados do seu sistema, pode executar a seguinte instrução para a remover ou “eliminar”:
try:
cur.execute('''DROP DATABASE MUSIC''')
except psycopg2.Error as e:
print(e)
Em vez de utilizar o comando “create”, é necessário utilizar o comando “drop”. Após a execução deste comando, a base de dados em causa deixará de ser visível.