psycopg2 (開発者のための仕組み)

psycopg2ライブラリは、Pythonプログラミング言語用の人気のあるPostgreSQLデータベースアダプターです。 効率性、スレッドセーフ、Python DB API 2.0仕様の完全な実装で知られています。 その機能とコード例を見てみよう。 この記事の後半では、Iron Software の PDF 生成ライブラリである IronPDF について学びます。

イントロダクション

Psycopg2 は効率的で安全に設計されており、多くのスレッドを使用するアプリケーションに適しています。 主要な機能には以下が含まれます：

• スレッドセーフティ: 複数のスレッドが同じ接続を共有できます。多くのカーソルを作成および破棄するマルチスレッドアプリケーションを処理する機能があります。
• クライアントサイドおよびサーバーサイドカーソル: 大規模なデータセットを効率的に処理します。
• 非同期通信と通知: 非同期操作のサポート。
• COPYサポート: COPY TOおよびCOPY FROMを使用して、効率的にデータを一括読み込みします。
• 適応システム: Pythonの型を自動的にPostgreSQLの型に適応させます。このパッケージは自動的に対応するPostgreSQLデータ型に転送されます。
• Unicode と Python 3 に対応: Unicode と Python 3 を完全サポート。

インストール

pipを使用してpsycopg2をインストールできます。

pip install psycopg2

pip install psycopg2

または、ローカルでソースパッケージからsetup.pyを使用することもできます。 ソースコードリポジトリからソースパッケージをこちらから入手できます。

python setup.py build
sudo python setup.py install

py

コンパイラや外部ライブラリを必要としないスタンドアロン・パッケージには、psycopg2-binaryパッケージを使うことができる：

pip install psycopg2-binary

pip install psycopg2-binary

基本的な使用法

psycopg2を使い始めるための簡単な例です。

データベースへの接続

まず、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()

py

クエリーの実行

カーソル・オブジェクトを使ってSQLクエリーを実行することができます：

# Execute a query
cur.execute("SELECT * FROM your_table")
# Fetch all results
rows = cur.fetchall()
# Print the results
for row in rows:
    print(row)

py

データの挿入

ここでは、テーブルにデータを挿入する方法を説明する：

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

py

コネクションを閉じる

終わったらカーソルと接続を閉じるのを忘れずに：

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

py

高度な機能

COPYによる一括読み込み

COPYコマンドは、データの一括ロードに役立つ：

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

py

非同期通知

データベースからの非同期通知をリッスンすることができる：

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

py

IronPDFの紹介

IronPDF は、HTML、CSS、画像、JavaScript を使用してPDFの作成、編集、署名を行うために設計された強力なPythonライブラリです。 商業利用レベルのパフォーマンスを、低メモリフットプリントで提供します。 主要な機能には次のものが含まれます：

HTMLからPDFへの変換:

HTMLファイル、HTML文字列、URLをPDFに変換。 例えば、Chrome PDFレンダラーを使用してウェブページをPDFとしてレンダリングします。

クロスプラットフォームサポート:

.NET Core、.NET Standard、.NET Frameworkなど、さまざまな.NETプラットフォームに対応。 Windows、Linux、macOSに対応しています。

編集と署名:

プロパティを設定し、パスワードとアクセス許可を使用してセキュリティを追加し、PDFに電子署名を適用します。

ページテンプレートと設定：

ヘッダー、フッター、ページ番号、調整可能な余白でPDFをカスタマイズ。 レスポンシブレイアウトとカスタム用紙サイズをサポートします。

標準準拠:

PDF/AやPDF/UAなどのPDF標準に準拠。 UTF-8文字エンコーディングをサポートし、画像、CSS、フォントなどのアセットを処理します。

IronPDFとpsycopg2を使って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()
cur.execute('''
    CREATE TABLE IF NOT EXISTS users (
        id INTEGER PRIMARY KEY,
        name TEXT NOT NULL,
        age INTEGER
    )
''')
# Commit the transaction with connection object
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
userData1 = (1, 'John', 25)
# Execute the SQL command to insert data
cur.execute(insert_query, userData1)
# Data to be inserted
userData2 = (2, 'Smith', 35)
# Execute the SQL command to insert data
cur.execute(insert_query, userData2)
# Data to be inserted
userData3 = (3, 'Tom', 29)
# Execute the SQL command to insert data
cur.execute(insert_query, userData3)
# Commit the transaction
conn.commit()
# Execute a query
cur.execute("SELECT * FROM users")
# Fetch all results
rows = cur.fetchall() 
renderer = ChromePdfRenderer()
# Create a PDF from a HTML string using Python
content = "<h1>Awesome Iron PDF with psycopg2</h1>"
content += "<p>table data</p>"
for row in rows:
    print(row)
    content += "<p>"+str(row)+"</p>"
# Close the cursor and connection
cur.close()
conn.close()
pdf = renderer.RenderHtmlAsPdf(content)
    # Export to a file or Stream
pdf.SaveAs("Demopsycopg2.pdf")

py

コードの説明

このスクリプトは、`psycopg2`を使用したPostgreSQLデータベースとの対話、データ操作（作成、挿入、取得）、およびドキュメント生成のための`IronPDF`との統合を示しています。

1. データベース接続: ユーザー認証とデータベースホストの詳細を指定して、psycopg2を使用して「demo」という名前のローカルPostgreSQLデータベースに接続します。

2. テーブルの作成: 既に存在しない場合、`users`という名前のテーブルを作成するためのSQL文を定義し実行します。テーブルには、`id`（整数、主キー）、`name`（テキスト、null不可）、および`age`（整数）の列があります。

3. データ挿入: パラメータ化されたクエリ（`userData1`, `userData2`, `userData3`）を使用して、`users` テーブルに3行のデータを挿入します。 各タプルには、`id`、`name`、および`age`の値が含まれています。

4. トランザクション管理: テーブル作成およびデータ挿入後にトランザクションをコミットして、変更がデータベースに保存されることを確認します。

5. データ取得: `users` テーブルからすべての行 (`SELECT * FROM users`) を取得する SELECT クエリを実行し、結果 (`rows`) を取得します。

6. PDF生成: `IronPDF`を使用してHTMLコンテンツからPDFドキュメントを生成します。 このHTMLコンテンツには、タイトルと`users`テーブルから取得されたデータのフォーマットされた表現が含まれています。

7. ファイル保存: 生成されたPDFドキュメントを現在のディレクトリに「Demopsycopg2.pdf」として保存します。

8. 接続の終了: この機能は、リソースを解放し、適切なクリーンアップを保証するためにデータベースカーソル (`cur`) とデータベース接続 (`conn`) を閉じます。

   例外処理については、スクリプトをtry-catchブロックで囲むことで、クエリの1つが失敗したり、接続に失敗したりした場合に、すべてのエラー処理が行われるようにすることができます。

出力

PDF

IronPDFライセンス

IronPDF はPythonのライセンスキーで動作します。 IronPDF for Pythonは購入前にその豊富な機能を試すことができる無料トライアルライセンスキーを提供しています。

IronPDFパッケージを使用する前に、ライセンスキーをスクリプトの最初に置いてください：

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

py

結論

Psycopg2は、PythonでPostgreSQLデータベースを操作するための強力で柔軟なライブラリです。 その包括的な機能セットと効率的な設計により、単純なデータベース操作にも複雑なデータベース操作にも最適です。 IronPDF は、Pythonアプリケーションから直接PDFドキュメントの作成、操作、レンダリングを容易にする強力なPythonパッケージおよびライブラリです。 HTMLコンテンツからPDFを生成するための包括的な機能を提供し、既存のWebテクノロジーとシームレスに統合します。 IronPDFを使えば、開発者はレポート、請求書、その他のドキュメントの作成を効率的に自動化し、生産性とユーザーエクスペリエンスを向上させることができます。 その機能には、インタラクティブなPDFフォーム、テキスト抽出、PDFの結合と分割、パスワード保護などのセキュリティ機能の追加が含まれます。 IronPDFの多用途性と使いやすさは、PythonプロジェクトにPDF生成と操作機能を実装しようとしている開発者にとって価値のあるツールです。