메인 콘텐츠로 건너뛰기
ClickHouse Managed Postgres는 ClickHouse Cloud에서 제공하는 완전 관리형 Postgres 서비스입니다. ClickPipes에 연결하기 가장 빠른 Postgres 소스로, 모든 인스턴스에 논리적 복제가 기본 활성화되어 있고, ClickPipes IP 주소가 기본적으로 허용되며, 연결 정보도 ClickHouse 서비스와 동일한 콘솔에서 확인할 수 있습니다. ClickHouse Managed Postgres 인스턴스에서 복제를 시작하는 방법은 세 가지입니다. 세 방법 모두 일반적인 Postgres ClickPipe를 생성하므로, 파이프가 실행되면 Postgres ClickPipe 문서의 모든 내용이 그대로 적용됩니다.

옵션 1: Postgres 서비스에서 ClickHouse로 동기화

ClickHouse Cloud 콘솔에서 ClickHouse Managed Postgres 서비스를 열고 사이드바의 Sync to ClickHouse를 클릭하십시오. 마법사가 소스 연결 정보를 미리 채워 주며, 대상 ClickHouse 서비스와 복제 방식, 복제할 테이블을 선택할 수 있습니다. 사용자, publication, 네트워크 설정은 별도로 필요하지 않습니다. 단계별 안내는 Sync to ClickHouse 가이드를 참고하십시오. 지연 시간이 짧은 복제가 필요하다면, 파일 시스템 수준에서 읽기를 수행하는 네이티브 복제 엔진인 WalShadow를 선택할 수도 있습니다. 현재 비공개 프리뷰로 제공됩니다.

옵션 2: ClickPipes에서 ClickHouse Managed Postgres를 소스로 선택

대상 쪽에서 시작하려면 ClickHouse 서비스를 열고 Data Sources로 이동한 뒤, 소스 목록에서 ClickHouse Managed Postgres를 선택하십시오. 이후 다른 Postgres 소스와 동일한 방식으로 Postgres 인스턴스의 연결 정보를 입력합니다.

연결 정보

ClickHouse Managed Postgres 서비스를 열고 Connect를 클릭하면 host, port, database, user, password를 확인할 수 있습니다. via PgBouncer 토글을 사용하지 말고 Postgres에 직접 연결하십시오. ClickPipes는 PgBouncer를 비롯한 어떤 연결 풀러를 통한 복제도 지원하지 않습니다. 자세한 내용은 Connection을 참조하십시오. clickhousectl에서는 clickhousectl cloud postgres get <postgres-id> 명령으로 호스트명과 사용자 이름을 확인할 수 있습니다. 단, 이 명령은 비밀번호를 반환하지 않습니다. 비밀번호는 cloud postgres create 실행 시 한 번만 표시되며, clickhousectl cloud postgres reset-password <postgres-id> --generate 명령으로 새 비밀번호를 설정할 수 있습니다.

권한을 가진 사용자 생성하기

기본 postgres 사용자로 연결할 수 있습니다. 프로덕션 환경에서는 다른 Postgres 소스와 마찬가지로 전용 읽기 전용 복제 사용자를 사용하는 것을 권장합니다. psql로 인스턴스에 연결한 후 다음을 실행하십시오:
  1. ClickPipes 전용 사용자를 생성합니다:
  2. 해당 사용자에게 스키마 수준의 읽기 전용 액세스를 부여합니다. 다음 예시는 public 스키마에 대한 권한을 보여줍니다. 복제하려는 테이블이 포함된 각 스키마마다 아래 명령어를 반복하십시오:
  3. 해당 사용자에게 복제 권한을 부여합니다:
  4. 복제하려는 테이블을 포함하는 발행(publication)을 생성합니다. 성능 오버헤드를 줄이려면 꼭 필요한 테이블만 발행(publication)에 포함할 것을 강력히 권장합니다.
발행(publication)에 포함되는 모든 테이블에는 primary key가 정의되어 있거나 replica identity가 FULL로 설정되어 있어야 합니다. 범위 설정에 대한 지침은 Postgres FAQ를 참조하십시오.
  • 특정 테이블에 대한 발행(publication)을 생성하려면:
  • 특정 스키마의 모든 테이블에 대한 발행(publication)을 생성하려면:

논리적 복제

논리적 복제는 모든 ClickHouse Managed Postgres 인스턴스에서 이미 활성화되어 있습니다. 별도로 변경해야 할 wal_level 설정이나 parameter group은 없습니다. 다음 명령으로 확인할 수 있습니다:

네트워크 액세스

ClickHouse Managed Postgres는 기본적으로 ClickPipes의 연결을 허용합니다. Postgres 서비스에 IP 필터를 구성한 경우, ClickHouse 서비스가 위치한 리전의 ClickPipes 고정 IP 주소를 허용 목록에 추가하십시오. clickhousectl을 사용하는 경우 Postgres 직접 연결 포트에 주소마다 규칙을 하나씩 추가한 다음, clickhousectl cloud postgres get <postgres-id>를 실행하여 결과를 확인하십시오.

TLS

ClickHouse Managed Postgres 인스턴스는 해당 인스턴스에만 고유하며 공개적으로 신뢰되지 않는 CA가 서명한 인증서(certificate)를 제시합니다. ClickPipes는 기본적으로 인증서 검증(certificate verification)을 활성화하므로, 다음 중 하나를 수행하기 전까지는 연결 확인이 실패합니다.
  • Postgres 서비스의 Settings 탭에서 CA 인증서 번들을 다운로드한 후, ClickPipe 연결 설정의 Upload CA를 통해 제공하십시오. 이 방법을 권장합니다. 번들을 찾을 수 있는 위치는 Verified TLS connection을 참조하십시오.
  • ClickPipe 연결 설정에서 Skip certificate verification을 활성화하십시오. 연결은 암호화된 상태로 유지되지만 서버 아이덴티티는 확인되지 않습니다.
clickhousectl로 파이프를 생성하는 경우, 옵션 3에 나온 것처럼 번들을 가져온 후 --ca-certificate로 전달하십시오.

옵션 3: clickhousectl로 파이프 생성하기

clickhousectl을 사용하면 명령줄에서 동일한 파이프를 생성할 수 있습니다. 먼저 옵션 2와 같이 사용자와 clickpipes 발행(publication)을 설정하십시오. 기본 postgres 사용자를 대신 사용하려면 --publication-name을 생략하십시오. 그러면 CLI가 매핑된 테이블에 대한 발행(publication)을 자동으로 생성합니다. 파이프를 생성하려면 API Key가 필요합니다. OAuth 로그인으로는 읽기 전용 작업만 가능합니다. 호스트명을 조회한 다음 인스턴스의 CA 번들을 저장하십시오.
--ca-certificate 옵션으로 CA 번들을 전달하여 대상 ClickHouse 서비스에 파이프를 생성하세요:
이 파이프는 ReplacingMergeTree 테이블을 생성합니다. 현재 상태는 SELECT ... FROM events FINAL WHERE _peerdb_is_deleted = 0으로 조회하십시오. 파이프가 Running 상태가 될 때까지 기다리는 방법과 데이터를 검증하는 방법을 포함한 전체 과정은 Postgres ClickPipe 가이드의 CLI 보기를 참조하십시오.

다음 단계

이제 ClickPipe를 생성하여 ClickHouse Managed Postgres 인스턴스의 데이터를 ClickHouse Cloud로 수집할 수 있습니다. ClickHouse Managed Postgres에서 ClickHouse로의 Native CDC는 추가 비용 없이 제공됩니다. 자세한 내용은 요금을 참조하십시오.