你可以在 Python Workers 中使用 Hyperdrive。
要在 Python Workers 中使用 Hyperdrive,请将兼容日期设置为 2026-09-08 或更晚。
Python Workers 中的 Hyperdrive 使用 TCP socket 支持 来建立数据库连接。 虽然可以使用任何适用于 TCP 连接的 Python 驱动, 我们强烈建议使用下表中的驱动,因为它们已经过测试并确认可与 Hyperdrive 配合使用。
| 驱动 | 文档 |
|---|---|
asyncpg(推荐) |
asyncpg 文档 ↗ |
pg8000 |
pg8000 文档 ↗ |
psycopg |
psycopg 文档 ↗ |
| 驱动 | 文档 |
|---|---|
aiomysql(推荐) |
aiomysql 文档 ↗ |
pymysql |
pymysql 文档 ↗ |
开始之前,请创建 Python Worker 并为数据库创建 Hyperdrive 配置。
-
将 Hyperdrive 绑定添加到你的 Wrangler 配置。将
<HYPERDRIVE_CONFIG_ID>替换为你的配置 ID。{ "$schema": "./node_modules/wrangler/config-schema.json", "name": "python-hyperdrive", "main": "src/main.py", // Set this to today's date "compatibility_date": "2026-11-14", "compatibility_flags": [ "python_workers" ], "hyperdrive": [ { "binding": "HYPERDRIVE", "id": "<HYPERDRIVE_CONFIG_ID>" } ] }name = "python-hyperdrive" main = "src/main.py" # Set this to today's date compatibility_date = "2026-11-14" compatibility_flags = ["python_workers"] [[hyperdrive]] binding = "HYPERDRIVE" id = "<HYPERDRIVE_CONFIG_ID>" -
安装驱动,并用对应示例替换
src/main.py。[project] dependencies = [ "asyncpg", ]src/main.pypython from contextlib import closing import asyncpg from workers import Response, WorkerEntrypoint class Default(WorkerEntrypoint): async def fetch(self, request): hd = self.env.HYPERDRIVE connection = await asyncpg.connect( host=hd.host, port=int(hd.port), user=hd.user, password=hd.password, database=hd.database, ssl=False, ) await connection.execute("SELECT 1") await connection.close()[project] dependencies = [ "aiomysql", ]src/main.pypython import aiomysql from workers import Response, WorkerEntrypoint class Default(WorkerEntrypoint): async def fetch(self, request): hd = self.env.HYPERDRIVE connection = await aiomysql.connect( host=hd.host, port=int(hd.port), user=hd.user, password=hd.password, db=hd.database, ssl=None, ) try: cursor = await connection.cursor() await cursor.execute("SELECT 1") result = await cursor.fetchone() return Response.json({"result": result[0]}) finally: connection.close() -
部署你的 Worker:
uv run pywrangler deploy
Python Workers 中的 TCP socket 支持在内部使用 connect API。
虽然大多数标准库 socket 操作均受支持,但某些底层操作可能无法按预期工作。
Python Workers 中的 socket 操作不会阻塞事件循环。 尽管 Python 原生 socket 操作是同步的,但 Python Workers 中底层的 TCP socket 实现是异步的。 因此,当某个请求等待 socket 操作完成时,仍可并发处理多个请求。
为确保同步数据库操作被串行化,请使用锁来防止并发访问:
import asyncio
lock = asyncio.Lock()
async with lock:
# Your database operation here
synchronous_db_operation()目前,Python Workers 仅支持同步 SQLAlchemy ORM。 由于 Python Workers 环境缺少 greenlet 支持,异步 SQLAlchemy ORM 尚不受支持。