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>' ]
필수 매개 변수¶
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 <오브젝트> 문은 원자성입니다. 즉, 오브젝트가 바뀔 때 단일 트랜잭션으로 이전 오브젝트가 삭제되고 새 오브젝트가 생성됩니다.
클라우드 공급자의 정부 리전에서는 이벤트 알림이 다른 상업 리전으로 전송되거나 다른 상업 리전에서 전송되는 것을 허용하지 않습니다.
예¶
다음 항목을 참조하십시오.