Ensemble DBMS_CLOUD_NOTIFICATION

L'ensemble DBMS_CLOUD_NOTIFICATION vous permet d'envoyer des messages ou la sortie d'une interrogation SQL à un fournisseur.

Conditions requises

Une connectivité sortante doit avoir été configurée à l'aide d'une passerelle NAT par l'administrateur de votre parc, comme décrit ci-dessous :
  • Créez une passerelle NAT dans le réseau en nuage virtuel (VCN) où résident vos ressources Autonomous Database en suivant les instructions sous Créer une passerelle NAT dans la documentation sur Oracle Cloud Infrastructure.
  • Après avoir créé la passerelle NAT, ajoutez une règle de routage et une règle de sécurité de trafic sortant à chaque sous-réseau (dans le VCN) où résident des ressources Autonomous Database afin que ces ressources puissent utiliser la passerelle pour obtenir une clé publique de votre instance Azure AD :
    1. Allez à la page Détails du sous-réseau correspondante.
    2. Dans l'onglet Informations sur le sous-réseau, cliquez sur le nom de la table de routage du sous-réseau pour afficher la page Détails de la table de routage.
    3. Dans la table des règles de routage existantes, vérifiez s'il existe déjà une règle présentant les caractéristiques suivantes :
      • Destination : 0.0.0.0/0
      • Type de cible : Passerelle NAT
      • Target : Nom de la passerelle NAT que vous venez de créer dans le VCN

      Si une telle règle n'existe pas, cliquez sur Ajouter des règles de routage et ajoutez une règle de routage avec ces caractéristiques.

    4. Retournez à la page Détails du sous-réseau.
    5. Dans la table Listes de sécurité du sous-réseau, cliquez sur le nom de la liste de sécurité du sous-réseau pour afficher la page Détails de la liste de sécurité.
    6. Dans le menu latéral, sous Ressources, cliquez sur Règles de trafic sortant.
    7. Dans la table des règles de trafic sortant existantes, vérifiez s'il existe déjà une règle présentant les caractéristiques suivantes :
      • Type de destination : CIDR
      • Destination : 0.0.0.0/0
      • Protocole IP : TCP
      • Intervalle de ports sources : 443
      • Intervalle de ports de destination : Tout

      Si une telle règle n'existe pas, cliquez sur Ajouter des règles de trafic sortant et ajoutez une règle de trafic sortant avec ces caractéristiques.

Les paramètres de mandataire HTTP de votre environnement doivent permettre à la base de données d'accéder au fournisseur de services en nuage.

Ces paramètres sont définis par l'administrateur de votre parc lors de la création de l'infrastructure Exadata Cloud@Customer, comme décrit dans Utilisation de la console pour provisionner le service Exadata Database sur Cloud@Customer.

Note :

La configuration réseau, y compris le mandataire HTTP, ne peut être modifiée que jusqu'à ce que l'infrastructure Exadata ait l'état Activation requise. Une fois activé, vous ne pouvez pas modifier ces paramètres.

La configuration d'un mandataire HTTP pour une infrastructure Exadata déjà provisionnée nécessite une demande de service dans My Oracle Support. Pour plus de détails, voir Créer une demande de service dans My Oracle Support.

Sommaire des sous-programmes DBMS_CLOUD_NOTIFICATION

Ce tableau résume les sous-programmes inclus dans le package.

Sous-programme Description

Procédure SEND_DATA

Envoyer la sortie d'interrogation SQL à un fournisseur.

Procédure SEND_MESSAGE

Envoyer un message texte à un fournisseur.

Procédure SEND_DATA

La procédure SEND_DATA envoie les résultats de l'interrogation spécifiée à un fournisseur.

Syntaxe

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

Paramètres

Paramètre Description

provider

Spécifie le fournisseur.

Les valeurs valides sont les suivantes : 'email', 'msteams' et 'slack'

Ce paramètre est obligatoire.

credential_name

Nom de l'objet de données d'identification permettant d'accéder au fournisseur.

Pour le fournisseur de courriel, les données d'identification sont le nom des données d'identification de l'expéditeur approuvé SMTP qui contient son nom d'utilisateur et son mot de passe.

Pour le fournisseur msteams, les données d'identification sont le nom des données d'identification.

Pour le fournisseur Slack, le nom d'utilisateur des données d'identification doit être "SLACK_TOKEN" et password, le jeton de robot Slack.

Ce paramètre est obligatoire.

query

Indique l'interrogation SQL à exécuter. Les résultats sont envoyés au fournisseur.

Ce paramètre est obligatoire.

params

Spécifie des paramètres spécifiques pour provider au format JSON.

Pour le type de fournisseur email, les paramètres valides sont les suivants :

  • sender. Indique l'ID courriel de l'expéditeur approuvé dans une valeur String.
  • smtp_host. Indique le nom d'hôte SMTP dans une valeur String.
  • subject. Indique l'objet du courriel dans une valeur String. La taille maximale est de 100 caractères.
  • recipient. Indique les ID courriel des destinataires dans une valeur String. Utilisez une virgule entre les ID courriel lorsqu'il y a plusieurs destinataires.
  • to_cc. Indique les ID courriel qui reçoivent une carte de crédit du courriel. Il s'agit d'une valeur String. Utilisez une virgule entre les ID courriel lorsqu'il y a plusieurs destinataires en CC.
  • to_bcc. Indique les codes de courriel qui reçoivent un Cci du courriel. Il s'agit d'une valeur String. Utilisez une virgule entre les ID courriel lorsqu'il y a plusieurs destinataires en Cci.
  • message. Indique le texte du message dans une valeur String.
  • type. Indique le format de sortie dans une valeur String au format CSV ou JSON.
  • title. Indique le titre du fichier joint de sortie SQL dans une valeur String. Le titre ne doit contenir que des lettres, des chiffres, des traits de soulignement, des tirets ou des points en tant que caractères dans sa valeur, car il est utilisé pour générer un nom de fichier.

Pour le type de fournisseur msteams, les paramètres valides sont les suivants :

  • tenant. Indique l'ID locataire dans un format String.
  • team. Indique l'ID équipe dans le format String.
  • channel. Indique l'ID canal dans un format String.
  • title. Indique le titre du fichier dans le format String. La taille maximale est de 50 caractères.
  • type. Indique le format de sortie dans une valeur String. Les valeurs valides sont CSV ou JSON.

Pour le type de fournisseur slack, les paramètres valides sont les suivants :

  • channel. Indique l'ID canal dans une valeur String. L'ID canal est un ID unique pour un canal et est différent du nom du canal. Dans Slack, lorsque vous consultez les détails du canal, vous pouvez trouver l'ID du canal dans l'onglet "À propos".
  • type. Indique le format de sortie dans une valeur String. Les valeurs valides sont CSV ou JSON.

Ce paramètre est obligatoire.

Notes d'utilisation

Utilisez la procédure DBMS_CLOUD.CREATE_CREDENTIAL(credential_name, username, password) pour créer l'objet de données d'identification. Pour plus d'informations, voir Procédure CREATE_CREDENTIAL.

  • Pour le fournisseur email, l'utilisateur nécessite un point d'extrémité de connexion SMTP pour que le serveur de transmission de messages obtienne smtp_host. L'utilisateur a également besoin d'un expéditeur approuvé SMTP et de ses données d'identification pour s'authentifier auprès du serveur de transmission de messages afin d'obtenir credential_name. La connexion SMTP doit être configurée et les données d'identification SMTP doivent être générées et approuvées.
  • Pour le fournisseur msteams, l'utilisateur nécessite l'application Microsoft Teams et un robot configuré dans celle-ci. L'application doit être publiée dans l'organisation et installée après avoir obtenu l'approbation de l'administrateur du centre d'administration. L'utilisateur doit également avoir accès aux autorisations Files.ReadWrite.All et ChannelSettings.Read.All pour l'API Graph à partir de son portail Azure. Pour générer le jeton requis, l'utilisateur requiert bot_id dans le nom d'utilisateur et bot_secret dans le mot de passe. La taille de fichier maximale prise en charge lors de l'utilisation de DBMS_CLOUD_NOTIFICATION.SEND_DATA pour Microsoft Teams est de 4 Mo.
  • Pour le fournisseur slack, la valeur username peut être toute chaîne valide et password est le jeton de robot Slack.

Exemple

Envoyer une sortie SQL avec le fournisseur email :

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

Envoyer une sortie SQL avec le fournisseur msteams :

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

Envoyer une sortie SQL avec le fournisseur slack :

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

Procédure SEND_MESSAGE

La procédure envoie un message texte à un fournisseur.

Syntaxe

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

Paramètres

Paramètre Description

provider

Spécifie le fournisseur.

Les valeurs valides sont les suivantes : 'email', 'msteams' et 'slack'

Ce paramètre est obligatoire.

credential_name

Nom de l'objet de données d'identification permettant d'accéder au fournisseur.

Pour le fournisseur de courriel, les données d'identification sont le nom des données d'identification de l'expéditeur approuvé SMTP qui contient son nom d'utilisateur et son mot de passe.

Pour le fournisseur msteams, les données d'identification doivent contenir la clé bot_id et bot_secret dans le nom d'utilisateur et le mot de passe.

Pour le fournisseur Slack, le nom d'utilisateur des données d'identification doit être "SLACK_TOKEN" et password, le jeton de robot Slack.

Ce paramètre est obligatoire.

message

Indique le texte du message.

Ce paramètre est obligatoire.

params

Spécifie des paramètres spécifiques pour provider au format JSON.

Pour le type de fournisseur email, les paramètres valides sont les suivants :
  • sender. Indique l'ID courriel de l'expéditeur approuvé dans une valeur String.
  • smtp_host. Indique le nom d'hôte SMTP dans une valeur String.
  • subject. Indique l'objet du courriel dans une valeur String. La taille maximale est de 100 caractères.
  • recipient. Indique les ID courriel des destinataires dans une valeur String. Utilisez une virgule entre les ID courriel lorsqu'il y a plusieurs destinataires.
  • to_cc. Indique les ID courriel qui reçoivent une carte de crédit du courriel. Utilisez une virgule entre les ID courriel lorsqu'il y a plusieurs destinataires en CC.
  • to_bcc. Indique les codes de courriel qui reçoivent un Cci du courriel. Utilisez une virgule entre les ID courriel lorsqu'il y a plusieurs destinataires en Cci.
Pour le type de fournisseur msteams, le paramètre valide est :
  • channel. Indique l'ID canal dans une valeur String.
Pour le type de fournisseur slack, le paramètre valide est :
  • channel. Indique l'ID canal dans une valeur String.

L'ID canal est un ID unique pour un canal et est différent du nom du canal. Dans Slack, lorsque vous consultez les détails du canal, vous pouvez trouver l'ID du canal dans l'onglet "À propos".

Ce paramètre est obligatoire.

Notes d'utilisation

Utilisez la procédure DBMS_CLOUD.CREATE_CREDENTIAL(credential_name, username, password) pour créer l'objet de données d'identification. Pour plus d'informations, voir ProcédureCREATE_CREDENTIAL.

  • Pour le fournisseur email, l'utilisateur nécessite un point d'extrémité de connexion SMTP pour que le serveur de transmission de messages obtienne smtp_host. L'utilisateur a également besoin d'un expéditeur approuvé SMTP et de ses données d'identification pour s'authentifier auprès du serveur de transmission de messages afin d'obtenir credential_name. La connexion SMTP doit être configurée et les données d'identification SMTP doivent être générées et approuvées.
  • Pour le fournisseur msteams, l'utilisateur nécessite l'application Microsoft Teams et un robot configuré dans celle-ci. L'application doit être publiée dans l'organisation et installée après avoir obtenu l'approbation de l'administrateur du centre d'administration. L'utilisateur doit également avoir accès aux autorisations Files.ReadWrite.All et ChannelSettings.Read.All pour l'API Graph à partir de son portail Azure. Pour générer le jeton requis, l'utilisateur requiert bot_id dans le nom d'utilisateur et bot_secret dans le mot de passe.
  • Pour le fournisseur slack, la valeur username peut être toute chaîne valide et password est le jeton de robot Slack.

Exemples

Envoyez un message texte avec le fournisseur email :

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

Envoyer un message texte au fournisseur msteams :

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

Envoyer un message texte au fournisseur slack :

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 Database.',
      params            => json_object('channel' value 'C0....08'));
END;
/