gen 2 OpenFlow 커넥터 생명주기 관리

gen 2 OpenFlow 커넥터 생명주기 관리

gen 2 OpenFlow 커넥터의 생명주기를 관리하는 방법을 설명하는 주제예요. 수집 시작·중지와 생성된 gen 2 커넥터 제거를 다뤄요. 커넥터 상태, 처리량, 수집 상태를 모니터링하려면 OpenFlow Connectors Dashboard를 사용해요.

출처: Snowflake 문서 — gen 2 OpenFlow 커넥터 생명주기 관리

본문

gen 2 커넥터가 어떻게 만들어졌는지와 무관하게(설정 마법사로 구성, SQL로 gen 2 커넥터 구성, 또는 다른 지원되는 SQL/API 자동화) 다음 작업들이 적용돼요. gen 1 커넥터라면 각 커넥터의 공개 설정 주제에서 생명주기 지침을 따르세요. gen 1 리소스와 gen 2를 구분하는 방법은 OpenFlow gen 1과 gen 2를 참고하세요.

데이터 이동 시작·중지 (Start and stop data movement)

gen 2 커넥터가 런타임에 설치된 뒤에는 시작해서 소스에서 읽고 Snowflake에 쓰는 작업을 시작하세요. Installed Connectors 탭의 커넥터 메뉴에서 Start를 사용해요.

수집을 일시 중지해야 할 때는 Stop을 사용하세요. 예를 들어 유지보수 전, 커넥터 문서에 설명된 업그레이드 전, 또는 제거하기 전에요. 중지하면 커넥터는 설치된 채로 남지만 유휴(idle) 상태가 돼요.

팁: 일부 커넥터는 중지된 동안 외부 리소스(예: 데이터베이스 복제 슬롯)를 유지해요. 바쁜 소스에서는 그 영향을 이해하지 못한 채 커넥터를 오랫동안 중지 상태로 두지 마세요. 자세한 내용은 커넥터의 설정 또는 유지보수 주제를 참고하세요.

gen 2 커넥터에는 Installed Connectors의 커넥터 메뉴에서 Start와 Stop을 사용하거나, SQL로 ALTER OPENFLOW CONNECTOR ... START 또는 STOP을 실행해 주세요. 구성이나 프로세서 수준의 시작·중지에는 캔버스를 사용하지 마세요. 구문과 대기 함수는 ALTER OPENFLOW CONNECTOR를 참고하세요.

커넥터 제거 (Remove a connector)

gen 2 커넥터 제거는 중지 → 종료 → 삭제(stop → terminate → drop) 순서로 진행돼요. TERMINATE는 제거 전에 이동 중(in-flight)인 데이터를 비워요. 각 단계가 끝나야 다음 단계를 시작하세요.

UI 기반 워크플로에서는 각 단계가 끝나기를 기다렸다가 다음을 시작하세요. 스크립트에서는 비동기 ALTER 명령 뒤에 SYSTEM$WAIT_FOR_STABLE_OPENFLOW_CONNECTORS를 호출해 주세요.

커넥터 제거 (UI)

  • Installed Connectors 탭에서 커넥터 메뉴를 열고 Stop을 선택하세요.
  • Installed Connectors의 커넥터 메뉴에서 Delete를 선택하세요(커넥터를 종료하고 이동 중인 데이터를 비워요).
  • 같은 메뉴에서 Drop을 선택하세요.

커넥터 제거 (SQL)

UI의 Delete는 ALTER OPENFLOW CONNECTOR ... TERMINATE에 대응하고, Drop은 DROP OPENFLOW CONNECTOR에 대응해요. DROP에는 커넥터에 대한 OWNERSHIP 권한이 필요해요.

ALTER OPENFLOW CONNECTOR my_db.my_schema.my_connector STOP;
SELECT SYSTEM$WAIT_FOR_STABLE_OPENFLOW_CONNECTORS(600, 'my_db.my_schema.my_connector');

ALTER OPENFLOW CONNECTOR my_db.my_schema.my_connector TERMINATE;
SELECT SYSTEM$WAIT_FOR_STABLE_OPENFLOW_CONNECTORS(600, 'my_db.my_schema.my_connector');

DROP OPENFLOW CONNECTOR my_db.my_schema.my_connector;

전체 명령 구문, 권한, 추가 ALTER 옵션은 ALTER OPENFLOW CONNECTOR를 참고하세요.

주의: OpenFlow 엔티티에 대해 Delete, Drop, TERMINATE, DROP OPENFLOW CONNECTOR는 되돌릴 수 없어요. Snowflake는 이 객체에 대해 undrop을 지원하지 않아요. 이 단계들은 대상 테이블이나 외부 리소스(예: PostgreSQL 복제 슬롯)를 제거하지 않아요. 확인 대화상자를 주의 깊게 읽어 주세요.

제거 후 소스별 정리(예: PostgreSQL 복제 슬롯)는 PostgreSQL용 OpenFlow 커넥터 설정의 커넥터 중지 또는 삭제와 다른 커넥터의 유사한 섹션을 참고하세요.

더 알아보기 (Learn more)