이메일 알림 보내기

이메일 알림 보내기 (Sending email notifications)

이 문서는 Snowflake에서 이메일 알림을 보내는 방법을 설명해요.

출처: Sending email notifications

본문

개요

Snowflake는 SYSTEM$SEND_EMAIL 시스템 함수를 사용해 이메일 알림을 보낼 수 있어요. 이 함수는 태스크, Snowpipe, 저장 프로시저, 외부 함수에서 이메일을 보내는 데 사용할 수 있어요. 이메일 알림을 보내려면 먼저 이메일 알림 통합(notification integration)을 만들어야 해요.

이메일 알림 통합 만들기

이메일 알림을 위해 TYPE = EMAIL인 알림 통합을 만들어요:

CREATE NOTIFICATION INTEGRATION my_email_integration
  TYPE = EMAIL
  ENABLED = TRUE
  ALLOWED_RECIPIENTS = ('[email protected]', '[email protected]');

ALLOWED_RECIPIENTS: 이 통합으로 이메일을 받을 수 있는 수신자 목록.

SYSTEM$SEND_EMAIL 사용

이메일을 보내려면 SYSTEM$SEND_EMAIL 함수를 호출해요:

SELECT SYSTEM$SEND_EMAIL(
  'my_email_integration',
  '[email protected], [email protected]',
  '제목',
  '이메일 본문'
);

함수 시그니처:

SYSTEM$SEND_EMAIL(
  <integration_name>,
  <recipients>,
  <subject>,
  <body>
)

<integration_name>: 이메일 알림 통합의 이름.
<recipients>: 쉼표로 구분된 수신자 이메일 주소 목록.
<subject>: 이메일 제목.
<body>: 이메일 본문.

태스크에서 이메일 알림 사용

태스크의 성공/실패 시 이메일을 보내려면 태스크 정의에 SYSTEM$SEND_EMAIL 호출을 포함할 수 있어요. 예를 들어 태스크 본문에서 이메일을 보내는 방식:

CREATE OR REPLACE TASK task1
  SCHEDULE = '5 MINUTE'
AS
  CALL SYSTEM$SEND_EMAIL(
    'my_email_integration',
    '[email protected]',
    '태스크 완료',
    'task1이 완료되었습니다.'
  );

태스크 완료·실패 이벤트에 따른 알림 구성은 태스크 알림을 참고하세요.

수신자 관리

ALTER NOTIFICATION INTEGRATION으로 허용된 수신자를 관리할 수 있어요:

ALTER NOTIFICATION INTEGRATION my_email_integration
  SET ALLOWED_RECIPIENTS = ('[email protected]');

제한 사항

이메일 알림 통합은 Enterprise Edition 이상에서 지원될 수 있어요.
수신자는 통합에 허용된 목록에 있어야 해요.
이메일 본문은 일반 텍스트로 전송돼요.