Envoyer des messages au service d'avis OCI à partir d'une base de données autonome d'intelligence artificielle

Décrit comment envoyer des messages de la base de données du service d'intelligence artificielle autonome à un sujet du service d'avis pour OCI.

Les abonnements que vous configurez avec le service d'avis pour OCI déterminent les points d'extrémité d'un sujet. Les messages publiés sont envoyés à chaque abonnement à un sujet. Il existe un certain nombre de protocoles d'abonnement pris en charge, notamment : courriel, fonction et Slack. Pour plus d'informations, voir Aperçu du service d'avis.

Lorsque vous utilisez le service d'avis OCI avec l'ensemble DBMS_CLOUD_NOTIFICATION, seule la procédure DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE est prise en charge (la procédure DBMS_CLOUD_NOTIFICATION.SEND_DATA n'est pas prise en charge).

Préparer l'envoi d'avis OCI à partir d'une base de données d'intelligence artificielle autonome

Pour envoyer des avis aux sujets du service d'avis OCI, créez d'abord des sujets et des abonnements dans le service d'avis OCI.

Avant d'envoyer des messages avec le service d'avis pour OCI, effectuez les opérations suivantes :

  1. Créez un sujet d'avis OCI.

    Voir Création d'un sujet pour plus de détails sur la création d'un sujet.

  2. Créer des abonnements au service d'avis OCI.

    Voir Création d'un abonnement pour plus de détails sur la création d'un abonnement.

    Les abonnements que vous configurez déterminent les points d'extrémité d'un sujet. Les messages publiés sont envoyés à chaque abonnement à un sujet. Il existe un certain nombre de protocoles d'abonnement pris en charge, notamment : courriel, fonction et Slack.

    Pour plus d'informations, voir Aperçu du service d'avis.

  3. Après avoir créé les abonnements au service d'avis pour OCI, confirmez les abonnements.

    Vous ne pouvez publier des messages que pour les abonnements confirmés. Pour plus de détails sur la confirmation des abonnements, voir Confirmation d'un abonnement.

Envoyer des messages à un sujet d'avis OCI

Décrit les étapes d'envoi de messages à un sujet du service d'avis pour OCI.

  1. Créer un sujet et créer des abonnements.
  2. Créez un objet de données d'identification pour accéder au service d'avis OCI à partir de la base de données du service d'intelligence artificielle autonome.

    Vous pouvez utiliser les données d'identification de clé de signature Oracle Cloud Infrastructure ou les données d'identification de principal de ressource.

    • Créer des données d'identification de clé de signature Oracle Cloud Infrastructure. Exemple :

      BEGIN
         DBMS_CLOUD.CREATE_CREDENTIAL (
             credential_name => ‘OCI_KEY_CRED’,
             user_ocid       => ‘ocid1.user.oc1..aaaaaaaauq54mi7zdyfhw33ozkwuontjceel7fok5nq3bf2vwetkpqsoa’,
             tenancy_ocid    => ‘ocid1.tenancy.oc1..aabbbbbbaafcue47pqmrf4vigneebgbcmmoy5r7xvoypicjqqge32ewnrcyx2a’,
             private_key     => ‘MIIEogIBAAKCAQEAtUnxbmrekwgVac6FdWeRzoXvIpA9+0r1.....wtnNpESQQQ0QLGPD8NM//JEBg=’,
             fingerprint     => ‘f2:db:f9:18:a4:aa:fc:94:f4:f6:6c:39:96:16:aa:27’);
      END;
      /

      Pour plus d'informations, voir ProcédureCREATE_CREDENTIAL.

    • Créer des données d'identification et des politiques de principal de ressource.

      Pour plus d'informations, voir Utiliser un principal de ressource pour accéder aux ressources Oracle Cloud Infrastructure.

  3. Envoyer un message.
    • Envoyez un message à l'aide des données d'identification de la clé de signature Oracle Cloud Infrastructure :

      BEGIN
          DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE(
              provider         => 'oci',
              credential_name  => 'OCI_KEY_CRED',
              message          => 'Text message',
              params           => json_object('topic_ocid' value 'oci********pa',
                                              'title'value 'Title for message'));
      END;
      / 
    • Envoyez un message avec les données d'identification du principal de ressource :

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

    Avec le fournisseur oci, il existe différents points d'extrémité possibles pour un message, en fonction des abonnements. Le paramètre title est traité différemment pour les différents protocoles d'abonnement :

    • email : title indique la ligne d'objet du message.
    • Slack : La valeur title n'est pas utilisée. Si elle est incluse, la valeur est ignorée.

Pour plus d'informations, voir ProcédureSEND_MESSAGE.

Limites du service d'avis pour OCI

Il existe des limites lorsque vous utilisez DBMS_CLOUD_NOTIFICATION pour envoyer des messages et que vous utilisez le fournisseur oci (service d'avis OCI).

Notez les limitations suivantes :

  • Taille limite du message : La taille limite du message par demande est de 64 Ko. Les messages dépassant cette taille ne peuvent pas être envoyés ou traités dans une seule demande.
  • Limite de débit de transmission de messages : Il existe différentes limites de débit de transmission de messages en fonction du protocole utilisé.
    • Protocole email : la limite est de 10 messages par minute par point d'extrémité.

    Cette restriction peut avoir une incidence sur la vitesse à laquelle les messages peuvent être transmis et reçus.

  • Limite de transactions par minute (TPM) par location : Il existe une limite de TPM de 60 par sujet pour cette opération. Cette limite représente le nombre maximal de messages par minute pouvant être traités ou traités pour un sujet donné. Si cette limite est dépassée, les messages risquent de ne pas être traités ou traités à un rythme plus lent.
  • L'instance de base de données de l'IA autonome, les données d'identification, si vous utilisez des données d'identification d'utilisateur et le sujet d'abonnement doivent tous se trouver dans la même région.

Voir Aperçu des avis pour plus d'informations sur les avis OCI.