CREATE NOTIFICATION INTEGRATION(Google Pub/Sub 항목으로 아웃바운드)

Google Pub/Sub 항목으로 메시지 전송 을 위해 계정에 새 알림 통합을 만들거나 기존 통합을 바꿉니다.

참고

현재 이 기능은 Google Cloud Platform(GCP)에 호스팅된 Snowflake 계정으로 제한됩니다.

참고 항목:

ALTER NOTIFICATION INTEGRATION(Google Pub/Sub 항목으로 아웃바운드) , DESCRIBE INTEGRATION , DROP INTEGRATION , SHOW INTEGRATIONS

구문

CREATE [ OR REPLACE ] NOTIFICATION INTEGRATION [ IF NOT EXISTS ] <name>
  ENABLED = { TRUE | FALSE }
  TYPE = QUEUE
  DIRECTION = OUTBOUND
  NOTIFICATION_PROVIDER = GCP_PUBSUB
  GCP_PUBSUB_TOPIC_NAME = '<topic_id>'
  [ COMMENT = '<string_literal>' ]
Copy

필수 매개 변수

name

통합에 대한 식별자(즉, 이름)를 지정하는 문자열로, 계정에서 고유해야 합니다.

또한, 식별자는 알파벳 문자로 시작해야 하며 전체 식별자 문자열을 큰따옴표(예: "My object")로 묶지 않는 한 공백이나 특수 문자를 포함할 수 없습니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

ENABLED = { TRUE | FALSE }

통합 작업을 시작할지 일시 중단할지 여부를 지정합니다.

  • TRUE 로 지정하면 통합이 활성화됩니다.

  • FALSE 로 지정하면 유지 관리를 위해 통합이 비활성화됩니다. Snowflake와 서드 파티 서비스 간의 통합이 작동하지 않습니다.

TYPE = QUEUE

이는 Snowflake와 서드 파티 클라우드 메시지 큐 서비스 간의 통합임을 지정합니다.

DIRECTION = OUTBOUND

Snowflake가 클라우드 메시징 서비스로 보내는 알림을 생성하도록 지정합니다.

NOTIFICATION_PROVIDER = GCP_PUBSUB

Google Cloud Pub/Sub를 서드 파티 클라우드 메시지 큐 서비스로 지정합니다.

GCP_PUBSUB_TOPIC_NAME = 'topic_id'

Snowflake가 알림을 푸시하는 Pub/Sub 항목의 식별입니다.

선택적 매개 변수

COMMENT = 'string_literal'

통합에 대한 설명을 지정하는 문자열(리터럴)입니다.

기본값: 값 없음

액세스 제어 요구 사항

이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한

오브젝트

참고

CREATE INTEGRATION

계정

Only the ACCOUNTADMIN role has this privilege by default. The privilege can be granted to additional roles as needed.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트

  • 푸시 알림을 위해 여러 파이프에 대해 동일한 아웃바운드 알림 통합을 사용할 수 있습니다.

  • 메타데이터 관련:

    주의

    고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.

  • CREATE OR REPLACE <오브젝트> 문은 원자성입니다. 즉, 오브젝트가 바뀔 때 단일 트랜잭션으로 이전 오브젝트가 삭제되고 새 오브젝트가 생성됩니다.

  • 클라우드 공급자의 정부 리전에서는 이벤트 알림이 다른 상업 리전으로 전송되거나 다른 상업 리전에서 전송되는 것을 허용하지 않습니다.

다음 항목을 참조하십시오.