通过

使用 pgAdmin 进行连接

重要

Lakebase 自动缩放在以下区域中处于 eastus2 版： ， westeurope。 westus

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

pgAdmin 是 PostgreSQL 的热门开源图形管理工具。 它提供了一个可视化界面，用于管理数据库、运行查询、查看数据和监视数据库性能。 可以使用 pgAdmin 连接到 Lakebase 数据库、执行管理任务并监视实时性能指标。

先决条件

  • 您的系统上已安装 pgAdmin 4
  • 配置了 Postgres 角色的 Lakebase 项目

注释

建议在与 pgAdmin 连接时使用 本机 Postgres 密码身份验证 。 本机 Postgres 密码不会像 OAuth 令牌一样每小时过期，因此更适合无法频繁刷新凭据的应用程序。 有关身份验证方法的详细信息，请参阅 身份验证概述 。

安装 pgAdmin

如果没有安装 pgAdmin，请从 pgAdmin 网站下载并安装它。

了解连接字符串

Lakebase 提供了一个连接字符串，其中包含连接所需的所有信息。 下面介绍如何分析它：

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

配置 pgAdmin 时，会将这些组件输入到单独的字段中。 有关连接字符串的更多详细信息，请参阅 连接字符串。

连接到数据库

  1. 从 Lakebase 获取连接详细信息：

    • 导航到 Lakebase 应用并选择项目
    • 单击 “连接 ”以打开数据库连接模式
    • 选择要连接到的分支、计算和数据库
    • 从下拉列表中选择 Postgres 角色（建议使用具有密码身份验证的本机 Postgres 角色）。 如果需要创建角色，请参阅 创建原生 Postgres 密码角色。
    • 记下连接详细信息

  2. 在 pgAdmin 中创建服务器连接：

    • Open pgAdmin
    • 在主页上的 “快速链接 ”中，选择“ 添加新服务器”。

    pgadmin add server

  3. 配置“常规”选项卡：

    • 名称：输入连接的描述性名称（例如“My Lakebase 项目”）

    pgAdmin 注册服务器

  4. 配置“连接”选项卡：

    • 主机名/地址：输入计算终结点主机名（例如 ep-abc-123.databricks.com）
    • 端口： 5432
    • 维护数据库：输入数据库名称（例如 databricks_postgres）
    • 用户名：输入 Postgres 角色名称（例如 role_name）
    • 密码：输入 Postgres 角色密码
    • 保存密码：选中此框以保存密码

    下面的示例使用名为pgadmin的 Postgres 角色。

    pgadmin 连接详细信息

  5. 在“参数”选项卡上配置 SSL：

    • SSL 模式：选择 Require

      pgadmin 参数选项卡 ssl

  6. 保存连接：

    • 单击“ 保存 ”以创建连接

Lakebase 数据库现在将显示在“服务器”下的左侧栏中。 可以展开它以查看数据库、架构、表和其他数据库对象。

pgadmin 服务器视图

使用 pgAdmin

连接后，可以：

  • 浏览数据库对象：在左侧栏中展开服务器以查看数据库、架构、表、视图、函数等
  • 运行查询：右键单击数据库并选择 “查询工具 ”以打开 SQL 编辑器
  • 查看数据：右键单击表，然后选择 “查看/编辑数据 ”以浏览表内容
  • 管理架构：使用图形界面创建、修改或删除数据库对象
  • 监视性能：查看统计信息、活动会话和查询性能

pgAdmin 中的基本操作

连接后，可以执行常见任务：

  • 运行 SQL 查询：打开数据库的查询工具，输入 SQL 命令并执行它们。
  • 管理表：展开数据库→架构→ 公共 →表。 可以创建新表或管理现有表。
  • 导入和导出数据：右键单击表，然后选择 “导入/导出 ”以从 CSV 加载数据或将表数据导出到文件。

使用 pgAdmin 进行监视

使用 pgAdmin，可以监视各种指标的实时活动，包括：

  • 活动会话：总计、活动会话和空闲会话
  • 每秒事务量：事务、提交、回滚
  • 元组操作：插入、更新、删除
  • 元组输出状态：已提取，已返回
  • Block I/O：用于共享缓冲区

注释

Lakebase Postgres 当前不支持system_stats扩展，因此无法使用 pgAdmin 中的系统统计信息选项卡。 另请注意，当 pgAdmin 处于活动状态时，它会轮询数据库收集统计信息，这将阻止计算资源在没有其他数据库活动时像通常那样进入挂起状态。

pgAdmin 监控功能

pgAdmin 提供其他监视功能：

  • 仪表板：实时服务器活动和性能指标
  • 统计信息：数据库和表统计信息，包括行计数和磁盘使用情况
  • 会话：活动连接和会话管理
  • 锁：当前数据库锁和阻止查询
  • 准备语句：查看和分析已准备的语句缓存
  • 查询工具：使用详细的执行计划和性能分析执行查询

连接安全性

Lakebase 要求所有连接都使用 SSL/TLS 加密。 确保 SSL 模式在服务器配置的“参数”选项卡上设置为 Require ”

有关连接字符串和身份验证选项的详细信息，请参阅 “连接到项目”。

  • Last updated on