참고:

이 사용지침서에서는 Oracle Cloud에 접근해야 합니다. 무료 계정에 등록하려면 Oracle Cloud Infrastructure Free Tier 시작하기를 참조하십시오.
Oracle Cloud Infrastructure 인증서, 테넌시 및 구획에 대한 예제 값을 사용합니다. 실습을 완료하면 이러한 값을 클라우드 환경에 고유한 값으로 대체합니다.

DBMS_CLOUD_NOTIFICATION 패키지를 사용하여 Oracle Autonomous Database에서 전자메일 전송

소개

Oracle Autonomous Database는 탄력적으로 스케일링되고 빠른 쿼리 성능을 제공하는 사용하기 쉽고 완전히 자율적인 데이터베이스를 제공합니다. 서비스로서 Autonomous Database에는 데이터베이스 관리가 필요하지 않습니다.

Oracle Autonomous Database는 DBMS_CLOUD_NOTIFICATION 패키지를 지원하여 메시지 및 쿼리 결과를 이메일로 전송합니다. 이 패키지는 공용 SMTP 끝점으로만 전자메일 전송을 지원합니다.

참고: 현재 지원되는 유일한 이메일 제공자는 Oracle Cloud Infrastructure(OCI) Email Delivery 서비스입니다.

목표

DBMS_CLOUD_NOTIFICATION 패키지를 사용하여 Oracle Autonomous Database에서 전자메일로 질의 메시지 및 출력을 전송합니다.

필요 조건

Oracle Cloud 계정에 로그인합니다.
구획에 ADB-S(Autonomous Database)를 생성합니다.

작업 1: SMTP 연결 식별 및 구성

탐색 메뉴를 열고 개발자 서비스를 누릅니다. 애플리케이션 통합 아래의 전자메일 전송을 누릅니다.
리소스 메뉴에서 구성을 누릅니다.
- 공용 끝점: 이 영역에서 전자메일을 보내는 데 사용되는 공용 끝점입니다.
- SMTP Ports: 전자 메일을 받는 데 사용되는 SMTP 포트입니다. 이메일 딜리버리는 포트 25 또는 587에서 TLS를 지원합니다.
- 보안: 이 필드는 전자 메일 전송 중 암호화를 수행하는 표준 수단인 TLS가 사용되는지 여부를 나타냅니다. 고객은 Oracle Cloud Infrastructure Email Delivery 서비스로 전송되는 동안 이메일을 암호화해야 합니다. 암호화된 이메일은 전송 중에 읽지 않도록 보호됩니다.

태스크 2: 전자메일 전달을 위한 SMTP 인증서 생성

사용자 세부정보를 확인합니다.
- 자신에 대한 SMTP 자격 증명을 생성하는 경우 프로파일 메뉴를 열고 사용자 설정 또는 계정 이름을 누릅니다.
- 다른 사용자에 대한 SMTP 자격 증명을 생성하는 관리자인 경우 탐색 메뉴를 열고 ID 및 보안을 누릅니다. ID에서 사용자를 누릅니다. 목록에서 사용자를 찾은 다음 사용자 이름을 눌러 세부정보를 확인합니다.
SMTP 인증서를 누릅니다.
SMTP 인증서 생성을 누릅니다.
대화 상자에 SMTP 자격 증명의 Description을 입력합니다.
SMTP 인증서 생성을 누릅니다. 아래와 같은 사용자 이름과 암호가 표시됩니다.

태스크 3: 전자메일 전달을 위해 승인된 발신자 생성

이메일 딜리버리에 사용할 보낸 사람 이메일 주소를 등록합니다.

탐색 메뉴를 열고 개발자 서비스를 누릅니다. 애플리케이션 통합 아래의 전자메일 전송을 누릅니다. 전자메일 전송에서 승인된 발신자를 누릅니다. 올바른 구획에 있는지 확인합니다. 사용자는 이 구획의 승인된 보낸 사람을 관리할 권한이 있는 그룹에 속해 있어야 합니다.
승인된 발신자 페이지에서 승인된 발신자를 누릅니다.
승인된 발신자 생성 대화상자에서 다음 정보를 제공합니다.
- 승인된 발신자로 나열할 전자메일 주소를 입력합니다.
- (선택사항) 리소스를 구성할 태그를 추가합니다. 정의된 태그를 적용하려면 태그 이름 공간을 사용할 권한이 있어야 합니다. 태그 설정에 대한 자세한 내용은 리소스 태그를 참조하십시오. 태그를 적용할지 여부가 확실하지 않으면 이 옵션을 건너뛰거나(나중에 태그 적용 가능) 관리자에게 문의하십시오.
승인된 발신자 생성을 누릅니다.
전자 우편 주소가 [승인된 발신자] 리스트에 추가됩니다.

주:

이 예에서는 test.com을 샘플 발신자로 사용합니다. 하지만 이를 구성하여 조직의 도메인에서 전자메일을 보낼 때는 OCI Email Delivery에 적합한 전자메일 보안 구성이 설정되었는지 확인해야 합니다.

OCI Email Delivery용 SPF 및 DKIM 구성에 대한 자세한 내용은 여기(SPF용) 및 여기(DKIM용)에서 확인할 수 있습니다.

작업 4: Oracle Autonomous Database에서 전자메일로 메시지 전송

Oracle Autonomous Database 프로비전: 세부정보 페이지로 이동하고 데이터베이스 작업을 누릅니다. Database Actions에 대한 사인인 페이지가 열립니다. 데이터베이스 인스턴스의 기본 관리자 계정 사용자 이름 - 관리자를 사용하고 다음을 누릅니다. Database Actions 페이지가 열립니다. 개발 상자에서 SQL을 누릅니다.

인증서 객체를 생성하고 DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE을 사용하여 메시지를 전자메일로 전송합니다. 아래의 코드 조각을 복사하여 SQL Worksheet에 붙여넣습니다.

BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
        credential_name => 'test',
        username        => 'username',
        password        => '************'
   );
   END;
/
BEGIN
   DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE(
        provider        => 'email',
        credential_name => 'test',
        message         => 'This message is to confirm that you have received an email from Autonomous Database',
        params          => json_object('recipient' value  '************',
                                       'to_cc'  value '************',
                                       'to_bcc' value ‘************’,
                                       'subject' value 'Test email',
                                       'smtp_host' value 'smtp.email.us-phoenix-1.oci.oraclecloud.com',
                                       'sender'    value  'send.email@test.com' )
   );
   END;
/

params 매개변수를 사용하여 string 값에 CC 또는 BCC의 발신자, smtp_host, 제목, 수신자 및 수신자를 지정합니다.

sender: 승인된 보낸 사람의 전자 메일 ID
smtp_host: SMTP 호스트 이름
subject: 전자메일 제목입니다.
recipient: 수신자의 전자 메일 ID
to_cc: 전자메일의 CC를 수신하는 전자메일 ID
to_bcc: 전자메일의 숨은 참조를 수신하는 전자메일 ID

명령문 실행 버튼을 눌러 SQL Worksheet에서 실행해야 합니다.

절차가 성공적으로 완료되면 이메일을 받게 됩니다.

전자메일 메시지

작업 5: Oracle Autonomous Database에서 전자메일로 질의 결과 전송

DBMS_CLOUD_NOTIFICATION 패키지를 사용하여 질의 결과를 전자메일로 보낼 수 있습니다. 예를 들어, DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE를 사용하여 질의 출력이 포함된 메시지 SELECT tablespace_name FROM dba_tablespaces;를 전자메일로 보냅니다. 아래의 코드 조각을 복사하여 SQL Worksheet에 붙여넣습니다.

BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
        credential_name => 'test',
        username        => ‘username’
        password        => '************'
   );
   END;
/
BEGIN
   DBMS_CLOUD_NOTIFICATION.SEND_DATA(
        provider        => 'email',
        credential_name => 'test',
        query           => 'SELECT tablespace_name FROM dba_tablespaces',
        params          => json_object('recipient' value  '************',
                                       'to_cc'  value '****************',
                                       'to_bcc' value '****************',
                                       'subject' value 'Tablespace Report',
                                       'type' value 'json',
                                       'title' value 'Tablespace report',
                                       'message' value 'Here is the tablespace report',
                                       'smtp_host' value 'smtp.email.us-phoenix-1.oci.oraclecloud.com',
                                       'sender'    value  'send.email@test.com' )
   );
   END;
/

명령문 실행 버튼을 눌러 SQL Worksheet에서 실행해야 합니다.

절차가 성공적으로 완료되면 이메일을 받게 됩니다.

전자메일 질의

다음 단계

DBMS_CLOUD_NOTIFICATION 패키지는 이제 Oracle Autonomous Database에서 지원되며 이 패키지를 사용하여 이메일을 보내는 방법을 보았습니다. 이메일 딜리버리 또는 Oracle Autonomous Database의 DBMS_CLOUD_NOTIFICATION에 대해 자세히 알아보려면 Oracle Autonomous Database 문서를 참조하십시오.

수락

작성자 - Priya Dhuriya(Senior Solution Engineer)

추가 학습 자원

docs.oracle.com/learn에서 다른 실습을 살펴보거나 Oracle Learning YouTube 채널에서 더 많은 무료 학습 콘텐츠에 액세스하십시오. 또한 Oracle Learning Explorer가 되려면 education.oracle.com/learning-explorer를 방문하십시오.

제품 설명서는 Oracle Help Center를 참조하십시오.

제목 및 저작권 정보

Use the DBMS_CLOUD_NOTIFICATION package to send an email from Oracle Autonomous Database

F85877-01

August 2023