Hinweis:

Verwenden Sie das Package DBMS_CLOUD_NOTIFICATION, um eine E-Mail von Oracle Autonomous Database zu senden

Einführung

Mit Oracle Autonomous Database erhalten Sie eine benutzerfreundliche, vollständig autonome Datenbank, die elastisch skalierbar ist und schnelle Abfrageperformance liefert. Da Autonomous Database als Service bereitgestellt wird, ist keine Datenbankadministration erforderlich.

Oracle Autonomous Database unterstützt das Package DBMS_CLOUD_NOTIFICATION, um Nachrichten und Abfrageergebnisse als E-Mail zu senden. Dieses Package unterstützt das Senden von E-Mails nur an öffentliche SMTP-Endpunkte.

Hinweis: Aktuell wird nur der Oracle Cloud Infrastructure (OCI) Email Delivery-Service als E-Mail-Provider unterstützt.

Ziele

So senden Sie Nachrichten und die Ausgabe einer Abfrage als E-Mail von Oracle Autonomous Database mit dem Package DBMS_CLOUD_NOTIFICATION.

Voraussetzungen

Aufgabe 1: SMTP-Verbindung identifizieren und konfigurieren

  1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Entwicklerservices. Klicken Sie unter Anwendungsintegration auf E-Mail-Versand.

  2. Klicken Sie im Menü Ressourcen auf Konfiguration.

    Konfiguration

    • Public Endpoint: Der öffentliche Endpunkt, der zum Senden einer E-Mail für diese Region verwendet wird.

    • SMTP-Ports: Die SMTP-Ports, die E-Mails annehmen. Email Delivery unterstützt TLS auf Port 25 oder 587.

    • Sicherheit: Dieses Feld gibt an, ob TLS, die Standardverschlüsselung für die Übertragung von E-Mails, verwendet wird. Kunden müssen E-Mails verschlüsseln, während sie an den Oracle Cloud Infrastructure Email Delivery-Service übertragen werden. Verschlüsselte E-Mails können während der Übertragung nicht gelesen werden.

Aufgabe 2: SMTP-Zugangsdaten für Email Delivery generieren

  1. Benutzerdetails anzeigen:

    • Wenn Sie SMTP-Zugangsdaten für sich selbst generieren: Öffnen Sie das Menü Profil, und klicken Sie auf Benutzereinstellungen oder Ihren Accountnamen.
    • Wenn Sie als Administrator SMTP-Zugangsdaten für einen anderen Benutzer generieren: Öffnen Sie das Navigationsmenü, und klicken Sie auf Identität und Sicherheit. Klicken Sie unter Identität auf Benutzer. Suchen Sie den Benutzer in der Liste, und klicken Sie dann auf den Benutzernamen, um die Details anzuzeigen.

  2. Klicken Sie auf SMTP-Zugangsdaten.

  3. Klicken Sie auf SMTP-Zugangsdaten generieren.

  4. Geben Sie eine Beschreibung der SMTP-Zugangsdaten in das Dialogfeld ein.

  5. Klicken Sie auf SMTP-Zugangsdaten generieren. Ein Benutzername und ein Kennwort wie unten angezeigt werden.

    Zugangsdaten

Aufgabe 3: Genehmigten Absender für Email Delivery erstellen

Registrieren Sie eine Absender-E-Mail-Adresse, die für die E-Mail-Zustellung verwendet werden soll.

  1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Entwicklerservices. Klicken Sie unter Anwendungsintegration auf E-Mail-Versand. Klicken Sie unter E-Mail-Versand auf Genehmigte Absender. Stellen Sie sicher, dass Sie sich im korrekten Compartment befinden. Ihr Benutzer muss zu einer Gruppe gehören, die berechtigt ist, genehmigte Absender in diesem Compartment zu verwalten.

  2. Klicken Sie auf der Seite Genehmigte Absender auf Genehmigter Absender.

  3. Geben Sie im Dialogfeld Genehmigten Absender erstellen die folgenden Informationen an:

    • Geben Sie die E-Mail-Adresse ein, die Sie als genehmigter Absender listen möchten.
    • (Optional) Fügen Sie Tags hinzu, um Ihre Ressource zu organisieren. Um ein definiertes Tag zuzuweisen, benötigen Sie die Berechtigungen zum Verwenden des Tag-Namespace. Weitere Informationen zum Tagging finden Sie unter "Ressourcentags". Wenn Sie nicht sicher sind, ob Sie Tags anwenden sollten, überspringen Sie diese Option, oder fragen Sie Ihren Administrator. Sie können die Tags auch später noch anwenden.

  4. Klicken Sie auf Genehmigten Absender erstellen.

  5. Die E-Mail-Adresse wird der Liste genehmigter Absender hinzugefügt.

    Absender

Hinweis:

Aufgabe 4: Nachrichten als E-Mail von Oracle Autonomous Database senden

  1. Oracle Autonomous Database bereitstellen: Gehen Sie zur Seite "Details", und klicken Sie auf Database Actions. Eine Anmeldeseite wird für Database Actions geöffnet. Verwenden Sie den Standardadministratoraccount der Datenbankinstanz, Benutzername - Admin, und klicken Sie auf Weiter. Die Seite "Datenbankaktionen" wird geöffnet. Klicken Sie im Feld Entwicklung auf SQL.

    DB-Aktionen

  2. Erstellen Sie ein Zugangsdatenobjekt, und senden Sie eine Nachricht mit DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE als E-Mail. Kopieren Sie das Code-Snippet unten, und fügen Sie es in Ihr SQL Worksheet ein.

    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;
/

    Geben Sie mit dem Parameter params den Absender, smtp_host, Betreff, Empfänger und Empfänger einer CC oder BCC in string-Werten an.

    • Absender: E-Mail-ID des genehmigten Absenders
    • smtp_host: SMTP-Hostname
    • Thema: Betreff der E-Mail
    • Empfänger: E-Mail-IDs der Empfänger
    • to_cc: E-Mail-IDs, die einen CC der E-Mail erhalten
    • to_bcc: E-Mail-IDs, die einen BCC der E-Mail erhalten

  3. Stellen Sie sicher, dass Sie auf die Schaltfläche Run Statement klicken, um den Befehl im SQL Worksheet auszuführen.

    Nachricht senden

Sobald die Prozedur erfolgreich abgeschlossen wurde, erhalten Sie die E-Mail.

E-Mail-Nachricht

Aufgabe 5: Abfrageergebnisse als E-Mail von Oracle Autonomous Database senden

  1. Mit dem Package DBMS_CLOUD_NOTIFICATION können Sie die Ergebnisse einer Abfrage als E-Mail senden. Beispiel: Verwenden Sie DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE, um eine Nachricht mit der Ausgabe der Abfrage SELECT tablespace_name FROM dba_tablespaces; als E-Mail zu senden. Kopieren Sie das Code-Snippet unten, und fügen Sie es in Ihr SQL Worksheet ein.

    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;
/

  2. Stellen Sie sicher, dass Sie auf die Schaltfläche Run Statement klicken, um den Befehl im SQL Worksheet auszuführen.

    Daten senden

Sobald die Prozedur erfolgreich abgeschlossen wurde, erhalten Sie die E-Mail.

E-Mail abfragen

Nächste Schritte

Das Package DBMS_CLOUD_NOTIFICATION wird jetzt in Oracle Autonomous Database unterstützt. Wir haben gerade erfahren, wie Sie mit diesem Package eine E-Mail senden. Weitere Informationen zu Email Delivery oder DBMS_CLOUD_NOTIFICATION in Oracle Autonomous Database finden Sie in der Dokumentation zu Oracle Autonomous Database.

Danksagungen

Weitere Lernressourcen

Sehen Sie sich andere Übungen zu docs.oracle.com/learn an, oder greifen Sie auf weitere kostenlose Lerninhalte im Oracle Learning YouTube-Kanal zu. Besuchen Sie außerdem die Website education.oracle.com/learning-explorer, um Oracle Learning Explorer zu werden.

Produktdokumentation finden Sie im Oracle Help Center.