从 SQL 客户端访问数据库实例

重要

此功能在以下区域中为公共预览版westuswestus2eastuseastus2centralussouthcentralusnortheuropewesteuropeaustraliaeastbrazilsouthcanadacentralcentralindiasoutheastasiauksouth

本页介绍如何从 SQL 客户端访问 Lakebase 数据库实例,并演练如何从中 psql连接到数据库实例。

可以从外部工具(如 psqlDBeaver 和 pgAdmin4)访问数据库实例。 借助这些工具,还可以生成仪表板,以可视化数据库指标以实现性能、存储使用情况和查询效率。

psql命令行工具是 PostgreSQL 的内置客户端,提供对数据库实例的直接交互式访问。 使用 psql 提供完整的 Postgres 功能,并与现有的 Postgres 工作流和工具集成。

DBeaver 和 pgAdmin 是开源工具,可用于管理 Postgres 数据库。 有关如何安装和连接的说明,请参阅 DBeaver 文档pgAdmin 文档

在您开始之前

  • 必须安装 psql。 有关详细信息,请参阅 PostgreSQL 工具和安装指南psql 需要版本 14 或更高版本。
  • 必须安装库 libpq
  • 您可以使用与您的 Azure Databricks 身份相对应的 PostgreSQL 角色登录数据库实例。 请参阅 “管理 Postgres 角色”。
  • 你的 Postgres 角色已经被授予了访问数据库、架构或表所需的权限。
  • 可以对数据库实例进行身份验证。 如果必须为数据库实例获取 OAuth 令牌,请参阅 “对数据库实例进行身份验证”。

标识和数据库角色注意事项

  • 实例的默认所有者是预配数据库实例的 Azure Databricks 用户或服务主体。
  • 预配期间,会自动为标识创建相应的 Postgres 角色名称:
    • Databricks 用户:PostgreSQL 角色名称是用户的电子邮件地址。
    • Databricks 服务主体:Postgres 角色名称是服务主体的应用程序 ID。

使用 psql 进行连接

数据库实例的状态显示 “可用”后,使用 psql 命令行工具连接到它。 从数据库实例配置页复制连接命令。

  1. 在工作区边栏中单击 “计算 ”。
  2. 单击 OLTP 数据库
  3. 选择要从 psql中访问的数据库实例。
  4. 单击 “连接详细信息”。
  5. 复制 Connect with PSQL 字符串。
  6. 将命令粘贴到终端,并运行它以使用 psql 连接到数据库实例。