2세대(gen 2) OpenFlow 객체와 인터페이스

2세대(gen 2) OpenFlow 객체와 인터페이스

gen 2 OpenFlow는 AWS, Azure, GCP에서 사용할 수 있어요. gen 2 배포와 런타임 SQL 객체는 일반 공개(GA) 상태이고, gen 2 커넥터 구성(설정 마법사, SQL/스테이지 기반 구성, 지원 커넥터)은 Public Preview 상태예요.

출처: Snowflake 문서 — 2세대 OpenFlow 객체와 인터페이스

본문

2세대(gen 2) OpenFlow 배포·런타임·커넥터는 일급(first-class) Snowflake 객체예요. OpenFlow UI나 SQL 명령으로 동일한 기본 객체를 사용할 수 있어요.

gen 1과 gen 2 리소스는 같은 계정에 공존할 수 있어요.

  • 새 배포는 gen 2만 가능해요. 더 이상 새 gen 1 배포(BYOC 또는 Snowflake)를 만들 수 없어요. 모든 새 배포는 CREATE OPENFLOW DEPLOYMENT를 사용해야 해요.
  • 런타임은 부모 배포의 세대를 상속해요. gen 1 배포의 새 런타임은 gen 1이고, gen 2 배포의 새 런타임은 gen 2예요.
  • gen 2 런타임은 gen 1과 gen 2 커넥터를 모두 지원해요. 두 유형이 같은 gen 2 런타임에 공존할 수 있어요.
  • gen 1 런타임은 gen 1 커넥터만 지원해요. gen 1 런타임에 gen 2 커넥터를 설치하지 마세요.
  • 기존 gen 1 리소스는 gen 1 그대로, 변경 없이 계속 작동해요. gen 1에서 gen 2로의 마이그레이션은 Private Preview로 제공되며, 포함되려면 Snowflake 계정 담당자에게 문의하세요.

gen 2는 SQL 우선 생명주기 관리, 수정된 보안 모델, 버전 관리 구성을 가진 파일 기반 엔티티(FBE)로 관리되는 커넥터를 도입해요.

여기서 시작 (Start here)

gen 2 OpenFlow가 처음이라면 다음 주제를 순서대로 읽어 주세요.

  • OpenFlow gen 1과 gen 2 — 배포·런타임·커넥터의 gen 1 vs gen 2 차이와 각 세대에 적용되는 문서 세트를 이해해요.
  • About OpenFlow — gen 1과 gen 2가 공유하는 OpenFlow 개념(배포 유형, 아키텍처, 사용 사례)을 검토해요.
  • Quickstart: gen 2 OpenFlow — 권한을 설정하고 첫 gen 2 배포·런타임·커넥터를 만들어요.
  • gen 1에서 마이그레이션 중인가요? gen 1에서 gen 2로의 마이그레이션은 Private Preview로 제공되며, 포함되려면 Snowflake 계정 담당자에게 문의하세요.
  • 설정 마법사로 커넥터 구성 — 설정 마법사로 gen 2 커넥터를 설치·구성해요(Public Preview).
  • gen 2 커넥터를 SQL로 구성 — SQL과 스테이지 명령으로 gen 2 커넥터를 만들고 구성해요(Public Preview).

알려진 제한 사항 (Known limitations)

지원되는 연산과 생명주기에서 gen 2가 gen 1과 어떻게 다른지는 OpenFlow gen 1과 gen 2를 참고하세요.

쿼터 (Quotas)

  • BYOC 배포: 계정당 최대 20개(OpenFlow와 Snowflake가 강제).
  • Snowflake 배포: 계정당 최대 3개.
  • 런타임: 배포당 최대 100개. 그 최대값 전에 다른 한도에 도달할 수 있어요 — 예를 들어 BYOC 배포의 노드 유형당 EC2 노드 50개, 또는 다른 애플리케이션이 스토리지를 소비할 때 Snowflake 배포의 블록 스토리지 쿼터.
  • 런타임은 최대 50개 노드를 가질 수 있어요. 이는 양쪽 세대(BYOC 노드 그룹과 Snowflake 배포 컴퓨트 풀) 모두에 적용돼요.

진단 (Diagnostics)

  • gen 2 런타임 진단 번들은 SQL이나 OpenFlow UI에서 만들 수 있어요. Snowflake 배포 진단 번들(단일 런타임에 한정되지 않음)도 SQL에서 지원돼요. BYOC 문제 해결에는 배포 에이전트 인스턴스에서 ./diagnostics.sh를 실행할 수도 있어요. Troubleshoot Openflow를 참고하세요.

gen 1과 공유하는 연산 (Operations shared with gen 1)

  • gen 2 배포·런타임·커넥터에 대한 GRANT OWNERSHIP은 현재 기본 기능을 깨뜨릴 수 있어요. 다가오는 업데이트까지 소유권 이전을 피하세요. OpenFlow gen 1과 gen 2의 OWNERSHIP 전송을 참고하세요.
  • BYOC 배포의 경우 설치·업그레이드 문서를 UI에서만 다운로드할 수 있어요. 업그레이드는 자동이 아니에요. Manage Openflow를 참고하세요.

플랫폼 통합 (Platform integration)

  • 객체 태깅(ALTER ... SET TAG)은 gen 2 배포·런타임·커넥터에서 지원되지 않아요.
  • gen 2 배포·런타임·커넥터는 ACCOUNT_USAGE.OBJECT_DEPENDENCIES, ACCOUNT_USAGE.ACCESS_HISTORY, GET_LINEAGE(Snowsight Lineage 탭 포함)로 추적되지 않아요.
  • gen 2 배포·런타임·커넥터에는 CREATE ... CLONE이 지원되지 않아요.
  • gen 2 배포·런타임·커넥터에는 CREATE OR REPLACE와 CREATE OR ALTER가 지원되지 않아요. 대신 CREATE ... IF NOT EXISTS와 ALTER ... IF EXISTS를 사용하세요.
  • gen 2 배포·런타임·커넥터는 share에 추가할 수 없어요.
  • gen 2 배포·런타임·커넥터는 DCM(Database Change Management) 프로젝트의 지원 엔티티 유형이 아니에요.

비용 관리와 가용성 (Cost management and availability)

  • 리소스 모니터는 gen 2 Snowflake 배포 컴퓨트 풀을 지원하지 않아요.
  • gen 2 배포와 런타임은 예산(budget)에 추가할 수 없어요.
  • gen 2 배포는 복제 또는 장애 조치(failover) 그룹에 추가할 수 없어요. gen 2 런타임과 커넥터는 데이터베이스 복제도 지원되지 않아요. 포함된 데이터베이스가 복제되면 이들이 건너뛰어져 장애 조치 후 대상 계정에 존재하지 않게 돼요. gen 2 객체에는 내장된 크로스 리전/크로스 클라우드 재해 복구가 없어요.

gen 2 객체 삭제 (Dropping gen 2 objects)

  • DROP OPENFLOW DEPLOYMENT와 DROP OPENFLOW RUNTIME은 되돌릴 수 없어요. Snowflake는 이 객체에 대해 undrop을 지원하지 않는데, 이는 커넥터에 대해 문서화된 제한과 같아요. 커넥터 제거를 참고하세요.

설정 마법사 (Setup wizard, Public Preview)

  • 설정 마법사 플로우에서 Private link는 지원되지 않아요. 배포와 런타임 UI 접근용 Private link는 별도로 지원돼요. OpenFlow - Snowflake Deployments의 PrivateLink UI 접근 설정을 참고하세요.

gen 2 문서 (Gen 2 documentation)

주제 설명
OpenFlow gen 1과 gen 2 gen 1과 gen 2 배포·런타임·커넥터 비교; 권한 부여와 생명주기 차이; 리소스 식별 방법과 따라야 할 문서.
Quickstart: gen 2 OpenFlow 사전 요구 사항, 권한 부여, gen 2 리소스 생성 예시 명령.
gen 2 커넥터 구성 및 버전 관리 (Public Preview) SQL·Git·자동화를 위한 버전 구성(UI만 사용한다면 선택적 배경). 검증된 구성을 재사용하기 위한 스테이지 접근과 Git 워크플로.
설정 마법사로 커넥터 구성 (Public Preview) gen 2 커넥터를 위한 단계별 설정 마법사.
gen 2 커넥터를 SQL로 구성 (Public Preview) SQL과 스테이지 명령으로 gen 2 커넥터 생성·구성(프로그래밍 방식 설정).
gen 2 OpenFlow 커넥터 생명주기 관리 (Public Preview) 설치 후 gen 2 커넥터 시작·중지·제거.
OpenFlow Connectors Dashboard로 커넥터 모니터링 gen 2 커넥터 상태·처리량·수집 상태 모니터링.
배포 및 런타임 마이그레이션 (Private Preview) 기존 gen 1 배포와 모든 런타임을 gen 2 객체로 마이그레이션. 사전 요구 사항, 마이그레이션 마법사, 마이그레이션 후 접근 부여, 롤백 제약, 문제 해결을 다룸. 접근은 Snowflake 계정 담당자에게 문의.
커넥터 마이그레이션 (Private Preview) 개별 gen 1 커넥터를 gen 2 커넥터 인스턴스로 마이그레이션. 사전 요구 사항, Snowflake Secrets 재배선, 비활성화된 소스 커넥터, 실패 복구를 다룸. 접근은 Snowflake 계정 담당자에게 문의.

gen 1 문서 (Gen 1 documentation)

gen 1 OpenFlow 리소스는 계속 공개 OpenFlow 문서를 사용해요. gen 1 배포·런타임·카탈로그 설치 커넥터로 작업할 때는 다음 주제를 따라 주세요.

  • OpenFlow - BYOC 설정 및 OpenFlow - Snowflake Deployment 설정 - 작업 개요 — gen 1 배포를 관리하고 gen 1 런타임을 만들어요.
  • OpenFlow - Snowflake Deployment 설정: 런타임 생성 — gen 1 런타임을 만들어요.
  • OpenFlow 커넥터 — 런타임 캔버스에서 Install 또는 Import from Registry로 gen 1 커넥터를 설치·구성해요.
  • Manage Openflow — UI에서 gen 1 배포와 런타임을 관리해요.

소스별 설정(예: PostgreSQL CDC 준비)은 gen 1과 gen 2 커넥터 모두 공개 문서의 커넥터 설정 주제를 사용해요. 소스 구성이 같을 때 gen 2 커넥터 주제들은 그 지침에 연결돼요.

더 알아보기 (Learn more)