跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

Python Workers

最后更新 查看 MarkdownAgent 设置

你可以在 Python Workers 中使用 Hyperdrive。 要在 Python Workers 中使用 Hyperdrive,请将兼容日期设置为 2026-09-08 或更晚。

支持的驱动

Python Workers 中的 Hyperdrive 使用 TCP socket 支持 来建立数据库连接。 虽然可以使用任何适用于 TCP 连接的 Python 驱动, 我们强烈建议使用下表中的驱动,因为它们已经过测试并确认可与 Hyperdrive 配合使用。

PostgreSQL

驱动 文档
asyncpg(推荐) asyncpg 文档 ↗
pg8000 pg8000 文档 ↗
psycopg psycopg 文档 ↗

MySQL

驱动 文档
aiomysql(推荐) aiomysql 文档 ↗
pymysql pymysql 文档 ↗

连接到数据库

开始之前,请创建 Python Worker 并为数据库创建 Hyperdrive 配置。

  1. 将 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>"
  2. 安装驱动,并用对应示例替换 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()
  3. 部署你的 Worker:

    uv run pywrangler deploy

限制与兼容性

Socket 支持

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

SQLAlchemy 支持

目前,Python Workers 仅支持同步 SQLAlchemy ORM。 由于 Python Workers 环境缺少 greenlet 支持,异步 SQLAlchemy ORM 尚不受支持。

这篇文档对您有帮助吗?