사전 준비 사항
- 복제 권한이 있는 사용자로 원본 PostgreSQL 데이터베이스에 접근할 수 있어야 합니다. 원본에 해당하는 설정 가이드를 따르십시오.
- 마이그레이션 대상으로 사용할 ClickHouse Managed Postgres 서비스가 필요합니다. 아직 없다면 quickstart를 참조하십시오.
- 로컬 머신에
pg_dump와psql이 설치되어 있어야 합니다. 둘 다 기본 PostgreSQL 클라이언트 도구에 포함되어 있습니다.
마이그레이션 전에 고려할 사항
- DDL 전파: 지속적 복제(CDC)에서는 DML 작업과
ADD COLUMN을 포착합니다.DROP COLUMN및ALTER COLUMN같은 다른 DDL 변경 사항은 전파되지 않으므로 대상에 수동으로 적용해야 합니다.
마이그레이션 중 문제가 발생하면 일반적인 오류와 해결 방법은 Managed Postgres Migrations FAQ에서 확인하십시오.
1
원본 데이터베이스에 연결
ClickHouse Cloud 콘솔을 열고 Managed Postgres 서비스를 선택합니다.왼쪽 사이드바에서 데이터 소스를 클릭합니다.Start import를 클릭합니다.원본 PostgreSQL 데이터베이스의 연결 정보를 입력합니다: 호스트, 포트, 사용자 이름, 비밀번호, 데이터베이스 이름. 원본 데이터베이스에서 필요하면 TLS를 활성화합니다.원본 데이터베이스에 대한 비공개 연결이 필요하면 SSH tunneling을 선택하고 필요한 SSH 정보를 입력할 수 있습니다. 이렇게 하면 공개적으로 접근할 수 없는 데이터베이스에도 마이그레이션이 안전하게 연결할 수 있습니다.수집 메서드를 선택합니다:
- 초기 적재 + CDC — 기존 데이터를 복사한 다음, 이후 변경 사항도 계속 반영하여 대상을 동기화 상태로 유지합니다.
- 초기 적재 only — 한 번만 복사하고, 이후 복제는 수행하지 않습니다.
- CDC only — 초기 복사를 건너뛰고 이 시점 이후의 새 변경 사항만 복제합니다.
2
데이터베이스 스키마 내보내기
마법사에 원본 연결 정보가 미리 입력된 이 명령을 실행하면 현재 디렉터리에
pg_dump 명령이 표시됩니다. 터미널에서 실행합니다:pg.sql이 생성됩니다.다음을 클릭합니다.3
Managed Postgres 서비스로 스키마 가져오기
드롭다운에서 대상 데이터베이스를 선택하거나 Create a new database를 클릭해 새 데이터베이스를 프로비저닝합니다.마법사에 스키마 덤프를 Managed Postgres 서비스에 적용하는 다음을 클릭합니다.
psql 명령이 표시됩니다. 터미널에서 실행합니다:4
수집 설정 구성
논리적 복제에 사용할 publication을 지정합니다. 이 값을 비워 두면 publication이 자동으로 생성됩니다.처리량을 조정하려면 Advanced replication settings를 펼칩니다:
다음을 클릭합니다.
5
테이블 선택
복제할 테이블을 선택합니다. 테이블은 스키마별로 그룹화되어 있습니다. 개별 테이블을 선택하거나 스키마를 펼쳐 전체를 선택합니다.Create migration을 클릭합니다.