通过


连接字符串

重要

Lakebase 自动缩放在以下区域中处于 eastus2 版: , westeuropewestus

Lakebase 自动缩放是最新版本的 Lakebase,可自动缩放计算、缩放到零、分支和即时还原。 有关 与 Lakebase 预配的功能比较,请参阅 在版本之间进行选择

Lakebase 连接字符串包括角色、主机名和数据库名称。 对于本机 Postgres 密码身份验证,连接字符串还包括密码。 对于 OAuth 身份验证,需要提供 OAuth 令牌来代替密码。 请参阅 “获取 OAuth 令牌”。

连接字符串格式

OAuth 身份验证:

postgresql://your-email@example.com@ep-abc-123.databricks.com/databricks_postgres?sslmode=require
             ^                      ^                         ^
       role -|                      |- hostname               |- database

本机 Postgres 密码身份验证:

postgresql://role_name:password@ep-abc-123.databricks.com/databricks_postgres?sslmode=require
             ^         ^        ^                         ^
       role -|         |        |- hostname               |- database
                       |
                       |- password

注释

主机名包括具有前缀(例如)ep-ep-abc-123的计算终结点的 ID。 这标识为数据库提供服务的特定计算。

连接字符串组件

可以使用单独的环境变量或单个 DATABASE_URL环境变量来配置 Postgres,具体取决于应用程序或框架的预期。

若要使用单个组件,请使用:

PGHOST=ep-abc-123.databricks.com
PGDATABASE=databricks_postgres
PGUSER=role_name
PGPASSWORD=your-password or token
PGPORT=5432

若要使用单个环境变量,请执行以下作:

DATABASE_URL="postgresql://role_name:password@ep-abc-123.databricks.com/databricks_postgres?sslmode=require"

连接安全性

  • SSL/TLS 加密:Lakebase 自动缩放要求所有连接都使用 SSL/TLS 加密。 该 sslmode=require 参数强制实施此要求。 默认情况下,Lakebase App 中提供的所有连接字符串都包含此参数。
  • 专用连接:Lakebase 自动缩放支持通过 Azure Databricks 前端 PrivateLink 建立连接。

港口

Lakebase 使用默认 Postgres 端口 5432

网络配置

连接到 Lakebase 数据库时,请考虑以下网络要求:

  • 经典计算连接: 若要将经典计算连接到 PostgreSQL,请在网络安全组中打开 TCP 端口 5432,以连接到工作区 IP ACL 地址或范围。

后续步骤