DBMS_CLOUD_NOTIFICATION-Package

Mit dem Package DBMS_CLOUD_NOTIFICATION können Sie Nachrichten oder die Ausgabe einer SQL-Abfrage an einen Provider senden.

Die unterstützten Provider mit DBMS_CLOUD_NOTIFICATION sind: E-Mail, Microsoft Teams, OCI Notifications (ONS) und Slack.

Wenn Sie den OCI Notifications-Service mit dem Package DBMS_CLOUD_NOTIFICATION verwenden, wird nur die Prozedur DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE unterstützt (die Prozedur DBMS_CLOUD_NOTIFICATION.SEND_DATA wird nicht unterstützt).

Voraussetzungen

Oracle Public Cloud oder Multicloud
Exadata Cloud@Customer

Eine ausgehende Konnektivität muss von Ihrem Flottenadministrator mit einem NAT-Gateway konfiguriert worden sein, wie unten beschrieben:

Sie können ein NAT-Gateway im virtuellen Cloud-Netzwerk (VCN) erstellen, in das sich Ihre autonomen KI-Datenbankressourcen befinden, indem Sie die Anweisungen in der Dokumentation zu Oracle Cloud Infrastructure unter NAT-Gateway erstellen befolgen.
Fügen Sie nach dem Erstellen des NAT-Gateways eine Routingregel und eine Egress-Sicherheitsregel zu jedem Subnetz (im VCN) hinzu, in dem sich autonome KI-Datenbankressourcen befinden. Damit können diese Ressourcen über das Gateway einen öffentlichen Schlüssel von Ihrer Azure AD-Instanz abrufen:
1. Gehen Sie zur Seite Subnetzdetails für das Subnetz.
2. Klicken Sie auf der Registerkarte Informationen zum Subnetz auf den Namen der Routentabelle des Subnetzes, um die Seite Routentabellendetails anzuzeigen.
3. Prüfen Sie in der Tabelle der vorhandenen Routingregeln, ob bereits eine Regel mit den folgenden Eigenschaften vorhanden ist:
  - Zielort: 0.0.0.0/0
  - Zieltyp: NAT-Gateway
  - Ziel: Der Name des NAT-Gateway, das Sie gerade im VCN erstellt haben
  Wenn keine solche Regel vorhanden ist, klicken Sie auf Routenregeln hinzufügen, und fügen Sie eine Routingregel mit diesen Eigenschaften hinzu.
4. Zurück zur Seite Subnetzdetails für das Subnetz.
5. Klicken Sie in der Tabelle Sicherheitslisten des Subnetzes auf den Namen der Sicherheitsliste des Subnetzes, um die Seite Sicherheitslistendetails anzuzeigen.
6. Klicken Sie im Seitenmenü unter Ressourcen auf Egress-Regeln.
7. Prüfen Sie in der Tabelle der vorhandenen Ausgangsregeln, ob bereits eine Regel mit den folgenden Eigenschaften vorhanden ist:
  - Zieltyp: CIDR
  - Zielort: 0.0.0.0/0
  - IP-Protokoll: TCP
  - Quellportbereich: 443
  - Ziel-Portbereich: Alle
  Wenn keine derartige Regel vorhanden ist, klicken Sie auf Egress-Regeln hinzufügen, und fügen Sie eine Egress-Regel mit diesen Eigenschaften hinzu.

Die HTTP-Proxyeinstellungen in Ihrer Umgebung müssen es der Datenbank ermöglichen, auf den Cloud-Serviceprovider zuzugreifen.

Diese Einstellungen werden vom Flottenadministrator beim Erstellen der Exadata Cloud@Customer-Infrastruktur definiert, wie unter Exadata Database Service on Cloud@Customer mit der Konsole bereitstellen beschrieben.

Hinweis:

Die Netzwerkkonfiguration einschließlich des HTTP-Proxys kann nur bearbeitet werden, bis sich die Exadata-Infrastruktur im Status Aktivierung erforderlich befindet. Sobald sie aktiviert ist, können Sie diese Einstellungen nicht mehr bearbeiten.

Für die Einrichtung eines HTTP-Proxys für eine bereits bereitgestellte Exadata-Infrastruktur ist eine Serviceanfrage (SR) in My Oracle Support erforderlich. Weitere Informationen finden Sie unter Serviceanfrage in My Oracle Support erstellen.

Zusammenfassung der DBMS_CLOUD_NOTIFICATION-Unterprogramme

In dieser Tabelle werden die im Package enthaltenen Unterprogramme zusammengefasst.

Unterprogramm	Beschreibung
Prozedur SEND_DATA	Ausgabe der SQL-Abfrage an einen Provider senden
Prozedur SEND_MESSAGE	Textnachricht an einen klinischen Mitarbeiter senden.

Prozedur SEND_DATA

Die Prozedur SEND_DATA sendet die Ergebnisse der angegebenen Abfrage an einen Provider.

Syntax

DBMS_CLOUD_NOTIFICATION.SEND_DATA(
       provider           IN  VARCHAR2,
       credential_name    IN  VARCHAR2,
       query              IN  CLOB,
       params             IN  CLOB
 );

Parameter

Parameter	Beschreibung
`provider`	Gibt den Provider an. Gültige Werte sind: "`email`", "`msteams`" und "`slack`" Dieser Parameter ist erforderlich.
`credential_name`	Name des Zugangsdatenobjekts für den Zugriff auf den Provider. Für den E-Mail-Provider sind die Zugangsdaten der Name der Zugangsdaten des SMTP-genehmigten Absenders, der seinen Benutzernamen und sein Kennwort enthält. Für den msteams-Provider ist der Berechtigungsnachweis der Name des Berechtigungsnachweises. Für den Slack-Provider muss der Benutzername der Zugangsdaten `"SLACK_TOKEN"` und `password` das Slack-Bottoken sein. Dieser Parameter ist erforderlich.
`query`	Gibt die auszuführende SQL-Abfrage an. Ergebnisse werden an den klinischen Mitarbeiter gesendet. Dieser Parameter ist erforderlich.
`params`	Gibt bestimmte Parameter für `provider` im JSON-Format an. Für den Providertyp `email` sind folgende Parameter gültig: `sender`. Gibt die E-Mail-ID des genehmigten Absenders in einem `String`-Wert an. `smtp_host`. Gibt den SMTP-Hostnamen in einem `String`-Wert an. `subject`. Gibt den Betreff der E-Mail in einem `String`-Wert an. Die maximale Größe beträgt 100 Zeichen. `recipient`. Gibt die E-Mail-IDs der Empfänger in einem `String`-Wert an. Verwenden Sie ein Komma zwischen E-Mail-IDs, wenn mehrere Empfänger vorhanden sind. `to_cc`. Gibt die E-Mail-IDs an, die ein CC der E-Mail erhalten. Es handelt sich um einen `String`-Wert. Verwenden Sie ein Komma zwischen E-Mail-IDs, wenn mehrere CC-Empfänger vorhanden sind. `to_bcc`. Gibt die E-Mail-IDs an, die einen BCC der E-Mail erhalten. Es handelt sich um einen `String`-Wert. Verwenden Sie ein Komma zwischen E-Mail-IDs, wenn mehrere BCC-Empfänger vorhanden sind. `message`. Gibt den Meldungstext in einem `String`-Wert an. `type`. Gibt das Ausgabeformat in einem `String`-Wert als CSV- oder JSON-Datei an. `title`. Gibt den Titel des Anhangs der SQL-Ausgabe in einem `String`-Wert an. Der Titel darf nur Buchstaben, Ziffern, Unterstriche, Bindestriche oder Punkte als Zeichen in seinem Wert enthalten, da er zur Generierung eines Dateinamens verwendet wird. Für den Providertyp `msteams` sind folgende Parameter gültig: `tenant`. Gibt die Mandanten-ID im Format `String` an. `team`. Gibt die Team-ID im Format `String` an. `channel`. Gibt die Kanal-ID im Format `String` an. `title`. Gibt den Titel der Datei im Format `String` an. Die maximale Größe beträgt 50 Zeichen. `type`. Gibt das Ausgabeformat in einem `String`-Wert an. Gültige Werte sind CSV oder JSON. Für den Providertyp `slack` sind folgende Parameter gültig: `channel`. Gibt die Kanal-ID in einem `String`-Wert an. Die Kanal-ID ist eine eindeutige ID für einen Kanal und unterscheidet sich vom Kanalnamen. Wenn Sie in Slack Kanaldetails anzeigen, finden Sie die Kanal-ID auf der Registerkarte "Info". `type`. Gibt das Ausgabeformat in einem `String`-Wert an. Gültige Werte sind CSV oder JSON. Dieser Parameter ist erforderlich.

Verwendungshinweise

Verwenden Sie die Prozedur DBMS_CLOUD.CREATE_CREDENTIAL(credential_name, username, password), um das Zugangsdatenobjekt zu erstellen. Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL.

Für den email-Provider benötigt der Benutzer einen SMTP-Verbindungsendpunkt für den Email Delivery-Server, um smtp_host abzurufen. Der Benutzer benötigt außerdem einen SMTP-genehmigten Absender und seine Zugangsdaten, um sich beim Email Delivery-Server zu authentifizieren und die credential_name abzurufen. SMTP-Verbindung muss konfiguriert sein, und SMTP-Zugangsdaten müssen generiert und genehmigt werden.
Für den msteams-Provider erfordert der Benutzer die Microsoft Teams-App und einen darin konfigurierten Bot. Die App muss in der Organisation veröffentlicht und installiert werden, nachdem die Genehmigung vom Admin-Center eingeholt wurde. Der Benutzer benötigt auch Zugriff auf die Berechtigungen Files.ReadWrite.All und ChannelSettings.Read.All für die Diagramm-API über sein Azure-Portal. Um das erforderliche Token zu generieren, benötigt der Benutzer bot_id im Benutzernamen und bot_secret im Kennwort. Die maximale Dateigröße, die bei der Verwendung von DBMS_CLOUD_NOTIFICATION.SEND_DATA für Microsoft Teams unterstützt wird, beträgt 4 MB.
Für den slack-Provider kann der Wert username eine beliebige gültige Zeichenfolge sein, und password ist das Slack-Bottoken.

Beispiel

SQL-Ausgabe mit dem email-Provider senden:

BEGIN
    DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'EMAIL_CRED',
    username        => 'username',
    password        => 'password');
END;
/

BEGIN
   DBMS_CLOUD_NOTIFICATION.SEND_DATA(
        provider        => 'email',
        credential_name => 'EMAIL_CRED',
        query           => 'SELECT tablespace_name FROM dba_tablespaces',
        params          => json_object('recipient' value  'mark@oracle.com, suresh@oracle.com',
                                       'to_cc'  value 'nicole@oracle.com1, jordan@oracle.com',
                                       'to_bcc' value 'manisha@oracle.com',
                                       'subject' value 'Test subject',
                                       'type' value 'json',
                                       'title' value 'mytitle',
                                       'message' value 'This is the message',
                                       'smtp_host' value 'smtp.email.example.com',
                                       'sender'    value  'approver_sender@oracle.com' )
   );
   END;
/

SQL-Ausgabe mit dem msteams-Provider senden:

BEGIN     
    DBMS_CLOUD.CREATE_CREDENTIAL(credential_name => 'TEAMS_CRED',       
        username        => 'bot_id', 
        password        => 'bot_secret');
END;
/

BEGIN
     DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE(provider => 'msteams',
        credential_name => 'TEAMS_CRED',
        query           => 'SELECT tablespace_name FROM dba_tablespaces',
        params          => json_object('tenant'value '5b743bc******c0286',
                                       'team'value '0ae401*********5d2bd',
                                       'channel'value '19%3a94be023*****%40thread.tacv2',
                                       'title'value 'today',
                                       'type'value 'csv'));
END;
/

SQL-Ausgabe mit dem slack-Provider senden:

BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'SLACK_CRED',
     username        => 'SLACK_TOKEN',
     password        => 'password');
END;
/
BEGIN
  DBMS_CLOUD_NOTIFICATION.SEND_DATA(
      provider        => 'slack',
      credential_name => 'SLACK_CRED',
      query           => 'SELECT username, account_status, expiry_date FROM USER_USERS WHERE rownum < 5',
      params          => json_object('channel' value 'C0....08','type' value 'csv'));
END;
/

Prozedur SEND_MESSAGE

Das Verfahren sendet eine Textnachricht an einen klinischen Mitarbeiter.

Syntax

DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE(
       provider           IN  VARCHAR2,
       credential_name    IN  VARCHAR2,
       message            IN  CLOB,
       params             IN  CLOB
 );

Parameter

Parameter	Beschreibung
`provider`	Gibt den Provider an. Gültige Werte sind: '`email`', '`msteams`', '`slack`' und '`oci`'. Dieser Parameter ist erforderlich.
`credential_name`	Name des Zugangsdatenobjekts für den Zugriff auf den Provider. Für den E-Mail-Provider sind die Zugangsdaten der Name der Zugangsdaten des SMTP-genehmigten Absenders, der seinen Benutzernamen und sein Kennwort enthält. Für den msteams-Provider müssen die Zugangsdaten den Schlüssel `bot_id` und `bot_secret` sowohl im Benutzernamen als auch im Kennwort enthalten. Für den Slack-Provider muss der Benutzername der Zugangsdaten `"SLACK_TOKEN"` und `password` das Slack-Bottoken sein. Für den `oci`-Provider sind die Zugangsdaten gültige, auf dem Oracle Cloud Infrastructure-Signaturschlüssel basierende Zugangsdaten. Dieser Parameter ist erforderlich.
`message`	Gibt den Meldungstext an. Dieser Parameter ist erforderlich.
`params`	Gibt bestimmte Parameter für `provider` im JSON-Format an. Für den Providertyp `email` sind folgende Parameter gültig: `sender`. Gibt die E-Mail-ID des genehmigten Absenders in einem `String`-Wert an. `smtp_host`. Gibt den SMTP-Hostnamen in einem `String`-Wert an. `subject`. Gibt den Betreff der E-Mail in einem `String`-Wert an. Die maximale Größe beträgt 100 Zeichen. `recipient`. Gibt die E-Mail-IDs der Empfänger in einem `String`-Wert an. Verwenden Sie ein Komma zwischen E-Mail-IDs, wenn mehrere Empfänger vorhanden sind. `to_cc`. Gibt die E-Mail-IDs an, die ein CC der E-Mail erhalten. Verwenden Sie ein Komma zwischen E-Mail-IDs, wenn mehrere CC-Empfänger vorhanden sind. `to_bcc`. Gibt die E-Mail-IDs an, die einen BCC der E-Mail erhalten. Verwenden Sie ein Komma zwischen E-Mail-IDs, wenn mehrere BCC-Empfänger vorhanden sind. Für den Providertyp `msteams` ist der gültige Parameter: `channel`. Gibt die Kanal-ID in einem `String`-Wert an. Für den Providertyp `slack` ist der gültige Parameter: `channel`. Gibt die Kanal-ID in einem `String`-Wert an. Für den Provider OCI Notifications mit dem Typ `oci` sind folgende Parameter gültig: `topic_ocid`: Gibt an `title`: Gibt die Betreffzeile der Nachricht an. Beim `oci`-Provider gibt es verschiedene mögliche Endpunkte für eine Nachricht, basierend auf den Abonnements. Der Parameter `title` wird für verschiedene Abonnements unterschiedlich behandelt: E-Mail: `title` gibt die Betreffzeile der Nachricht an. Slack: Der Wert `title` wird nicht verwendet. Wenn sie enthalten ist, wird der Wert ignoriert. Die Kanal-ID ist eine eindeutige ID für einen Kanal und unterscheidet sich vom Kanalnamen. Wenn Sie in Slack Kanaldetails anzeigen, finden Sie die Kanal-ID auf der Registerkarte "Info". Dieser Parameter ist erforderlich.

Verwendungshinweise

Für den email-Provider benötigt der Benutzer einen SMTP-Verbindungsendpunkt für den Email Delivery-Server, um smtp_host abzurufen. Der Benutzer benötigt außerdem einen SMTP-genehmigten Absender und seine Zugangsdaten, um sich beim Email Delivery-Server zu authentifizieren und die credential_name abzurufen. SMTP-Verbindung muss konfiguriert sein, und SMTP-Zugangsdaten müssen generiert und genehmigt werden.
Für den msteams-Provider erfordert der Benutzer die Microsoft Teams-App und einen darin konfigurierten Bot. Die App muss in der Organisation veröffentlicht und installiert werden, nachdem die Genehmigung vom Admin-Center eingeholt wurde. Der Benutzer benötigt auch Zugriff auf die Berechtigungen Files.ReadWrite.All und ChannelSettings.Read.All für die Diagramm-API über sein Azure-Portal. Um das erforderliche Token zu generieren, benötigt der Benutzer bot_id im Benutzernamen und bot_secret im Kennwort.
Für den slack-Provider kann der Wert username eine beliebige gültige Zeichenfolge sein, und password ist das Slack-Bottoken.
Die DBMS_CLOUD_NOTIFICATION unterstützt den OCI-Benachrichtigungsprovider. Einzelheiten zum OCI-Benachrichtigungsprovider finden Sie unter Überblick über Notifications.
- Um den OCI Notifications-Provider zu verwenden, müssen Sie Folgendes tun:
  - Thema erstellen. Weitere Informationen zum Erstellen von Themen finden Sie unter Themen erstellen.
  - Erstellen Sie die erforderlichen Abonnements. Weitere Informationen zum Erstellen eines Abonnements finden Sie unter Abonnement erstellen.
  - Nachdem Sie die Abonnements erstellt haben, bestätigen Sie die Abonnements. Nachrichten werden nur für bestätigte Abonnements veröffentlicht. Einzelheiten zur Bestätigung von Abonnements finden Sie unter Abonnement bestätigen.
- Die Autonomous AI Database-Instanz, die Zugangsdaten (wenn Sie Benutzerzugangsdaten verwenden) und das Abonnementthema müssen sich alle in derselben Region befinden.
- Dabei gelten die folgenden Einschränkungen.
  - Grenzwert für Nachrichtengröße: Die maximale Nachrichtengröße pro Anforderung beträgt 64 KB. Nachrichten, die diese Größe überschreiten, können nicht innerhalb einer einzigen Anforderung gesendet oder verarbeitet werden.
  - Ratenlimit für die Nachrichtenzustellung: Je nach verwendetem Protokoll gibt es unterschiedliche Ratenlimits für die Nachrichtenzustellung.
    - email-Protokoll: Das Limit beträgt 10 Nachrichten pro Minute pro Endpunkt.
    Diese Einschränkung kann sich auf die Geschwindigkeit auswirken, mit der Nachrichten übertragen und empfangen werden können.
  - Transaktionslimit pro Minute (TPM) pro Mandant: Für diesen Vorgang gibt es ein TPM-Limit von 60 pro Thema. Dieses Limit gibt die maximale Anzahl von Nachrichten pro Minute an, die für ein bestimmtes Thema verarbeitet oder verarbeitet werden können. Eine Überschreitung dieses Limits kann dazu führen, dass Nachrichten nicht langsamer verarbeitet oder verarbeitet werden.

Beispiele

Senden Sie eine Textnachricht mit dem email-Provider:

BEGIN
    DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'EMAIL_CRED',
    username        => 'username',
    password        => 'password');
END;
/

BEGIN
   DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE(
        provider        => 'email',
        credential_name => 'EMAIL_CRED',
        message         => 'Subject content',
        params          => json_object('recipient' value  'mark@oracle.com, suresh@oracle.com',
                                       'to_cc'  value 'nicole@oracle.com, jordan@oracle.com',
                                       'to_bcc' value 'manisha@oracle.com',
                                       'subject' value 'Test subject',
                                       'smtp_host' value 'smtp.email.example.com',
                                       'sender'    value  'approver_sender@oracle.com' )
   );
   END;
/

Textnachricht mit dem msteams-Provider senden:

BEGIN     
    DBMS_CLOUD.CREATE_CREDENTIAL(credential_name => 'TEAMS_CRED',       
        username        => 'bot_id', 
        password        => 'bot_secret');
END;
/

BEGIN
     DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE(
        provider        => 'msteams',
        credential_name => 'TEAMS_CRED',
        message         => 'text from new teams api',
        params          => json_object('channel'value 'C0....08'),'region'value 'india');
END;
/

Textnachricht mit dem slack-Provider senden:

BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'SLACK_CRED',
     username        => 'SLACK_TOKEN',
     password        => 'password');
END;
/
BEGIN
   DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE(
      provider          => 'slack',
      credential_name   => 'SLACK_CRED',
      message           => 'Send text from Autonomous AI Database.',
      params            => json_object('channel' value 'C0....08'));
END;
/

Senden Sie eine Textnachricht mit OCI Notifications, und geben Sie den oci-Provider ein:


BEGIN
   DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE(
      provider          => 'oci',
      credential_name  => 'OCI_CRED',
      message          => 'Text message for you.',      
      params           => json_object('topic_ocid'  value 'oci********pa',   
      'title'  value 'Title for message subject' ));
END;
/

Titel und Copyright-Informationen

Oracle und/oder verbundene Unternehmen.