Documentation sur Oracle Cloud Infrastructure

Envoyer des avis Slack à partir d'une base de données autonome sur l'IA

Décrit comment configurer Slack afin que vous puissiez envoyer des messages, des alertes ou la sortie d'une interrogation à partir d'une base de données IA autonome vers un canal Slack. Décrit également les procédures que vous utilisez pour envoyer des notifications Slack.

Rubrique parent : Envoyer des courriels et des avis sur Autonomous AI Database

Se préparer à envoyer des avis Slack à partir d'une base de données autonome sur l'IA

Pour envoyer des avis Slack, vous devez configurer votre application Slack pour recevoir des messages de Autonomous AI Database. Créez ensuite des données d'identification à utiliser avec les procédures DBMS_CLOUD_NOTIFICATION pour envoyer des avis Slack à partir de la base de données autonome d'IA.

Pour utiliser Slack avec des procédures DBMS_CLOUD_NOTIFICATION :

  1. Créez votre application Slack.

    L'application Slack est installée dans un espace de travail Slack, qui dispose à son tour de canaux où les messages peuvent être envoyés. Les portées d'autorisation suivantes doivent être définies pour le jeton de robot de l'application Slack :

    channels:read
chat:write
files:write

    Voir Création d'une application pour plus d'informations sur la configuration d'une application Slack.

  2. Demandez à votre administrateur Slack d'ajouter l'application Slack aux canaux auxquels DBMS_CLOUD_NOTIFICATION peut envoyer un message au moyen de l'option "Intégrations" dans le canal.

    Pour plus d'informations, voir Configuration de l'application de base.

  3. Localisez le jeton de robot de l'application disponible dans la page spécifique de l'application Slack, sous https://app.slack.com.

    Pour plus d'informations, voir Configuration de l'application de base.

  4. Créez un objet de données d'identification pour accéder à l'application Slack à partir de Autonomous AI Database.

    Conseil :

    Si vous ne pouvez pas utiliser la procédure CREATE_CREDENTIAL avec succès, consultez l'utilisateur ADMIN pour accorder l'accès d'exécution aux ensembles DBMS_CLOUD.

    Le nom d'utilisateur des données d'identification est SLACK_TOKEN et le mot de passe est le jeton du robot.

    Exemple :

    BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'SLACK_CRED',
     username    => 'SLACK_TOKEN',
     password    => 'xoxb-34....96-34....52-zW....cy');
END;
/

    Pour plus d'informations, voir ProcédureCREATE_CREDENTIAL.

  5. Configurer le contrôle d'accès pour autoriser l'accès utilisateur aux services de réseau externe (Slack).
    BEGIN
 DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE (
  host         => 'slack.com', 
  lower_port   => 443,
  upper_port   => 443,
  ace          => xs$ace_type(
      privilege_list => xs$name_list('http'),
      principal_name => example_invoking_user, 
      principal_type => xs_acl.ptype_db)); 
END;

    Pour plus d'informations, voir Configuration du contrôle d'accès pour les services de réseau externe.

  6. Si vous envoyez du code SQL, configurez le contrôle d'accès pour autoriser l'envoi de la sortie avec DBMS_CLOUD_NOTIFICATION.SEND_DATA.
    BEGIN
 DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE (
  host         => 'files.slack.com', 
  lower_port   => 443,
  upper_port   => 443,
  ace          => xs$ace_type(
      privilege_list => xs$name_list('http'),
      principal_name => example_invoking_user, 
      principal_type => xs_acl.ptype_db)); 
END;

    Pour plus d'informations, voir Configuration du contrôle d'accès pour les services de réseau externe.

Envoyer des messages à un canal Slack

Après avoir créé l'objet de données d'identification Slack comme décrit sous Préparer l'envoi d'avis Slack à partir d'une base de données d'intelligence artificielle autonome, vous pouvez utiliser la procédure DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE pour envoyer un message à un canal Slack.
Exemple :
BEGIN
   DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE(
      provider          => 'slack',
      credential_name   => 'SLACK_CRED',
      message           => 'Alert from Autonomous Database...',
      params            => json_object('channel' value 'C0....08'));
END;
/

Utilisez le paramètre params pour spécifier le canal Slack.

  • channel : Spécifie l'ID canal.

    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 canal dans l'onglet "À propos de". Pour plus d'informations, voir Comment trouver votre ID équipe Slack et votre ID canal Slack.

Pour plus d'informations, voir ProcédureSEND_MESSAGE.

Envoyer les résultats d'interrogation à un canal Slack

Après avoir créé l'objet de données d'identification Slack comme décrit sous Préparer l'envoi d'avis Slack à partir d'une base de données d'intelligence artificielle autonome, vous pouvez utiliser la procédure DBMS_CLOUD_NOTIFICATION.SEND_DATA pour envoyer la sortie d'une interrogation à un canal Slack.
Exemple :
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;
/

Utilisez le paramètre params pour spécifier le canal Slack et le type de données :

  • channel : Spécifie l'ID canal.

    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 canal dans l'onglet "À propos de". Pour plus d'informations, voir Comment trouver votre ID équipe Slack et votre ID canal Slack.

  • type : Spécifie le type de sortie. Les valeurs valides sont les suivantes : 'csv' ou 'json'.

Pour plus d'informations, voir ProcédureSEND_DATA.