8강: n8n 데이터베이스 설정: PostgreSQL 사용하기

n8n 데이터베이스 설정: PostgreSQL 사용하기

n8n을 셀프호스팅할 때, 데이터베이스 설정은 중요한 부분입니다. n8n은 기본적으로 SQLite를 사용하지만, 보다 효율적인 성능을 위해 PostgreSQL과 같은 강력한 관계형 데이터베이스를 사용하는 것이 좋습니다. 이번 강에서는 PostgreSQL을 사용하여 n8n의 데이터베이스 설정을 하는 방법에 대해 자세히 알아보겠습니다.

PostgreSQL이란?

PostgreSQL은 오픈 소스 관계형 데이터베이스 관리 시스템(RDBMS)으로, ACID(원자성, 일관성, 고립성, 지속성) 속성을 지원하며, 복잡한 쿼리와 데이터 처리에 뛰어난 성능을 발휘합니다. n8n을 PostgreSQL과 연동하면 데이터 저장 및 조회 성능을 향상시킬 수 있습니다. 특히, 대규모 워크플로우 자동화 시스템에서 안정적인 성능을 제공합니다.

PostgreSQL 설치 및 설정

PostgreSQL을 설치하는 방법은 사용하는 운영체제에 따라 달라질 수 있습니다. 여기서는 Ubuntu 시스템을 기준으로 PostgreSQL을 설치하고 설정하는 방법을 설명합니다.

1. PostgreSQL 설치하기

먼저, Ubuntu 시스템에 PostgreSQL을 설치합니다. 터미널에서 아래 명령어를 실행합니다:

sudo apt update
sudo apt install postgresql postgresql-contrib

설치가 완료되면 PostgreSQL 서비스를 시작합니다:

sudo systemctl start postgresql
sudo systemctl enable postgresql

PostgreSQL 설치 후, 기본적으로 postgres라는 사용자 계정이 생성됩니다. 이 계정을 사용하여 데이터베이스를 설정할 수 있습니다.

2. PostgreSQL 데이터베이스 사용자 및 데이터베이스 생성

n8n을 PostgreSQL과 연동하려면, n8n이 접근할 수 있는 데이터베이스와 사용자가 필요합니다. 아래 명령어로 새로운 데이터베이스와 사용자를 생성합니다:

sudo -u postgres psql
CREATE USER n8n_user WITH PASSWORD 'your_password';
CREATE DATABASE n8n_db OWNER n8n_user;
GRANT ALL PRIVILEGES ON DATABASE n8n_db TO n8n_user;
\q

이 명령어는 n8n_user라는 사용자를 생성하고, n8n_db라는 데이터베이스를 만들며, 해당 사용자에게 모든 권한을 부여합니다.

n8n에서 PostgreSQL 데이터베이스 설정하기

PostgreSQL을 준비한 후, n8n의 환경 변수 설정을 통해 PostgreSQL과 연결할 수 있습니다. n8n을 실행할 때 필요한 환경 변수들을 설정해야 합니다.

1. PostgreSQL 환경 변수 설정

n8n에서 PostgreSQL을 사용하기 위해서는 다음과 같은 환경 변수들을 설정해야 합니다. 이를 통해 n8n이 PostgreSQL 데이터베이스에 연결할 수 있습니다:

환경 변수 설정 예시:

export DB_TYPE=postgresdb
export DB_POSTGRESDB_HOST=localhost
export DB_POSTGRESDB_PORT=5432
export DB_POSTGRESDB_USER=n8n_user
export DB_POSTGRESDB_PASSWORD=your_password
export DB_POSTGRESDB_DATABASE=n8n_db

위 환경 변수들은 PostgreSQL 서버에 연결하는 데 필요한 정보를 제공합니다. 데이터베이스 연결 정보를 환경 변수로 설정한 후, n8n을 실행하면 해당 데이터베이스와 연결이 이루어집니다.

2. n8n 실행 시 PostgreSQL 연결

환경 변수를 설정한 후, n8n을 실행하면 PostgreSQL 데이터베이스와 연결됩니다. Docker 환경에서 실행할 경우, 아래와 같은 명령어로 설정할 수 있습니다:

docker run -d --name n8n -p 5678:5678 \
  -e DB_TYPE=postgresdb \
  -e DB_POSTGRESDB_HOST=localhost \
  -e DB_POSTGRESDB_PORT=5432 \
  -e DB_POSTGRESDB_USER=n8n_user \
  -e DB_POSTGRESDB_PASSWORD=your_password \
  -e DB_POSTGRESDB_DATABASE=n8n_db \
  n8nio/n8n

이 명령어는 Docker를 사용하여 n8n을 실행하며, PostgreSQL과 연결됩니다. 환경 변수로 PostgreSQL 데이터베이스 정보를 전달하면 n8n은 해당 데이터베이스를 사용하여 데이터를 저장하고 조회합니다.

PostgreSQL 성능 최적화

PostgreSQL을 사용하여 n8n의 성능을 최적화하려면 몇 가지 추가적인 설정을 고려할 수 있습니다. 대규모 워크플로우가 실행될 때 성능 문제가 발생하지 않도록 설정을 최적화하는 것이 중요합니다.

1. PostgreSQL 쿼리 최적화

PostgreSQL에서 n8n의 성능을 최적화하려면 쿼리 성능을 향상시킬 수 있는 몇 가지 방법이 있습니다. 예를 들어, 데이터베이스의 인덱스를 추가하여 검색 성능을 개선할 수 있습니다. 쿼리가 많이 실행되는 테이블에 인덱스를 추가하면 데이터 조회 성능이 향상됩니다.

2. PostgreSQL 백업 및 복원

n8n의 데이터베이스는 중요한 정보이므로, 정기적으로 백업을 수행하는 것이 좋습니다. PostgreSQL에서는 pg_dump 명령어를 사용하여 데이터베이스를 백업할 수 있습니다. 다음 명령어를 사용하여 n8n 데이터베이스를 백업할 수 있습니다:

pg_dump -U n8n_user -h localhost n8n_db > n8n_backup.sql

백업 파일은 나중에 복원할 수 있으며, 복원 시에는 psql 명령어를 사용할 수 있습니다:

psql -U n8n_user -h localhost n8n_db < n8n_backup.sql

결론

이번 강에서는 n8n을 PostgreSQL과 연동하는 방법을 설명했습니다. PostgreSQL은 n8n에서 제공하는 기본 SQLite 데이터베이스보다 더 높은 성능과 안정성을 제공합니다. PostgreSQL을 설정하고 환경 변수를 올바르게 구성하면, n8n의 데이터 처리 성능을 극대화할 수 있습니다. 또한, PostgreSQL의 성능 최적화 및 백업 기능을 활용하여 안정적이고 효율적인 워크플로우 자동화 환경을 구축할 수 있습니다. 이제 여러분은 PostgreSQL을 사용하여 n8n을 셀프호스팅하는 데 필요한 모든 설정을 마쳤습니다.

bloghi 님의 블로그