用途:整理 Lakebase Autoscaling(Databricks 下一代托管 PostgreSQL,面向 OLTP)的实践模式,用于创建/管理项目、分支、端点与计算、凭证、反向 ETL 同步表和数据库驱动连接。
主要能力:自动扩缩计算、数据库分支、缩容至零、即时恢复、Delta 到 Postgres 的同步表。资源模型为项目→分支(含主读写端点、只读副本、角色、数据库→模式/表);规范名形如 projects/{project_id}/branches/{branch_id}/endpoints/{endpoint_id}。新建项目默认分支 production、默认数据库 databricks_postgres,并建立创建者的 Postgres 角色。
用法:不存在独立的 Lakebase Python SDK,管理用 databricks-sdk,SQL 用标准 Postgres 驱动(psycopg、SQLAlchemy、JDBC、pgx 等)。凭证须用 WorkspaceClient().postgres.generate_database_credential(endpoint=endpoint_name) 生成,取其 token 作为 Postgres 密码,所有连接 sslmode=require;不要使用工作区级 OAuth token 当密码。生产 Python 应用推荐 psycopg_pool.ConnectionPool 配合自定义 OAuthConnection,在物理连接打开/回收时获取新凭证,建议 max_lifetime=2700 以在 1 小时令牌过期前回收。端点主机取自 w.postgres.get_endpoint(...).status.hosts.host。安装:pip install -U "databricks-sdk>=0.81.0" "psycopg[binary,pool]>=3.1" "sqlalchemy>=2"。多数增删改返回长时运行操作,需调用 .wait();更新需 FieldMask。
适用场景:自动扩缩计算 0.5–32 CU(max−min≤16),固定常开计算 40–112 CU,1 CU 约 2 GB 内存;Postgres 16/17。AWS 区域含 us-east-1、us-east-2、eu-central-1、eu-west-1、eu-west-2、ap-south-1、ap-southeast-1、ap-southeast-2;Azure beta 含 eastus2、westeurope、westus。
限制:暂不支持高可用可读从库(改用只读副本)、Feature Store 集成、有状态 AI 代理记忆集成、Postgres 到 Delta 同步、自定义计费标签/无服务器预算策略、从 Provisioned 直接迁移(可用 pg_dump/pg_restore 或反向 ETL)。反向 ETL 仅 Delta 到 Postgres;触发/持续同步表需 Delta Change Data Feed。连接可能因平台 24 小时空闲超时和 3 天最大连接寿命被关闭;缩容至零唤醒自动但应用应重试。macOS 对长主机名 DNS 可能失败,可解析为 IP 并同时传 host 与 hostaddr。