PGvector 설치하기

1️⃣환경 체크

먼저 PostgreSQL과 Python 버전을 확인합니다.

psql --version # psql (PostgreSQL) 16.10
python3 --version # Python 3.9.21
which pg_config # 없으면 postgresql-devel 설치 필요

 

2️⃣ EPEL 저장소 활성화 및 Perl 설치

pgvector 빌드 과정에서 perl-IPC-Run 모듈이 필요합니다. EPEL 저장소를 활성화하고 Perl 관련 패키지를 설치합니다.

sudo dnf install -y epel-release
sudo dnf update -y
sudo dnf install -y perl
sudo dnf install -y perl-IPC-Run
sudo cpan IPC::Run

3️⃣ 개발 도구 및 PostgreSQL 관련 패키지 설치

빌드 환경에 필요한 make, gcc, PostgreSQL 개발 패키지를 설치합니다.

 

# MobApt 또는 dnf를 활용

 

MobApt install make gcc-core gccmakedep
MobApt install postgresql postgresql-client postgresql-contrib postgresql-piperl postgresql-python

 

# PostgreSQL 모듈 확인

dnf module list postgresql

PostgreSQL 16 개발 패키지 설치:

sudo dnf install -y dnf-plugins-core sudo dnf makecache sudo dnf install -y postgresql16-devel

설치 중 pg_config가 없다는 에러가 발생하면 설치 경로를 확인 후 PATH에 추가합니다.

find /usr -name pg_config
export PATH=/usr/pgsql-16/bin:$PATH

4️⃣ pgvector 다운로드 및 빌드

GitHub에서 pgvector를 다운로드하고 /tmp 등 적절한 폴더로 이동 후 빌드합니다.

 

wget https://github.com/pgvector/pgvector.git

GitHub - pgvector/pgvector: Open-source vector similarity search for Postgres

mv pgvector /tmp/ 
cd /tmp/pgvector
make

빌드 후 설치 시 pg_config 경로를 찾지 못하면 환경 변수를 전달하여 설치합니다.

 

sudo env PATH=$PATH make install 

또는

sudo PG_CONFIG=/usr/pgsql-16/bin/pg_config make install

---

5️⃣ PostgreSQL 슈퍼유저로 접속

확장을 설치하려면 슈퍼유저 권한이 필요합니다.

 

sudo -i -u postgres psql

---

6️⃣ 테스트용 데이터베이스 생성

확장 설치 전, 테스트할 데이터베이스를 생성합니다.

 

CREATE DATABASE test_0922_01; \q

---

7️⃣ pgvector 확장 설치

데이터베이스에 접속 후 pgvector 확장을 설치합니다.

 

psql -d test_0922_01 CREATE EXTENSION IF NOT EXISTS vector;

설치 확인:

\dx vector

끝-