sibedge/postgres-plv8-bigint

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

镜像概述与主要用途

轻量级Debian/Alpine-based Docker镜像，用于在PostgreSQL上运行PLV8扩展，包含最新的17.5和16.10版本。支持在Windows、Linux和Mac（包括Apple silicon M1/M2/M3）运行。Alpine版本基于http://registry.hub.docker.com/_/postgres/%E5%A2%9E%E5%BC%BA%E6%94%B9%E7%BC%96%EF%BC%8CDebian%E7%89%88%E6%9C%AC%E5%9F%BA%E4%BA%8Ehttps://hub.docker.com/r/bitnami/postgresql%E6%89%A9%E5%B1%95%E3%80%82%E4%B8%8E%E9%BB%98%E8%AE%A4PLV8%E6%9E%84%E5%BB%BA%E4%B8%8D%E5%90%8C%EF%BC%8C%E6%AD%A4%E4%BF%AE%E6%94%B9%E7%89%88%E6%94%AF%E6%8C%81BigInt%E6%95%B0%E5%AD%97%E5%BA%8F%E5%88%97%E5%8C%96%EF%BC%8C%E5%85%8D%E8%B4%B9%E4%BD%BF%E7%94%A8%EF%BC%8C%E5%B9%B6%E6%8F%90%E4%BE%9BPostgreSQL 17和16的定期更新支持。

支持的标签及对应Dockerfile链接

amd64、arm64架构支持：

• https://github.com/sibedge-llc/plv8-dockerfiles/blob/master/alpine/Dockerfile
• https://github.com/sibedge-llc/plv8-dockerfiles/blob/master/bookworm/Dockerfile
• https://github.com/sibedge-llc/plv8-dockerfiles/blob/pg-16/alpine/Dockerfile
• https://github.com/sibedge-llc/plv8-dockerfiles/blob/pg-16/bookworm/Dockerfile
• https://github.com/sibedge-llc/plv8-dockerfiles/blob/pg-15/alpine/Dockerfile
• https://github.com/sibedge-llc/plv8-dockerfiles/blob/pg-15/bookworm/Dockerfile
• https://github.com/sibedge-llc/plv8-dockerfiles/blob/pg-14/alpine/Dockerfile

仅amd64架构支持：

• https://github.com/sibedge-llc/plv8-dockerfiles/blob/pg-14/bullseye-minideb/Dockerfile
• https://github.com/sibedge-llc/plv8-dockerfiles/blob/pg-13/alpine/Dockerfile
• https://github.com/sibedge-llc/plv8-dockerfiles/blob/pg-13/bullseye-alternative/Dockerfile

使用方法

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

初始化扩展

需先执行创建扩展脚本：

sql
CREATE EXTENSION plv8;

验证安装

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

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

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

镜像变体说明

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

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

• 镜像地址：https://hub.docker.com/r/sibedge/postgres-plv8
• 特性：PLV8 v3.0.0及更高版本中，https://github.com/plv8/plv8/issues/485

2. BigInt修改版（推荐）

• 镜像地址：https://hub.docker.com/r/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}（保留数字类型）

联系我们

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