# 禁用 CentOS 内置的 PostgreSQL 模块（避免版本冲突）
sudo dnf module disable postgresql -y
​
# 卸载旧版 PostgreSQL（如有）
sudo dnf remove -y postgresql-server postgresql

# 安装 PostgreSQL 16 官方仓库 RPM
sudo dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm

# 安装 PostgreSQL 16 服务端和客户端
sudo dnf install -y postgresql16-server postgresql16 postgresql16-contrib

# 初始化数据目录（默认 /var/lib/pgsql/16/data/）
sudo /usr/pgsql-16/bin/postgresql-16-setup initdb

# 启动 PostgreSQL 服务
sudo systemctl start postgresql-16
​
# 设置开机自动启动
sudo systemctl enable postgresql-16
​
# 验证运行状态
sudo systemctl status postgresql-16

# 切换到 postgres 系统用户
sudo -i -u postgres
​
# 进入 psql 交互终端
psql
​
# 设置密码
postgres=# ALTER USER postgres PASSWORD 'YourStrongP@ssw0rd!';
​
# 退出
postgres=# \q
exit

# 查看 PostgreSQL 版本
psql -V
# 输出：psql (PostgreSQL) 16.x
​
# 以 postgres 用户连接并查看版本
sudo -u postgres psql -c "SELECT version();"
​
# 列出数据库
sudo -u postgres psql -c "\l"

sudo vim /var/lib/pgsql/16/data/postgresql.conf

# 监听所有网络接口（默认 localhost）
listen_addresses = '*'

# 端口（默认 5432）
port = 5432

sudo vim /var/lib/pgsql/16/data/pg_hba.conf

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# 允许所有用户从任意 IP 使用密码认证连接（生产环境应限制 IP 范围）
host    all             all             0.0.0.0/0               scram-sha-256

# 允许特定子网（推荐生产环境）
# host    all             all             10.0.0.0/8              scram-sha-256
# host    all             all             192.168.1.0/24          scram-sha-256

# 重启 PostgreSQL 使配置生效
sudo systemctl restart postgresql-16
​
# 放行 PostgreSQL 默认端口 5432
sudo firewall-cmd --permanent --add-port=5432/tcp
sudo firewall-cmd --reload
​
# 验证远程连接
psql -h <服务器IP> -U postgres -d postgres

# 如果修改了默认端口，需要更新 SELinux 策略
sudo semanage port -a -t postgresql_port_t -p tcp 5433
​
# 如果修改了数据目录，更新 SELinux 上下文
sudo semanage fcontext -a -t postgresql_db_t "/data/pgdata(/.*)?" 
sudo restorecon -Rv /data/pgdata

# 直接从 PGDG 仓库安装 pgvector
sudo dnf install -y pgvector_16

# 安装编译依赖
sudo dnf install -y postgresql16-devel gcc make git
​
# 克隆 pgvector 源码
cd /tmp
git clone --branch v0.8.0 https://github.com/pgvector/pgvector.git
cd pgvector
​
# 编译安装（需要 pg_config 在 PATH 中）
export PATH="/usr/pgsql-16/bin:$PATH"
make
sudo make install

# 连接到目标数据库
sudo -u postgres psql -d your_database
​
# 创建 pgvector 扩展
your_database=# CREATE EXTENSION IF NOT EXISTS vector;
​
# 同时创建 Spring AI 需要的其他扩展
your_database=# CREATE EXTENSION IF NOT EXISTS hstore;
your_database=# CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
​
# 验证扩展已安装
your_database=# \dx

-- 创建测试表
CREATE TABLE items (
  id BIGSERIAL PRIMARY KEY,
  content TEXT,
  embedding vector(1536)  -- OpenAI text-embedding-ada-002 维度
);
​
-- 插入测试数据
INSERT INTO items (content, embedding) VALUES 
  ('Hello world', '[0.1, 0.2, 0.3, ' || repeat('0.0, ', 1531) || '0.4, 0.5]');
​
-- 查看表结构
\d items
​
-- 清理测试数据
DROP TABLE items;

# 更新 Homebrew
brew update
​
# 安装 PostgreSQL 16
brew install postgresql@16

# 添加到 ~/.zshrc（macOS 默认 zsh）
echo 'export PATH="/opt/homebrew/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
​
# 验证
psql --version

# 使用 brew services 管理（推荐，支持开机自启）
brew services start postgresql@16
​
# 或手动启动
pg_ctl -D /opt/homebrew/var/postgresql@16 start

# 验证服务运行
brew services list | grep postgresql
​
# 连接数据库（默认以当前 macOS 用户名连接）
psql postgres
​
# 创建 postgres 超级用户（如未自动创建）
creatuser -s postgres
​
# 设置密码
psql -c "ALTER USER postgres PASSWORD 'YourP@ssw0rd!';"

# 查看服务状态
brew services list | grep postgresql
​
# 停止服务
brew services stop postgresql@16
​
# 重启服务
brew services restart postgresql@16
​
# 查看日志
tail -f /opt/homebrew/var/log/postgresql@16.log

# 直接通过 Homebrew 安装 pgvector
brew install pgvector
​
# 连接数据库并启用扩展
psql postgres -c "CREATE EXTENSION IF NOT EXISTS vector;"
psql postgres -c "CREATE EXTENSION IF NOT EXISTS hstore;"
psql postgres -c 'CREATE EXTENSION IF NOT EXISTS "uuid-ossp";'
​
# 验证
psql postgres -c "\dx"

export PATH="/Library/PostgreSQL/16/bin:$PATH"

echo 'export PATH="/Applications/Postgres.app/Contents/Versions/latest/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 添加到 PATH（如未自动添加）
$env:PATH += ";C:\Program Files\PostgreSQL\16\bin"
​
# 验证版本
psql --version
​
# 连接数据库
psql -U postgres -d postgres
​
# 查看版本
postgres=# SELECT version();

# 查看 PostgreSQL 服务状态
Get-Service postgresql*
​
# 停止/启动
Stop-Service postgresql-x64-16
Start-Service postgresql-x64-16
​
# 或使用 pg_ctl
pg_ctl status -D "C:\Program Files\PostgreSQL\16\data"
pg_ctl restart -D "C:\Program Files\PostgreSQL\16\data"

# 初始化数据目录
cd D:\pgsql16\bin
.\initdb -D D:\pgsql16\data -U postgres -W -E UTF8 --locale=C
​
# 启动服务（前台模式测试）
.\pg_ctl start -D D:\pgsql16\data
​
# 注册为 Windows 服务
.\pg_ctl register -N PostgreSQL16 -D D:\pgsql16\data
net start PostgreSQL16

# 下载 pgvector Windows 预编译包
# 从 https://github.com/pgvector/pgvector/releases 下载对应版本的 Windows zip
​
# 解压后，将文件复制到 PostgreSQL 安装目录
copy vector.dll "C:\Program Files\PostgreSQL\16\lib\"
copy vector.control "C:\Program Files\PostgreSQL\16\share\extension\"
copy vector--*.sql "C:\Program Files\PostgreSQL\16\share\extension\"

# 前置条件：安装 Visual Studio Build Tools（含 C++ 工具集）
​
# 打开 "x64 Native Tools Command Prompt for VS 2022"
cd C:\path\to\pgvector
set "PGROOT=C:\Program Files\PostgreSQL\16"
nmake /F Makefile.win
nmake /F Makefile.win install

-- 连接数据库后启用扩展
CREATE EXTENSION IF NOT EXISTS vector;
CREATE EXTENSION IF NOT EXISTS hstore;
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
​
-- 验证
\dx

# ============================================================
# PostgreSQL 16 — 生产环境推荐配置
# 基准：4 核 CPU / 8 GB RAM / SSD 存储
# ============================================================

# === 连接设置 ===
listen_addresses = '*'
port = 5432
max_connections = 200
superuser_reserved_connections = 3

# === 内存设置（核心调优）===
shared_buffers = 2GB                  # 物理内存的 25%
effective_cache_size = 6GB            # 物理内存的 75%（OS缓存估算）
work_mem = 16MB                       # 每个排序/哈希操作的内存
maintenance_work_mem = 512MB          # VACUUM/CREATE INDEX 使用的内存
wal_buffers = 64MB                    # WAL 写缓冲区

# === WAL 设置 ===
wal_level = replica                   # 支持流复制和归档
max_wal_size = 2GB
min_wal_size = 512MB
checkpoint_completion_target = 0.9
wal_compression = zstd                # PostgreSQL 16 新增 zstd 压缩

# === 查询优化 ===
random_page_cost = 1.1                # SSD 存储调低（默认 4.0 适用于 HDD）
effective_io_concurrency = 200        # SSD 并发 I/O
default_statistics_target = 200       # 统计信息采样精度

# === 并行查询 ===
max_worker_processes = 4
max_parallel_workers_per_gather = 2
max_parallel_workers = 4
max_parallel_maintenance_workers = 2

# === 日志设置 ===
logging_collector = on
log_directory = 'log'
log_filename = 'postgresql-%Y-%m-%d.log'
log_rotation_age = 1d
log_rotation_size = 100MB
log_min_duration_statement = 1000     # 记录超过 1 秒的慢查询
log_checkpoints = on
log_connections = on
log_disconnections = on
log_lock_waits = on
log_line_prefix = '%t [%p] %u@%d '
log_statement = 'ddl'                 # 记录所有 DDL 语句

# === 字符集 ===
lc_messages = 'en_US.UTF-8'
lc_monetary = 'en_US.UTF-8'
lc_numeric = 'en_US.UTF-8'
lc_time = 'en_US.UTF-8'

# === 安全设置 ===
password_encryption = scram-sha-256
ssl = off                              # 生产环境建议 on + 配置证书

# === 自动清理（Autovacuum）===
autovacuum = on
autovacuum_max_workers = 3
autovacuum_naptime = 30s
autovacuum_vacuum_threshold = 50
autovacuum_vacuum_scale_factor = 0.1
autovacuum_analyze_threshold = 50
autovacuum_analyze_scale_factor = 0.05

# === pgvector 优化 ===
# 增大 maintenance_work_mem 以加速 HNSW/IVFFlat 索引创建
maintenance_work_mem = 1GB

# 增大 work_mem 以优化向量搜索查询
work_mem = 64MB

# 并行索引创建（PostgreSQL 16 支持）
max_parallel_maintenance_workers = 4

# Linux
sudo vim /var/lib/pgsql/16/data/postgresql.conf
sudo systemctl restart postgresql-16
​
# 验证关键参数
sudo -u postgres psql -c "SHOW shared_buffers;"
sudo -u postgres psql -c "SHOW effective_cache_size;"
sudo -u postgres psql -c "SHOW max_connections;"

CREATE EXTENSION IF NOT EXISTS vector;
CREATE EXTENSION IF NOT EXISTS hstore;
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";

-- 创建 Spring AI 专用数据库
CREATE DATABASE springai_vectordb
  ENCODING 'UTF8'
  LC_COLLATE 'en_US.UTF-8'
  LC_CTYPE 'en_US.UTF-8';
​
-- 创建专用用户
CREATE USER springai_user WITH PASSWORD 'StrongP@ssw0rd!';
​
-- 授权
GRANT ALL PRIVILEGES ON DATABASE springai_vectordb TO springai_user;
​
-- 连接到新数据库并启用扩展（需超级用户）
\c springai_vectordb
CREATE EXTENSION IF NOT EXISTS vector;
CREATE EXTENSION IF NOT EXISTS hstore;
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
​
-- 授予 schema 权限
GRANT ALL ON SCHEMA public TO springai_user;

spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/springai_vectordb
    username: springai_user
    password: StrongP@ssw0rd!
    driver-class-name: org.postgresql.Driver
  ai:
    vectorstore:
      pgvector:
        index-type: hnsw              # HNSW 索引，适合高召回率场景
        distance-type: cosine_distance # 余弦距离（最常用）
        dimensions: 1536              # 匹配 Embedding 模型维度
        initialize-schema: true       # 自动创建 vector_store 表
        remove-existing-vector-store-table: false
        schema-name: public
        table-name: vector_store
        schema-validation: true

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-pgvector-store-spring-boot-starter</artifactId>
</dependency>
<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <scope>runtime</scope>
</dependency>

# 拉取 pgvector 官方镜像（已内置 pgvector 扩展）
docker pull pgvector/pgvector:pg16
​
# 运行容器
docker run -d \
  --name pgvector-db \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_PASSWORD=YourP@ssw0rd! \
  -e POSTGRES_DB=springai_vectordb \
  -p 5432:5432 \
  -v pgvector-data:/var/lib/postgresql/data \
  pgvector/pgvector:pg16
​
# 连接并启用扩展
docker exec -it pgvector-db psql -U postgres -d springai_vectordb -c "
CREATE EXTENSION IF NOT EXISTS vector;
CREATE EXTENSION IF NOT EXISTS hstore;
CREATE EXTENSION IF NOT EXISTS \"uuid-ossp\";
"
​
# 验证
docker exec -it pgvector-db psql -U postgres -d springai_vectordb -c "\dx"

version: '3.8'
services:
  pgvector:
    image: pgvector/pgvector:pg16
    container_name: pgvector-db
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: YourP@ssw0rd!
      POSTGRES_DB: springai_vectordb
    ports:
      - "5432:5432"
    volumes:
      - pgvector-data:/var/lib/postgresql/data
      - ./init.sql:/docker-entrypoint-initdb.d/init.sql
    restart: unless-stopped
    shm_size: '256mb'
    command: >
      postgres
      -c shared_buffers=512MB
      -c effective_cache_size=1536MB
      -c work_mem=32MB
      -c maintenance_work_mem=256MB
      -c random_page_cost=1.1
      -c max_connections=100
​
volumes:
  pgvector-data:

CREATE EXTENSION IF NOT EXISTS vector;
CREATE EXTENSION IF NOT EXISTS hstore;
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";

# 编辑 pg_hba.conf
sudo vim /var/lib/pgsql/16/data/pg_hba.conf
​
# 将 local 行的 METHOD 从 peer 改为 scram-sha-256
# local   all   all                           scram-sha-256
​
# 重新加载配置
sudo systemctl reload postgresql-16

# 1. 确认 PostgreSQL 正在运行
sudo systemctl status postgresql-16
​
# 2. 确认监听地址和端口
sudo -u postgres psql -c "SHOW listen_addresses;"
sudo -u postgres psql -c "SHOW port;"
​
# 3. 检查防火墙
sudo firewall-cmd --list-ports
​
# 4. 检查 pg_hba.conf 是否允许目标 IP
grep -v '^#' /var/lib/pgsql/16/data/pg_hba.conf | grep -v '^$'

# 确认 pgvector 包已安装
rpm -qa | grep pgvector
​
# 如果未安装
sudo dnf install -y pgvector_16
​
# 源码编译时确认 pg_config 指向正确版本
/usr/pgsql-16/bin/pg_config --sharedir
# 应输出：/usr/pgsql-16/share

# 查看当前内核共享内存限制
sysctl kernel.shmmax
sysctl kernel.shmall
​
# 临时调整（立即生效）
sudo sysctl -w kernel.shmmax=8589934592   # 8GB
sudo sysctl -w kernel.shmall=2097152       # 8GB / 4096
​
# 永久调整
echo 'kernel.shmmax = 8589934592' | sudo tee -a /etc/sysctl.conf
echo 'kernel.shmall = 2097152' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

-- 查看数据库编码
SELECT datname, encoding, datcollate, datctype 
FROM pg_database;
​
-- 创建新数据库时指定编码
CREATE DATABASE mydb 
  ENCODING 'UTF8' 
  LC_COLLATE 'en_US.UTF-8' 
  LC_CTYPE 'en_US.UTF-8';

-- 增大维护内存
SET maintenance_work_mem = '2GB';
​
-- 增大并行工作进程（PostgreSQL 16）
SET max_parallel_maintenance_workers = 4;
​
-- 创建索引（使用 HNSW）
CREATE INDEX ON vector_store 
  USING hnsw (embedding vector_cosine_ops)
  WITH (m = 16, ef_construction = 200);

# 添加到 PATH
echo 'export PATH="/opt/homebrew/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
​
# 验证
which psql
psql --version

# 查看事件日志
Get-EventLog -LogName Application -Source postgresql* -Newest 20
​
# 查看 PostgreSQL 日志
Get-Content "C:\Program Files\PostgreSQL\16\data\log\postgresql-*.log" -Tail 50
​
# 常见原因：
# 1. 端口被占用 → 修改 postgresql.conf 中的 port
# 2. 数据目录权限 → 确保 "Network Service" 用户有读写权限
# 3. 配置语法错误 → 检查 postgresql.conf

# 停止服务
sudo systemctl stop postgresql-16
sudo systemctl disable postgresql-16
​
# 卸载所有 PostgreSQL 包
sudo dnf remove -y postgresql16-server postgresql16 postgresql16-contrib pgvector_16
​
# 删除数据、日志和配置
sudo rm -rf /var/lib/pgsql
sudo rm -f /etc/yum.repos.d/pgdg-redhat-all.repo
​
# 删除 postgres 用户和组（可选）
sudo userdel -r postgres

brew services stop postgresql@16
brew uninstall postgresql@16
brew uninstall pgvector
rm -rf /opt/homebrew/var/postgresql@16