如何在Bitnami PostgreSQL Helm Chart中安装pgvector扩展

步骤1：配置Helm仓库 #

首先添加Bitnami官方Helm仓库并更新：

helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update

步骤2：创建自定义配置文件 #

新建values.yaml文件，配置pgvector扩展的自动初始化：

postgresql:
  # 通过初始化脚本自动创建pgvector扩展
  initdbScripts:
    create-pgvector-extension.sql: |
      CREATE EXTENSION IF NOT EXISTS vector;
  # 可选：指定默认启用扩展的数据库（若需针对特定库，可修改脚本）
  # auth:
  #   database: myappdb

# 若使用集群模式（主从复制），无需额外配置，初始化脚本会在主节点执行并同步到从节点

注：如果Bitnami PostgreSQL镜像已预装pgvector包，也可直接通过postgresql.extensions: [vector]配置启用，用初始化脚本的方式兼容性更强，避免镜像版本差异导致的问题。

步骤3：部署PostgreSQL集群 #

执行Helm安装命令，指定Chart版本和自定义配置：

helm install my-postgresql bitnami/postgresql --version 15.5.16 -f values.yaml

步骤4：验证扩展安装 #

1. 获取PostgreSQL管理员密码：

export POSTGRES_PASSWORD=$(kubectl get secret my-postgresql -o jsonpath="{.data.postgres-password}" | base64 -d)

2. 进入PostgreSQL容器并连接数据库：

kubectl exec -it my-postgresql-0 -- psql -U postgres

3. 检查扩展是否存在：

SELECT extname, extversion FROM pg_extension WHERE extname = 'vector';

若返回包含vector的结果行，说明扩展已成功安装并启用。

常见问题处理 #

• 如果执行CREATE EXTENSION时报错could not open extension control file，说明镜像未预装pgvector包，此时需要构建包含pgvector的自定义PostgreSQL镜像，替换Chart中的image.repository和image.tag配置。
• 主从集群中若从节点未同步扩展，可手动在从节点执行CREATE EXTENSION vector;（需确保主节点已创建，从节点处于只读状态时需先切换为主节点或使用同步机制）。

内容的提问来源于stack exchange，提问作者sashok_bg