A biblioteca psycopg2 é um adaptador popular de banco de dados PostgreSQL para a linguagem de programação Python. É conhecida por sua eficiência, segurança de threads e implementação completa da especificação da API de banco de dados Python 2.0. Vamos explorar suas funcionalidades e ver alguns exemplos de código. Mais adiante neste artigo, aprenderemos sobre o IronPDF , uma biblioteca de geração de PDFs da Iron Software .

O Psycopg2 foi projetado para ser eficiente e seguro, tornando-o adequado para aplicações com uso intensivo de múltiplos threads. Algumas de suas principais características incluem:

• Segurança de threads: Várias threads podem compartilhar a mesma conexão — a capacidade de lidar com aplicativos multithread que criam e destroem muitos cursores.
• Cursores do lado do cliente e do servidor: Manipulam conjuntos de dados grandes de forma eficiente.
• Comunicação e notificações assíncronas: Suporte para operações assíncronas.
• Suporte a CÓPIA: Carregue dados em massa de forma eficiente usando COPIAR PARA e COPIAR DE.
• Sistema de Adaptação: Adapte automaticamente tipos Python para tipos PostgreSQL; o pacote transpõe automaticamente para os tipos de dados PostgreSQL correspondentes.
• Compatível com Unicode e Python 3: Suporte completo para Unicode e Python 3.

Instalação

Você pode instalar o psycopg2 usando o pip:

pip install psycopg2

pip install psycopg2

Alternativamente, você pode usar o arquivo setup.py do pacote de origem localmente. Você pode obter o pacote de código-fonte no repositório de código-fonte aqui :

python setup.py build
sudo python setup.py install

python setup.py build
sudo python setup.py install

Para um pacote independente que não requer um compilador ou bibliotecas externas, você pode usar o pacote psycopg2-binary:

pip install psycopg2-binary

pip install psycopg2-binary

Uso básico

Aqui está um exemplo simples para você começar a usar o psycopg2.

Conectando-se a um banco de dados

Primeiro, você precisará se conectar ao seu banco de dados PostgreSQL:

import psycopg2

# Connect to your PostgreSQL database
conn = psycopg2.connect(
    dbname="your_dbname",
    user="your_username",
    password="your_password",
    host="your_host",
    port="your_port"
)

# Create a cursor object
cur = conn.cursor()

import psycopg2

# Connect to your PostgreSQL database
conn = psycopg2.connect(
    dbname="your_dbname",
    user="your_username",
    password="your_password",
    host="your_host",
    port="your_port"
)

# Create a cursor object
cur = conn.cursor()

Executando consultas

Você pode executar consultas SQL usando o objeto cursor:

# Execute a query
cur.execute("SELECT * FROM your_table")

# Fetch all results
rows = cur.fetchall()

# Print the results
for row in rows:
    print(row)

# Execute a query
cur.execute("SELECT * FROM your_table")

# Fetch all results
rows = cur.fetchall()

# Print the results
for row in rows:
    print(row)

Inserindo dados

Eis como inserir dados em uma tabela:

# Insert data into a table
cur.execute(
    "INSERT INTO your_table (column1, column2) VALUES (%s, %s)",
    ("value1", "value2")
)

# Commit the transaction
conn.commit()

# Insert data into a table
cur.execute(
    "INSERT INTO your_table (column1, column2) VALUES (%s, %s)",
    ("value1", "value2")
)

# Commit the transaction
conn.commit()

Encerrando a conexão

Não se esqueça de fechar o cursor e a conexão quando terminar:

# Close the cursor and connection
cur.close()
conn.close()

# Close the cursor and connection
cur.close()
conn.close()

Recursos avançados

Utilizando o comando COPY para carregamento em massa

O comando COPY é útil para carregar dados em massa:

# Use COPY to load data from a file
with open('data.csv', 'r') as f:
    cur.copy_from(f, 'your_table', sep=',')

conn.commit()

# Use COPY to load data from a file
with open('data.csv', 'r') as f:
    cur.copy_from(f, 'your_table', sep=',')

conn.commit()

Notificações assíncronas

Você pode ficar à escuta de notificações assíncronas do banco de dados:

# Listen for notifications
cur.execute("LISTEN your_channel")

# Wait for a notification
conn.poll()

while conn.notifies:
    notify = conn.notifies.pop(0)
    print("Got NOTIFY:", notify.payload)

# Listen for notifications
cur.execute("LISTEN your_channel")

# Wait for a notification
conn.poll()

while conn.notifies:
    notify = conn.notifies.pop(0)
    print("Got NOTIFY:", notify.payload)

Apresentando o IronPDF

IronPDF é uma poderosa biblioteca Python projetada para criar, editar e assinar PDFs usando HTML, CSS, imagens e JavaScript. Oferece desempenho de nível comercial com baixo consumo de memória. As principais características incluem:

Conversão de HTML para PDF:

Converter arquivos HTML, strings HTML e URLs em PDFs. Por exemplo, renderize uma página da web como um PDF usando o renderizador de PDF do Chrome.

Suporte multiplataforma:

Compatível com diversas plataformas .NET , incluindo .NET Core, .NET Standard e .NET Framework. É compatível com Windows, Linux e macOS.

Edição e assinatura:

Configure propriedades, adicione segurança com senhas e permissões e aplique assinaturas digitais aos seus PDFs.

Modelos e configurações de página:

Personalize PDFs com cabeçalhos, rodapés, números de página e margens ajustáveis. Suporta layouts responsivos e tamanhos de papel personalizados.

Conformidade com as normas:

Está em conformidade com os padrões PDF, como PDF/A e PDF/UA. Suporta codificação de caracteres UTF-8 e lida com recursos como imagens, CSS e fontes.

Gere documentos PDF usando IronPDF e psycopg2.

import psycopg2
from ironpdf import *

# Apply your license key
License.LicenseKey = "Key"

# Connect to your local PostgreSQL database
conn = psycopg2.connect(
    dbname="demo",
    user="postgres",
    password="postgres",
    host="localhost",
    port="5432"
)

# Create a cursor object
cur = conn.cursor()

# Create the users table if it doesn't already exist
cur.execute('''
    CREATE TABLE IF NOT EXISTS users (
        id INTEGER PRIMARY KEY,
        name TEXT NOT NULL,
        age INTEGER
    )
''')

# Commit the transaction
conn.commit()

# Define the SQL statement for inserting data into the table
insert_query = '''
    INSERT INTO users (id, name, age)
    VALUES (%s, %s, %s)
'''

# Data to be inserted
user_data = [
    (1, 'John', 25),
    (2, 'Smith', 35),
    (3, 'Tom', 29)
]

# Insert data into the table
for user in user_data:
    cur.execute(insert_query, user)

# Commit the transaction
conn.commit()

# Execute a query to retrieve data from the users table
cur.execute("SELECT * FROM users")

# Fetch all results
rows = cur.fetchall()

# Initialize PDF renderer
renderer = ChromePdfRenderer()

# Create a PDF from HTML content
content = "<h1>Awesome Iron PDF with psycopg2</h1>"
content += "<p>Table data:</p>"
for row in rows:
    print(row)
    content += f"<p>{row}</p>"

# Close the cursor and connection
cur.close()
conn.close()

# Render HTML content as PDF
pdf = renderer.RenderHtmlAsPdf(content)

# Save the PDF to a file
pdf.SaveAs("Demopsycopg2.pdf")

import psycopg2
from ironpdf import *

# Apply your license key
License.LicenseKey = "Key"

# Connect to your local PostgreSQL database
conn = psycopg2.connect(
    dbname="demo",
    user="postgres",
    password="postgres",
    host="localhost",
    port="5432"
)

# Create a cursor object
cur = conn.cursor()

# Create the users table if it doesn't already exist
cur.execute('''
    CREATE TABLE IF NOT EXISTS users (
        id INTEGER PRIMARY KEY,
        name TEXT NOT NULL,
        age INTEGER
    )
''')

# Commit the transaction
conn.commit()

# Define the SQL statement for inserting data into the table
insert_query = '''
    INSERT INTO users (id, name, age)
    VALUES (%s, %s, %s)
'''

# Data to be inserted
user_data = [
    (1, 'John', 25),
    (2, 'Smith', 35),
    (3, 'Tom', 29)
]

# Insert data into the table
for user in user_data:
    cur.execute(insert_query, user)

# Commit the transaction
conn.commit()

# Execute a query to retrieve data from the users table
cur.execute("SELECT * FROM users")

# Fetch all results
rows = cur.fetchall()

# Initialize PDF renderer
renderer = ChromePdfRenderer()

# Create a PDF from HTML content
content = "<h1>Awesome Iron PDF with psycopg2</h1>"
content += "<p>Table data:</p>"
for row in rows:
    print(row)
    content += f"<p>{row}</p>"

# Close the cursor and connection
cur.close()
conn.close()

# Render HTML content as PDF
pdf = renderer.RenderHtmlAsPdf(content)

# Save the PDF to a file
pdf.SaveAs("Demopsycopg2.pdf")

Explicação do código

O script demonstra a interação com um banco de dados PostgreSQL usando psycopg2, manipulação de dados (criação, inserção, recuperação) e integração com IronPDF para geração de documentos.

1. Conexão com o Banco de Dados: Conecta-se a um banco de dados PostgreSQL local chamado "demo" usando psycopg2, especificando credenciais para autenticação do usuário e detalhes do host do banco de dados.

2. Criação de Tabela: Define e executa uma instrução SQL para criar uma tabela chamada users se ela ainda não existir. A tabela possui colunas id (inteiro, chave primária), name (texto, não nulo) e age (inteiro).

3. Inserção de Dados: Insere linhas de dados na tabela users usando consultas parametrizadas (user_data). Cada tupla contém valores para id, name e age.

4. Gerenciamento de transações: Confirma a transação após a criação da tabela e a inserção de dados para garantir que as alterações sejam salvas no banco de dados.

5. Recuperação de Dados: Executa uma consulta SELECT para buscar todas as linhas (SELECT * FROM users) da tabela users e recupera os resultados (rows).

6. Geração de PDF: Usa IronPDF para gerar um documento PDF a partir de conteúdo HTML. O conteúdo HTML inclui um título e uma representação formatada dos dados recuperados da tabela users.

7. Salvar arquivo: Salva o documento PDF gerado como "Demopsycopg2.pdf" no diretório atual.

8. Fechamento da Conexão: Fecha o cursor do banco de dados (cur) e a conexão com o banco de dados (conn) para liberar recursos e garantir a limpeza adequada.

Para tratamento de exceções, envolva o script em blocos try-catch para garantir que todas as operações de erro sejam tratadas caso ocorra um problema de consulta ou conexão.

Saída

PDF

Licença IronPDF

O IronPDF funciona com a chave de licença do Python. O IronPDF for Python oferece uma chave de licença de avaliação gratuita para permitir que os usuários testem seus diversos recursos antes de comprar.

Insira a chave de licença no início do script antes de usar o pacote IronPDF :

from ironpdf import *
# Apply your license key
License.LicenseKey = "key"

from ironpdf import *
# Apply your license key
License.LicenseKey = "key"

Conclusão

Psycopg2 é uma biblioteca poderosa e flexível para interagir com bancos de dados PostgreSQL em Python. Seu conjunto abrangente de recursos e design eficiente fazem dele uma excelente escolha para operações de banco de dados simples e complexas. IronPDF é um pacote e biblioteca Python robusto que facilita a criação, manipulação e renderização de documentos PDF diretamente de aplicações Python. Oferece funcionalidades abrangentes para gerar PDFs a partir de conteúdo HTML, integrando-se perfeitamente com as tecnologias web existentes. Com o IronPDF, os desenvolvedores podem automatizar de forma eficiente a geração de relatórios, faturas e outros documentos, aumentando a produtividade e a experiência do usuário. Suas funcionalidades incluem formulários PDF interativos, extração de texto, fusão e divisão de PDFs, além da adição de recursos de segurança como proteção por senha. A versatilidade e a facilidade de uso do IronPDF o tornam uma ferramenta valiosa para desenvolvedores que desejam implementar funcionalidades de geração e manipulação de PDFs em seus projetos Python.