Postgres 兼容性

本页介绍 Lakebase Postgres 如何与标准 Postgres 兼容。 作为托管 Postgres 服务,存在一些差异和限制。

Postgres 版本支持

Lakebase 支持 Postgres 16、Postgres 17、Postgres 18 和 Postgres 19。 Postgres 18 是默认版本。 若要使用不同版本,请在创建新项目时选择它。 部分功能在 Postgres 19 上不可用。 参见 Postgres 19的限制。 要将现有项目迁移到较新的主版本,请参阅 “主版本升级”。

Postgres 扩展支持

Lakebase 支持许多 Postgres 扩展。 有关完整列表,请参阅 Postgres 扩展。

会话、内存和存储

会话上下文

Lakebase 缩放为零功能在一段时间不活动后自动关闭空闲连接。

关闭连接后,会话上下文中的任何内容(如临时表、已准备的语句、公告锁和 NOTIFY 和 LISTEN 命令)都将丢失。

为了避免丢失会话级上下文,可以禁用缩放为零。 但是,这样做意味着计算运行 24/7。

内存

SQL 查询和索引生成可以生成可能不适合内存中的大量数据。 计算的大小决定了可用内存量。

无日志记录的表

未标记的表是不写入 Postgres 预写日志 (WAL) 的表。 这些表存储在计算本地存储中,在计算重启或计算缩放到零时不会持久保存。 这与标准 Postgres 不同,后者只有在进程异常终止的情况下才会截断未记录的表。 此外,未记录的表受限于计算机本地磁盘空间。 Lakebase 计算为 Postgres 使用的临时文件分配 20 GiB 的本地磁盘空间或计算规模的最大值乘以 15 GiB(以最高者为准)。

临时表

临时表仅在会话(或可选的事务)的生命周期内存在。 与未记录的表一样,它们存储在计算本地存储中,并受本地磁盘空间的限制。

Postgres 日志

不支持访问 Postgres 日志。

统计数据收集

Postgres 维护两种统计数据:

  • 规划统计:ANALYZE生成这些数据并存储在pg_statistic目录和 reltuples 的 pg_class和 relpages 列中。 查询规划器利用这些数据估算行数并选择执行计划。 规划器统计信息会随你的数据持久保存,并且在计算资源重启或缩减到零时会被保留。
  • 累积统计:Postgres 累积统计系统 收集这些数据,并通过诸如 pg_stat_user_tables之类的视图来展示。 它们包括插入、更新和删除行的计数器,autovacuum 用这些计数器决定何时执行 vacuum 或分析表。

当计算资源缩减为零或在未发生故障的情况下重启时,累积统计量得以保持。 如果计算资源意外停止(例如发生故障或高可用性故障转移后),或者统计信息数据超过 16 MB,它们就会被重置。 查询规划器不使用累计统计数据,因此重置不会影响查询计划。 重置后,Autovacuum处理表的时间可能会更长,因为修改计数器是从零开始的。 如有需要,你可以手动运行ANALYZE或VACUUM。

由 pg_stat_statements 扩展收集的查询统计数据单独存储,在计算资源缩减至零或重启时不会被保留。 更多信息请参见 数据持久性。

为了确保表具有准确的查询规划器统计信息,请参阅 Postgres 查询规划器统计信息。

Postgres 参数设置

作为托管 Postgres 服务,许多数据库参数都基于计算大小进行设置。 使用以下方法查看所有数据库参数设置:

SHOW ALL;

可以配置在会话、数据库或角色级别具有 user 上下文的参数。 不能在实例级别配置参数。

  • 显示可在会话、数据库或角色级别设置的参数。

    SELECT name
    FROM pg_settings
    WHERE context = 'user';
    
  • 设置会话的参数。

    SET maintenance_work_mem='1 GB';
    
  • 为连接到数据库的所有会话设置参数。

    ALTER DATABASE databricks_postgres SET maintenance_work_mem='1 GB';
    
  • 为给定用户的所有会话设置参数。

    ALTER USER "john@company.com" SET maintenance_work_mem='1 GB';
    

数据库编码与排序

数据库编码

默认情况下,使用 C.UTF-8 排序规则。 C.UTF-8 支持各种 UTF-8 编码字符。

还支持 UTF8 编码(Unicode、8 位可变宽度编码)。

若要查看数据库的编码和排序规则,请运行以下查询:

SELECT
    pg_database.datname AS database_name,
    pg_encoding_to_char(pg_database.encoding) AS encoding,
    pg_database.datcollate AS collation,
    pg_database.datctype AS ctype
FROM
    pg_database
WHERE
    pg_database.datname = 'your_database_name';

注释

在 Postgres 中,创建数据库后无法更改数据库的编码或排序规则。

整理

排序规则是一个 SQL 架构对象,它将 SQL 名称映射到操作系统中安装的库提供的区域设置。

默认情况下,Lakebase 使用 C.UTF-8 排序规则。 Lakebase 支持的另一个提供程序是 icu,它使用外部 ICU 库。

Lakebase 提供了一系列完整的预定义 icu 语言环境,以防需要特定于区域设置的排序或大小写转换。

  • 查看所有预定义的区域设置:
SELECT * FROM pg_collation;
  • 使用预定义 icu 的区域设置创建数据库:
CREATE DATABASE my_arabic_db
LOCALE_PROVIDER icu
icu_locale 'ar-x-icu'
template template0;
  • 为各个列指定区域设置:
CREATE TABLE my_ru_table (
    id serial PRIMARY KEY,
    russian_text_column text COLLATE "ru-x-icu",
    description text
);

功能限制

角色与权限

  • 无法访问主机操作系统。
  • 无法使用 Postgres superuser进行连接。
    • 不允许任何需要 superuser 特权或直接本地文件系统访问的功能。
    • 将 databricks_superuser 取代 Postgres superuser 角色。 有关与此角色关联的特权的信息,请参阅 “管理角色”。

复制

你可以通过原生的 Postgres 逻辑复制,将数据复制到 Lakebase 数据库或从中复制数据。 更多信息请参见 逻辑复制。

表空间

Lakebase 不支持 Postgres 表空间。 尝试使用命令创建表空间 CREATE TABLESPACE 会导致错误。 这是因为 Lakebase 的托管云体系结构不允许对自定义存储位置进行直接文件系统访问。

如果现有应用程序或脚本使用表空间在不同的存储设备中组织数据库对象,则必须在迁移到 Lakebase 时删除或修改这些引用。