Neon Postgres 소스 설정 가이드

Neon Postgres 인스턴스를 ClickPipes 소스로 설정합니다

ClickPipes에서 복제에 사용할 Neon Postgres를 설정하는 방법을 안내하는 가이드입니다. 이 설정을 진행하기 전에 Neon console에 로그인되어 있는지 확인하세요.

​

권한이 있는 사용자 생성

관리자 사용자로 Neon 인스턴스에 연결한 다음, 아래 명령을 실행합니다:

1. ClickPipes 전용 사용자를 생성합니다:

   CREATE USER clickpipes_user PASSWORD 'some-password';
   

2. 앞 단계에서 생성한 사용자에게 스키마(schema) 수준의 읽기 전용 권한을 부여합니다. 아래 예시는 public 스키마에 대한 권한을 보여줍니다. 복제하려는 테이블이 들어 있는 각 스키마마다 이 명령을 반복하십시오:

   GRANT USAGE ON SCHEMA "public" TO clickpipes_user;
   GRANT SELECT ON ALL TABLES IN SCHEMA "public" TO clickpipes_user;
   ALTER DEFAULT PRIVILEGES IN SCHEMA "public" GRANT SELECT ON TABLES TO clickpipes_user;
   

3. 사용자에게 복제 권한을 부여합니다:

   ALTER USER clickpipes_user WITH REPLICATION;
   

4. 복제하려는 테이블을 포함하는 publication을 생성합니다. 성능 오버헤드를 줄이기 위해 publication에는 필요한 테이블만 포함할 것을 강력히 권장합니다.

publication에 포함되는 모든 테이블은 기본 키(primary key) 가 정의되어 있거나, replica identity 가 FULL로 설정되어 있어야 합니다. 범위 지정 방법은 Postgres FAQ를 참조하십시오.

• 특정 테이블에 대한 publication을 생성하려면:

  CREATE PUBLICATION clickpipes FOR TABLE table_to_replicate, table_to_replicate2;
  

  • 특정 스키마의 모든 테이블에 대한 publication을 생성하려면:

    CREATE PUBLICATION clickpipes FOR TABLES IN SCHEMA "public";
    

clickpipes publication에는 지정된 테이블에서 생성된 변경 이벤트 집합이 포함되며, 이후 복제 스트림을 수집하는 데 사용됩니다.

​

논리적 복제 활성화

Neon에서는 UI를 통해 논리적 복제를 활성화할 수 있습니다. ClickPipes의 CDC가 데이터를 복제하려면 이 설정이 필요합니다. 설정 탭으로 이동한 다음 논리적 복제 섹션으로 이동하십시오.

여기에서 활성화를 클릭하면 설정이 완료됩니다. 활성화한 후에는 아래와 같은 성공 메시지가 표시됩니다.

Neon Postgres 인스턴스에서 아래 설정을 확인하겠습니다:

SHOW wal_level; -- logical이어야 합니다
SHOW max_wal_senders; -- 10이어야 합니다
SHOW max_replication_slots; -- 10이어야 합니다

​

IP 화이트리스트 등록(Neon Enterprise 플랜용)

Neon Enterprise 플랜을 사용하는 경우 ClickPipes IPs를 허용 목록에 추가하면 ClickPipes에서 Neon Postgres 인스턴스로의 복제를 허용할 수 있습니다. 이 작업을 수행하려면 설정 탭을 클릭한 다음 IP 허용 섹션으로 이동하세요.

​

연결 정보 복사

이제 사용자와 publication이 준비되고 복제가 활성화되었으므로 새 ClickPipe를 만들기 위한 연결 정보를 복사할 수 있습니다. Dashboard로 이동한 다음, 연결 문자열이 표시된 텍스트 상자에서 보기를 Parameters Only로 변경하세요. 다음 단계에서 이 매개변수가 필요합니다.

​

다음 단계는 무엇인가요?

이제 ClickPipe를 생성하고 Postgres 인스턴스의 데이터를 ClickHouse Cloud로 수집하기 시작할 수 있습니다. ClickPipe 생성 과정에서 필요하므로 Postgres 인스턴스를 설정할 때 사용한 연결 정보를 반드시 기록해 두십시오.