설치

AgensGraph는 Linux와 Windows에서 실행됩니다. AgensGraph를 설치하는 방법은 바이너리 패키지를 다운로드하는 방법과 소스 코드에서 패키지를 컴파일하는 방법의 두 가지가 있습니다.

Linux에 AgensGraph 설치하기

사전 빌드된 패키지 설치

사전 컴파일된 바이너리 받기:
AgensGraph 다운로드 페이지를 방문하여 해당 버전의 AgensGraph를 다운로드합니다.

팁: 시스템 환경을 모르는 경우 다음 명령을 사용할 수 있습니다:
uname -sm

패키지 압축 풀기:
다운로드한 파일을 사용할 디렉터리(예: Linux의 경우 /usr/local/AgensGraph/)에 압축 해제합니다.
```
tar xvf /path/to/your/use
```

참고 : 다른 운영 체제에서 AgensGraph를 사용하려면 SKAI Worldwide 지원팀에 문의하시기 바랍니다.

빌드 소스 코드 설치

AgensGraph를 설치하려면 그래프 작업을 위한 데이터베이스 클러스터를 올바르게 구성할 수 있도록 소스 코드를 받아 빌드해야 합니다. 이 가이드는 시스템에서 AgensGraph를 설치하고 실행하기 위한 단계별 절차를 제공합니다.

사전 요구 사항

각 OS에 따라 다음 필수 라이브러리를 설치합니다.

Rocky Linux

dnf install gcc glibc glib-common readline readline-devel zlib zlib-devel flex bison      

Fedora

dnf install gcc glibc bison flex readline readline-devel zlib zlib-devel      

Ubuntu

sudo apt-get install build-essential libreadline-dev zlib1g-dev flex bison      

소스 코드 다운로드

먼저 AgensGraph 소스 코드를 다운로드합니다. 최신 릴리스는 공식 GitHub 저장소에서 찾을 수 있습니다. AgensGraph github에 접속하여 소스 코드를 받습니다.
```
git clone https://github.com/skaiworldwide-oss/agensgraph.git
cd agensgraph
```

빌드 구성

클론한 위치로 이동하여 소스 트리에서 configure를 실행합니다. –prefix=/path/to/intall 옵션을 사용하면 AgensGraph가 설치될 위치를 지정할 수 있습니다.
```
./configure
```
빌드를 실행합니다.
```
make install   
```
익스텐션 모듈과 바이너리를 설치합니다.
```
make install-world  
```

설치 후 설정 및 구성

환경 변수 설정 (선택 사항):
이 명령들을 ~/.bash_profile과 같은 셸 시작 파일에 추가할 수 있습니다.

  export LD_LIBRARY_PATH=/usr/local/AgensGraph/lib:$LD_LIBRARY_PATH                    
  export PATH=/usr/local/AgensGraph/bin:$PATH                  
  export AGDATA=/path/to/make/db_cluster   

데이터베이스 클러스터 생성:
```
initdb [-D /path/to/make/db_cluster]
```

서버 시작:

ag_ctl start [-D /path/created/by/initdb/]

데이터베이스 생성:
```
createdb [dbname]
```
dbname을 지정하지 않으면 기본적으로 현재 사용자와 같은 이름의 데이터베이스가 생성됩니다.
대화형 터미널 실행:
```
agens [dbname]
```
-D 옵션으로 db_cluster 디렉터리를 지정하지 않으면 환경 변수 AGDATA가 사용됩니다.

Docker로 빠르게 시작하기

AgensGraph Docker 이미지 가져오기
```
docker pull skaiworldwide/agensgraph
```
참고: 기본적으로 이 명령은 latest 태그를 가져옵니다.

AgensGraph 컨테이너 생성 및 실행

docker run \
    --name agensgraph \
    -p 5455:5432 \
    -e POSTGRES_USER=postgres \
    -e POSTGRES_PASSWORD=agens \
    -e POSTGRES_DB=agens \
    -d \
    skaiworldwide/agensgraph

AgensGraph 클라이언트에 연결

docker exec -it agensgraph agens -d agens -U postgres

추가 정보

자세한 내용은 Docker Hub 페이지를 참고하시기 바랍니다.

서버 매개변수 구성

최적의 성능을 얻으려면 데이터 크기와 머신 리소스에 맞게 서버 매개변수를 올바르게 설정하는 것이 매우 중요합니다. 많은 서버 매개변수 중에서 다음 매개변수들은 AgensGraph 그래프 쿼리 성능에 매우 중요합니다. (이러한 매개변수를 설정하려면 $AGDATA/postgresql.conf 파일을 편집할 수 있습니다(재시작 필요).)

shared_buffers: 데이터 객체를 캐싱하기 위한 메모리 크기입니다. 이 매개변수는 운영 환경에서 늘려야 합니다. 데이터 크기만큼 크게 설정할 때 최적입니다. 다만 이 매개변수는 동시 세션과 각 쿼리에 할당되는 메모리 크기를 고려하여 신중하게 설정해야 합니다. 권장 설정값은 물리 메모리 크기의 절반입니다.
work_mem: 이 매개변수 역시 물리 메모리 크기와 실행될 쿼리의 특성에 따라 신중하게 늘려야 합니다.
random_page_cost: 이 매개변수는 쿼리 최적화를 위한 것입니다. 그래프 쿼리의 경우 이 값을 1 또는 0.005(그래프 데이터가 메모리에 완전히 캐싱된 경우)로 줄이는 것을 권장합니다.

자세한 내용은 PostgreSQL 문서를 참고하시기 바랍니다.