CREATE OPENFLOW DEPLOYMENT

CREATE OPENFLOW DEPLOYMENT

계정에 gen 2 Openflow 배포(deployment)를 만드는 명령이에요. 배포는 Openflow 커넥터와 런타임을 호스팅하는 실행 환경이에요.

출처: 문서

본문

계정에 gen 2 Openflow 배포를 만들어요.

함께 보기: ALTER OPENFLOW DEPLOYMENT, DROP OPENFLOW DEPLOYMENT, SHOW OPENFLOW DEPLOYMENTS, DESCRIBE OPENFLOW DEPLOYMENT

구문 (Syntax)

CREATE OPENFLOW DEPLOYMENT [ IF NOT EXISTS ] <name>
  [ DEPLOYMENT_TYPE = { SNOWFLAKE | BYOC } ]
  [ VPC_TYPE = { 'MANAGED' | 'PROVIDED' } ]
  [ USE_PRIVATE_LINK = { TRUE | FALSE } ]
  [ USE_USER_AUTH_OVER_PRIVATE_LINK = { TRUE | FALSE } ]
  [ CUSTOM_INGRESS_HOSTNAME = <string> ]
  [ DISPLAY_NAME = <string> ]
  [ COMMENT = <string> ]
  [ EVENT_TABLE = { '<database>.<schema>.<tablename>' | NONE } ]

필수 매개변수 (Required parameters)

name 배포의 식별자를 지정해요. 유효한 객체 식별자는 모두 지원돼요. 자세한 내용은 식별자 요구 사항(Identifier requirements)을 참고해요.

선택 매개변수 (Optional parameters)

IF NOT EXISTS 배포가 이미 존재하지 않을 때만 만들도록 해요. 배포가 이미 존재하면 문은 아무것도 하지 않고 성공 메시지를 반환해요.

DEPLOYMENT_TYPE = { SNOWFLAKE | BYOC } SNOWFLAKE는 Openflow - Snowflake Deployment 배포를 만들어요. BYOC는 클라우드 계정에 배포를 만들어요.

  • 기본값: SNOWFLAKE

VPC_TYPE = { 'MANAGED' | 'PROVIDED' } BYOC 전용이에요. MANAGED는 Snowflake 관리 VPC를 사용하고, PROVIDED는 기존 VPC를 사용해요.

  • 기본값: 값 없음

USE_PRIVATE_LINK = { TRUE | FALSE }

  • 기본값: FALSE

USE_USER_AUTH_OVER_PRIVATE_LINK = { TRUE | FALSE } BYOC 전용이에요. USE_PRIVATE_LINK = TRUE가 필요해요.

  • 기본값: FALSE

CUSTOM_INGRESS_HOSTNAME = string BYOC 전용이에요. 인그레스(ingress) 트래픽의 사용자 지정 호스트 이름이에요.

  • 기본값: 값 없음

DISPLAY_NAME = string UI 표시 이름이에요. 설정하지 않으면 Openflow UI에 SQL name이 표시돼요.

  • 기본값: 값 없음

COMMENT = string

  • 기본값: 값 없음

EVENT_TABLE = { 'database.schema.tablename' | NONE } 이 배포에 대한 Openflow 로그와 메트릭을 받는 이벤트 테이블이에요. 배포별 테이블을 사용하려면 정규화된 이름을 지정해요.

  • 기본값: 값 없음 (계정 수준 이벤트 테이블을 상속)

현재 값을 보려면 SHOW PARAMETERS LIKE 'EVENT_TABLE' IN OPENFLOW DEPLOYMENT <name>을 실행해요. EVENT_TABLE은 SHOW OPENFLOW DEPLOYMENTS 또는 DESCRIBE OPENFLOW DEPLOYMENT 출력에는 표시되지 않아요.

접근 제어 (Access control)

계정에 대한 CREATE OPENFLOW DEPLOYMENT 권한이 필요해요. DEPLOYMENT_TYPE = SNOWFLAKE(기본값)의 경우 계정에 대한 CREATE COMPUTE POOL 권한도 필요해요.

사용 메모 (Usage notes)

이 명령은 즉시 반환돼요. 배포 프로비저닝은 비동기로 실행되며 Snowflake 배포는 일반적으로 5~10분이 걸려요. 배포가 ACTIVE가 될 때까지 기다리려면 SYSTEM$WAIT_FOR_OPENFLOW_DEPLOYMENT_STATUS 또는 SYSTEM$WAIT_FOR_STABLE_OPENFLOW_DEPLOYMENTS를 사용해요.

각 계정은 최대 3개의 Snowflake Openflow 배포를 지원해요. Gen 1과 gen 2 배포는 이 제한을 공유하므로, 계정에 이미 Snowflake 배포가 3개 있으면 세대와 관계없이 CREATE OPENFLOW DEPLOYMENT WITH DEPLOYMENT_TYPE = SNOWFLAKE는 실패해요.

BYOC 배포를 만든 뒤에는 Openflow UI의 CloudFormation 템플릿으로 클라우드 설치를 완료해요. Set up Openflow - BYOC를 참고해요.

예시 (Example)

CREATE OPENFLOW DEPLOYMENT my_deployment
  DEPLOYMENT_TYPE = BYOC
  VPC_TYPE = 'MANAGED'
  DISPLAY_NAME = 'My BYOC Deployment';

CREATE OPENFLOW DEPLOYMENT my_snowflake_deployment
  DEPLOYMENT_TYPE = SNOWFLAKE
  EVENT_TABLE = 'openflow.telemetry.events';

더 알아보기 (Learn more)