CREATE NOTIFICATION INTEGRATION

CREATE NOTIFICATION INTEGRATION (email)

이메일 메시지를 보내기 위해 계정에 새 알림 인티그레이션(notification integration)을 만들거나 기존 인티그레이션을 교체하는 명령이에요.

출처: 문서

본문

이메일 메시지를 보내기 위해 계정에 새 알림 인티그레이션을 만들거나 기존 인티그레이션을 교체해요.

함께 보기: ALTER NOTIFICATION INTEGRATION (email), DESCRIBE NOTIFICATION INTEGRATION, DROP INTEGRATION, SHOW NOTIFICATION INTEGRATIONS

구문 (Syntax)

CREATE [ OR REPLACE ] NOTIFICATION INTEGRATION [ IF NOT EXISTS ] <name>
  TYPE = EMAIL
  ENABLED = { TRUE | FALSE }
  [ ALLOWED_RECIPIENTS = ( '<email_address>' [ , ... '<email_address>' ] ) ]
  [ DEFAULT_RECIPIENTS = ( '<email_address>' [ , ... '<email_address>' ] ) ]
  [ DEFAULT_SUBJECT = '<subject_line>' ]
  [ COMMENT = '<string_literal>' ]

필수 매개변수 (Required parameters)

name 인티그레이션의 식별자(즉 이름)를 지정하는 문자열로, 계정 안에서 고유해야 해요.

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

자세한 내용은 식별자 요구 사항(Identifier requirements)을 참고해요.

ENABLED = { TRUE | FALSE } 인티그레이션의 운영을 시작할지 일시 중지할지를 지정해요.

  • TRUE는 인티그레이션을 활성화해요.
  • FALSE는 유지보수를 위해 인티그레이션을 비활성화해요. Snowflake와 타사 서비스 사이의 어떤 인티그레이션도 작동하지 않아요.

값은 대소문자를 구분하지 않아요. 기본값은 TRUE예요.

TYPE = EMAIL 인티그레이션이 Snowflake와 타사 이메일 서비스 사이의 인터페이스를 만든다고 지정해요.

선택 매개변수 (Optional parameters)

ALLOWED_RECIPIENTS = ( 'email_address' [ , ... 'email_address' ] ) (TYPE = EMAIL용) 이 인티그레이션에서 알림 이메일을 받을 수 있는, 따옴표로 묶인 이메일 주소의 쉼표로 구분된 목록이에요.

현재 계정에 있는 사용자의 이메일 주소를 지정해야 해요. 이 사용자들은 이메일 주소를 확인(verify)해야 해요.

지정할 수 있는 최대 이메일 주소 수는 50개예요.

이 매개변수를 생략하면 현재 계정의 확인된 이메일 주소에 알림 이메일을 보낼 수 있어요.

DEFAULT_RECIPIENTS = ( 'email_address' [ , ... 'email_address' ] ) 이 인티그레이션으로 보내는 메시지의 기본 수신자 목록을 지정해요. 기본 수신자를 지정하려면 따옴표로 묶인 이메일 주소의 쉼표로 구분된 목록을 사용해요.

현재 계정에 있는 사용자의 이메일 주소를 지정해야 해요. 이 사용자들은 이메일 주소를 확인해야 해요.

특정 메시지의 기본 수신자를 재정의하려면 SYSTEM$SEND_SNOWFLAKE_NOTIFICATION 저장 프로시저를 호출할 때 EMAIL_INTEGRATION_CONFIG 헬퍼 함수를 사용해요.

DEFAULT_SUBJECT = 'subject_line' 이 인티그레이션으로 보내는 메시지의 기본 제목 줄을 지정해요.

제목은 256자를 초과할 수 없어요.

  • 기본값: 'Snowflake Email Notification'

특정 메시지의 기본 제목 줄을 재정의하려면 SYSTEM$SEND_SNOWFLAKE_NOTIFICATION 저장 프로시저를 호출할 때 EMAIL_INTEGRATION_CONFIG 헬퍼 함수를 사용해요.

COMMENT = 'string_literal' 인티그레이션에 대한 설명(comment)을 지정하는 문자열(리터럴)이에요.

  • 기본값: 값 없음

접근 제어 요구 사항 (Access control requirements)

이 작업을 실행하는 데 사용하는 역할(role)은 최소한 다음 권한을 가져야 해요.

권한 (Privilege) 객체 (Object) 비고
CREATE INTEGRATION Account 기본적으로 ACCOUNTADMIN 역할만 이 권한을 가져요. 필요에 따라 추가 역할에 부여될 수 있어요.
CREATE NOTIFICATION INTEGRATION Account 알림 인티그레이션을 만들 수 있는 권한을 부여해요. 이 권한은 다른 유형의 인티그레이션을 만들 수 있는 권한은 부여하지 않아요.

지정된 권한 집합으로 사용자 지정 역할을 만드는 방법은 사용자 지정 역할 만들기(Creating custom roles)를 참고해요. 보호 가능한 객체에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여의 일반적인 내용은 접근 제어 개요(Overview of Access Control)를 참고해요.

사용 메모 (Usage notes)

메타데이터에 관해서는 다음 사항에 주의해요.

⚠️ 주의: 고객은 Snowflake 서비스를 사용할 때 (User 객체를 제외하고) 개인 데이터·민감 데이터·수출 통제 데이터·기타 규제 데이터를 메타데이터로 입력하지 않도록 해야 해요. 자세한 내용은 Snowflake의 메타데이터 필드를 참고해요.

OR REPLACE와 IF NOT EXISTS 절은 서로 배타적이에요. 같은 문에서 둘 다 사용할 수 없어요.

CREATE OR REPLACE <object> 문은 원자적(atomic)으로 동작해요. 즉, 객체를 교체할 때 기존 객체는 삭제되고 새 객체는 단일 트랜잭션 안에서 생성돼요.

예시 (Examples)

이메일 알림 보내기(Sending email notifications)를 참고해요.

더 알아보기 (Learn more)