sibedge/postgres-plv8-bigint Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Postgres | PLV8（BigInt序列化支持修改版）

镜像概述与主要用途

轻量级Debian/Alpine-based Docker镜像，用于在PostgreSQL上运行PLV8扩展，包含最新的17.5和16.10版本。支持在Windows、Linux和Mac（包括Apple silicon M1/M2/M3）运行。Alpine版本基于官方Postgres镜像增强改编，Debian版本基于Bitnami PostgreSQL包扩展。与默认PLV8构建不同，此修改版支持BigInt数字序列化，免费使用，并提供PostgreSQL 17和16的定期更新支持。

支持的标签及对应Dockerfile链接

amd64、arm64架构支持：

• 17.6-3.2.4, latest, 17.6-3.2.4-alpine, alpine
• 17.6-3.2.4-bookworm, bookworm
• 16.10-3.2.3, 16.10-3.2.3-alpine
• 16.10-3.2.3-bookworm
• 15.8-3.2.2, 15.8-3.2.2-alpine
• 15.8-3.2.2-bookworm
• 14.9-3.1.7, 14.9-3.1.7-alpine

仅amd64架构支持：

• 14.9-3.0.0-bullseye, bullseye
• 13.8-3.1.3, 13.8-3.1.3-alpine
• 13.8-3.0.0-bullseye

使用方法

此镜像的安装方式与标准Postgres镜像相同，唯一区别是已预装PLV8扩展。

初始化扩展

需先执行创建扩展脚本：

sql
CREATE EXTENSION plv8;

验证安装

执行以下SQL查询验证PLV8版本：

sql
DO $
  plv8.elog(NOTICE, plv8.version);
$ LANGUAGE plv8;

成功执行后将显示已安装的PLV8扩展版本。

镜像变体说明

由于PLV8默认存在BigInt序列化问题，提供两个镜像变体：

1. 默认构建（无BigInt支持）

• 镜像地址：sibedge/postgres-plv8
• 特性：PLV8 v3.0.0及更高版本中，BigInt数字默认转换为字符串

2. BigInt修改版（推荐）

• 镜像地址：sibedge/postgres-plv8-bigint
• 特性：添加BigInt序列化支持，保留数字类型

功能差异测试

基础查询测试

sql
DO $
  const sql = "SELECT COUNT(*) FROM generate_series(1, 100);";
  const data = plv8.execute(sql);
  plv8.elog(NOTICE, JSON.stringify(data[0]));
$ LANGUAGE plv8;

• 默认构建结果：ERROR: TypeError: Do not know how to serialize a BigInt
• BigInt修改版结果：NOTICE: {"count":100}

JSONB转换测试

sql
CREATE TABLE test (
  id SERIAL PRIMARY KEY NOT NULL,
  comment text
);

INSERT INTO test(comment) VALUES ('abc'), ('def');

CREATE OR REPLACE FUNCTION get_count(table_name text)
  RETURNS jsonb
  LANGUAGE plv8 IMMUTABLE AS
$
  const sql = `SELECT COUNT(*) AS cnt FROM "${table_name}"`;
  const data = plv8.execute(sql);
  return data[0];
$;

SELECT * FROM get_count('test');

• 默认构建结果：{"cnt": "2"}（数字转为字符串）
• BigInt修改版结果：{"cnt": 2}（保留数字类型）

联系我们

如有技术问题或功能咨询，请通过联系：