Snowflake Connector for PostgreSQL 데이터 원본의 전제 조건

참고

Snowflake Connector for PostgreSQL 에는 커넥터 약관 이 적용됩니다.

Snowflake Connector for PostgreSQL 를 설치하기 전에 다음 작업을 수행하여 관련 데이터 원본을 준비합니다.

관련 데이터 원본 구성하기

Snowflake와 동기화하려는 데이터가 포함된 PostgreSQL 버전 11 이상의 서버가 있는지 확인합니다. Snowflake Connector for PostgreSQL 를 설치하기 전에 PostgreSQL 환경에서 다음을 수행하십시오.

wal_level 구성하기

Snowflake Connector for PostgreSQL 에서는 wal_levellogical 로 설정해야 합니다.

PostgreSQL 서버가 호스팅되는 위치에 따라 다양한 방법으로 수행할 수 있습니다.

온 프레미스

ALTER SYSTEM 권한이 있는 슈퍼 사용자 또는 사용자로 다음 쿼리를 실행합니다.

ALTER SYSTEM SET wal_level = logical;
Copy

RDS

에이전트가 사용하는 사용자에게는 rds_superuser 또는 rds_replication 역할을 할당해야 합니다.

또한 다음과 같이 설정해야 합니다.

  • rds.logical_replication 정적 매개 변수를 1로 설정합니다.

  • 데이터베이스 및 복제 설정에 따라 max_replication_slots, max_connectionsmax_wal_senders 매개 변수를 설정합니다.

AWS Aurora

rds.logical_replication 정적 매개 변수를 1로 설정합니다.

GCP

다음 플래그를 설정합니다.

  • cloudsql.logical_decoding=on.

  • cloudsql.enable_pglogical=on.

자세한 내용은 Google Cloud 설명서 섹션을 참조하십시오.

Azure

복제 지원을 Logical 로 설정합니다. 자세한 내용은 Azure 설명서 섹션을 참조하십시오.

게시물 구성하기

Snowflake Connector for PostgreSQL 에서는 Publication 을 만들고 구성해야 합니다.

데이터베이스에서 CREATE 권한이 있는 사용자로 로그인하고 다음 쿼리를 실행합니다.

CREATE PUBLICATION <publication name>;
Copy

그런 다음 Snowflake Connector for PostgreSQL 에이전트가 다음을 사용하여 확인할 수 있는 테이블을 정의합니다.

ALTER PUBLICATION <publication name> ADD TABLE <table name>;
Copy

주의

Postgres v15 이상의 경우

테이블 열 중 일부에 대해 게시물이 생성된 경우 ADD_TABLE_WITH_COLUMNS 프로시저를 사용하여 복제할 테이블을 추가하고 정확히 동일한 열 세트를 지정합니다.

ADD_TABLES 를 사용할 경우 커넥터가 작동하기는 하지만 다음과 같이 명확하지 않은 부작용이 발생합니다.

  • 대상 데이터베이스에서 필터에 포함되지 않은 열에는 _DELETED 가 접미사로 추가됩니다. 스냅샷 단계 동안 복제된 모든 데이터는 그대로 유지됩니다.

  • 게시물에 열을 더 추가하는 경우 테이블은 Permanently Failed 상태가 되므로 복제를 다시 시작해야 합니다.

자세한 내용은 ALTER PUBLICATION 설명서 섹션을 참조하십시오.

복제 슬롯 생성하기

Snowflake Connector for PostgreSQL 는 <DATASOURCE NAME>ADD_DATA_SOURCE 프로시저에 지정된 패턴 sf_db_conn_rs_kbmd_<DATASOURCE NAME> 을 갖는 이름으로 PostgreSQL 서버에 복제 슬롯 을 생성합니다.

커넥터가 더 이상 사용되지 않으면 PostgreSQL 서버에 데이터가 축적되지 않도록 복제 슬롯을 제거해야 합니다.

select pg_drop_replication_slot(<slot_name>)
Copy

필수 사용자 생성하기

REPLICATION 특성으로 Snowflake Connector for PostgreSQL 의 사용자를 생성합니다. 복제 보안에 대한 자세한 내용은 PostgreSQL 설명서 섹션을 참조하십시오.

다음 단계

이러한 절차를 완료한 후 Snowsight 를 사용하여 Snowflake Connector for PostgreSQL 설정하기 의 단계를 따르십시오.