asyncpg

asyncpg -- 用於 Python/asyncio 的快速 PostgreSQL 資料庫客戶端程式庫

asyncpg是專門為 PostgreSQL 和 Python/asyncio 設計的資料庫介面庫。 asyncpg 是 PostgreSQL 伺服器二進位協定的高效、簡潔的實現，可與 Python 的asyncio框架一起使用。 您可以在介紹性部落格文章中閱讀有關 asyncpg 的更多資訊。

asyncpg 需要 Python 3.8 或更高版本，並且支援 PostgreSQL 版本 9.5 至 17。

文件

專案文件可以在這裡找到。

表現

在我們的測試中，asyncpg 平均比 psycopg3 快5 倍。

上述結果是 2023 年 6 月使用 PostgreSQL 用戶端驅動程式基準測試工具台所獲得的基準的幾何平均值（點擊圖表以查看完整詳細資訊）。

特徵

asyncpg 原生實作 PostgreSQL 伺服器協定並直接公開其功能，而不是將它們隱藏在 DB-API 等通用外觀後面。

這使得 asyncpg 能夠提供易於使用的支援：

• 準備好的陳述

• 可捲動遊標

• 對查詢結果進行部分迭代

• 複合型別、陣列及其任意組合的自動編碼和解碼

• 對自訂資料類型的直接支持

安裝

asyncpg 可在 PyPI 上使用。 當不使用 GSSAPI/SSPI 驗證時，它沒有依賴性。 使用pip安裝：

 $ pip 安裝 asyncpg

如果您需要 GSSAPI/SSPI 驗證，請使用：

 $ pip install 'asyncpg[gssauth]'

有關更多詳細信息，請參閱文件。

基本用法

import asyncioimport asyncpgasync def run():conn = wait asyncpg.connect(user='user',password='password',database='database',host='127.0.0.1')values = wait conn.fetch('SELECT * 來自mytable WHERE id = $1',10,
    )等待 conn.close()asyncio.run(run())

執照

asyncpg 是在 Apache 2.0 許可證下開發和分發的。