pgvector 설치하기

pgvector는 PostgreSQL 확장이라서 서버에 소스로 컴파일해 설치하거나, Docker나 패키지 매니저로 간단히 올릴 수 있어요. Postgres 13 이상을 지원하고, 버전별 설치 명령만 알면 어렵지 않아요.

출처: https://github.com/pgvector/pgvector#installation

Linux / Mac에서 소스 설치

컴파일 후 설치하는 가장 기본적인 방법이에요. Postgres 13+를 지원해요.

cd /tmp
git clone --branch v0.8.6 https://github.com/pgvector/pgvector.git
cd pgvector
make
make install # may need sudo

설치 중 문제가 생기면 설치 노트를 확인하면 돼요. 그리고 소스 설치 대신 Docker, Homebrew, PGXN, APT, Yum, pkg, APK, conda-forge로도 설치할 수 있고, Postgres.app이나 많은 호스팅 Postgres에는 이미 들어 있어요. GitHub Actions에서 쓰려면 전용 세팅도 제공돼요.

Windows에서 빌드

Windows에서는 Visual Studio의 C++ 지원을 설치한 뒤, x64 Native Tools Command Prompt for VS [version]을 관리자로 실행하고 nmake로 빌드해요.

set "PGROOT=C:\Program Files\PostgreSQL\18"
cd %TEMP%
git clone --branch v0.8.6 https://github.com/pgvector/pgvector.git
cd pgvector
nmake /F Makefile.win
nmake /F Makefile.win install

Windows도 Docker나 conda-forge로 설치하는 방법이 있어요. 모든 설치 경로에서 사용하는 Postgres 서버 버전과 명령의 버전 숫자를 맞추는 걸 잊지 마세요.

Docker 이미지로 실행

pgvector가 포함된 Docker 이미지를 받아서 바로 쓸 수 있어요. 18 자리에 자신의 Postgres 버전을 넣으면 돼요.

docker pull pgvector/pgvector:pg18-trixie

이미지는 공식 Postgres 이미지에 pgvector를 얹은 형태라서, 평소 Postgres 컨테이너를 다루듯 똑같이 실행하면 돼요.

업그레이드하기

최신 버전을 같은 방법으로 설치한 뒤, 각 데이터베이스에서 확장을 갱신하면 끝이에요.

ALTER EXTENSION vector UPDATE;

현재 버전이 궁금할 때는 아래처럼 확인할 수 있어요.

SELECT extversion FROM pg_extension WHERE extname = 'vector';

pgvector 설치하기