Ícone de mensagem
Ir para o conteúdo do rodapé
  1. IronPDF for Python
  2. Blog do IronPDF for Python
  3. Ajuda do Python
  4. psycopg2
AJUDA DO PYTHON

psycopg2 (Como funciona para desenvolvedores)

Curtis Chau
Curtis Chau
Atualizado:

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: Adapta automaticamente os tipos Python aos 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
SHELL

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
SHELL

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
SHELL

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()
PYTHON

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)
PYTHON

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()
PYTHON

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()
PYTHON

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()
PYTHON

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)
PYTHON

Apresentando o IronPDF

psycopg2 (Como funciona para desenvolvedores): Figura 1 - IronPDF: A biblioteca PDF for Python

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")
PYTHON

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 as credenciais para autenticação do usuário e os 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 caso ela ainda não exista. A tabela possui as 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: Utiliza 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 obtidos da tabela users.
  7. Salvar arquivo: Salva o documento PDF gerado como "Demopsycopg2.pdf" no diretório atual.
  8. Fechamento de 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

psycopg2 (Como funciona para desenvolvedores): Figura 2 - Exemplo de saída do console

PDF

psycopg2 (Como funciona para desenvolvedores): Figura 3 - Exemplo de saída utilizando psycopg2 para armazenar e recuperar dados enquanto o IronPDF gera um relatório em 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"
PYTHON

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.

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais

Artigos relacionados

Teste grátis por 30 dias → Produto completo. Sem limites. Sem cartão. Comece seu teste gratuito

Equipe de suporte de ferro

Estamos online 24 horas por dia, 5 dias por semana.
Bater papo
E-mail
Liga para mim