Paquete DBMS_CLOUD_NOTIFICATION

El paquete DBMS_CLOUD_NOTIFICATION permite enviar mensajes o la salida de una consulta SQL a un proveedor.

DBMS_CLOUD_NOTIFICATION Visión general
Este escenario describe la configuración y el uso del paquete DBMS_CLOUD_NOTIFICATION.
Resumen de los subprogramas DBMS_CLOUD_NOTIFICATION
En esta tabla se resumen los subprogramas incluidos en el paquete.

Tema principal: Referencia de paquete proporcionado por Autonomous Database

Visión general de DBMS_CLOUD_NOTIFICATION

En este escenario, se describe la configuración y el uso del paquete DBMS_CLOUD_NOTIFICATION.

Los proveedores soportados son: correo electrónico, Microsoft Teams y Slack.

Tema principal: Paquete DBMS_CLOUD_NOTIFICATION

Resumen de los subprogramas DBMS_CLOUD_NOTIFICATION

En esta tabla se resumen los subprogramas incluidos en el paquete.

Subprograma	Descripción
Procedimiento SEND_DATA	Enviar la salida de la consulta SQL a un proveedor.
Procedimiento SEND_MESSAGE	Enviar un mensaje de texto a un profesional asistencial.

Procedimiento SEND_DATA
El procedimiento SEND_DATA envía los resultados de la consulta especificada a un proveedor.
Procedimiento SEND_MESSAGE
El procedimiento envía un mensaje de texto a un proveedor.

Tema principal: Paquete DBMS_CLOUD_NOTIFICATION

Procedimiento SEND_DATA

El procedimiento SEND_DATA envía los resultados de la consulta especificada a un proveedor.

Sintaxis

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

Parámetros

parámetro	Descripción
`provider`	Especifica el proveedor. Los valores válidos son: '`email`', '`msteams`' y '`slack`' Este parámetro es obligatorio.
`credential_name`	Nombre del objeto de credencial para acceder al proveedor. Para el proveedor de correo electrónico, la credencial es el nombre de la credencial del remitente aprobado SMTP que contiene su nombre de usuario y contraseña. Para el proveedor de msteams, la credencial es el nombre de la credencial. Para el proveedor de Slack, el nombre de usuario de la credencial debe ser `"SLACK_TOKEN"` y `password` es el token de bot de Slack. Este parámetro es obligatorio.
`query`	Especifica la consulta SQL que se va a ejecutar. Los resultados se envían al profesional asistencial. Este parámetro es obligatorio.
`params`	Especifica parámetros específicos para `provider` en formato JSON. Para el tipo de proveedor `email`, los parámetros válidos son: `sender`. Especifica el ID de correo electrónico del remitente aprobado en un valor `String`. `smtp_host`. Especifica el nombre de host SMTP en un valor `String`. `subject`. Especifica el asunto del correo electrónico en un valor `String`. El tamaño máximo es de 100 caracteres. `recipient`. Especifica los ID de correo electrónico de los destinatarios en un valor `String`. Utilice una coma entre los ID de correo electrónico cuando haya varios destinatarios. `to_cc`. Especifica los ID de correo electrónico que reciben una copia del correo electrónico. Es un valor `String`. Utilice una coma entre los ID de correo electrónico cuando haya varios destinatarios de CC. `to_bcc`. Especifica los ID de correo electrónico que reciben una copia oculta del correo electrónico. Es un valor `String`. Utilice una coma entre los ID de correo electrónico cuando haya varios destinatarios de BCC. `message`. Especifica el texto del mensaje en un valor `String`. `type`. Especifica el formato de salida en un valor `String` como CSV o JSON. `title`. Especifica el título de la asociación de la salida SQL en un valor `String`. El título solo debe contener letras, dígitos, guiones bajos, guiones o puntos como caracteres en su valor debido a que se utiliza para generar un nombre de archivo. Para el tipo de proveedor `msteams`, los parámetros válidos son: `tenant`. Especifica el ID de inquilino en formato `String`. `team`. Especifica el ID de equipo en formato `String`. `channel`. Especifica el ID de canal en formato `String`. `title`. Especifica el título del archivo en formato `String`. El tamaño máximo es de 50 caracteres. `type`. Especifica el formato de salida en un valor `String`. Los valores válidos son CSV o JSON. Para el tipo de proveedor `slack`, los parámetros válidos son: `channel`. Especifica el ID de canal en un valor `String`. El ID de canal es un ID único para un canal y es diferente del nombre del canal. En Slack, al ver los detalles del canal, puede encontrar el ID de canal en el separador "Acerca de". `type`. Especifica el formato de salida en un valor `String`. Los valores válidos son CSV o JSON. Este parámetro es obligatorio.

Notas de Uso

Utilice el procedimiento DBMS_CLOUD.CREATE_CREDENTIAL(credential_name, username, password) para crear el objeto de credencial.

Consulte Procedimiento CREATE_CREDENTIAL para obtener más información.
Para el proveedor email, tenga en cuenta lo siguiente:
- El usuario necesita un punto final de conexión SMTP para que el servidor de Email Delivery obtenga smtp_host. El usuario también necesita un remitente aprobado por SMTP y sus credenciales para autenticarse con el servidor Email Delivery para obtener credential_name. Se debe configurar la conexión SMTP y se deben generar y aprobar las credenciales SMTP.
- El tamaño máximo de mensaje soportado al utilizar DBMS_CLOUD_NOTIFICATION.SEND_DATA con el proveedor email es de 32k bytes.
- Solo puede utilizar DBMS_CLOUD_NOTIFICATION para notificaciones de correo con Autonomous Database versión 19.21 y posteriores.
Para el proveedor msteams, el usuario necesita la aplicación Microsoft Teams y un bot configurado en ella. La aplicación debe publicarse en la organización e instalarse después de obtener la aprobación del administrador del centro de administración. El usuario también necesita acceso para los permisos Files.ReadWrite.All y ChannelSettings.Read.All para Graph API desde su portal de Azure. Para generar el token necesario, el usuario necesita bot_id en el nombre de usuario y bot_secret en la contraseña.

El tamaño máximo de archivo soportado al utilizar DBMS_CLOUD_NOTIFICATION.SEND_DATA para Microsoft Teams es de 4 MB.
Para el proveedor slack, el valor username puede ser cualquier cadena válida y password es el token de bot de Slack.

Ejemplos

Envíe la salida SQL con el proveedor 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;
/

Envíe la salida SQL con el proveedor 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;
/

Envíe la salida SQL con el proveedor 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;
/

Tema principal: Resumen de los subprogramas DBMS_CLOUD_NOTIFICATION

Procedimiento SEND_MESSAGE

El procedimiento envía un mensaje de texto a un profesional asistencial.

Sintaxis

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

Parámetros

parámetro	Descripción
`provider`	Especifica el proveedor. Los valores válidos son: '`email`', '`msteams`' y '`slack`' Este parámetro es obligatorio.
`credential_name`	Nombre del objeto de credencial para acceder al proveedor. Para el proveedor de correo electrónico, la credencial es el nombre de la credencial del remitente aprobado SMTP que contiene su nombre de usuario y contraseña. Para el proveedor de msteams, la credencial debe contener la clave `bot_id` y `bot_secret` en el nombre de usuario y la contraseña. Para el proveedor de Slack, el nombre de usuario de la credencial debe ser `"SLACK_TOKEN"` y `password` es el token de bot de Slack. Este parámetro es obligatorio.
`message`	Especifica el texto del mensaje. Este parámetro es obligatorio.
`params`	Especifica parámetros específicos para `provider` en formato JSON. Para el tipo de proveedor `email`, los parámetros válidos son: `sender`. Especifica el ID de correo electrónico del remitente aprobado en un valor `String`. `smtp_host`. Especifica el nombre de host SMTP en un valor `String`. `subject`. Especifica el asunto del correo electrónico en un valor `String`. El tamaño máximo es de 100 caracteres. `recipient`. Especifica los ID de correo electrónico de los destinatarios en un valor `String`. Utilice una coma entre los ID de correo electrónico cuando haya varios destinatarios. `to_cc`. Especifica los ID de correo electrónico que reciben una copia del correo electrónico. Utilice una coma entre los ID de correo electrónico cuando haya varios destinatarios de CC. `to_bcc`. Especifica los ID de correo electrónico que reciben una copia oculta del correo electrónico. Utilice una coma entre los ID de correo electrónico cuando haya varios destinatarios de BCC. Para el tipo de proveedor `msteams`, el parámetro válido es: `channel`. Especifica el ID de canal en un valor `String`. Para el tipo de proveedor `slack`, el parámetro válido es: `channel`. Especifica el ID de canal en un valor `String`. El ID de canal es un ID único para un canal y es diferente del nombre del canal. En Slack, al ver los detalles del canal, puede encontrar el ID de canal en el separador "Acerca de". Este parámetro es obligatorio.

Notas de Uso

Utilice el procedimiento DBMS_CLOUD.CREATE_CREDENTIAL(credential_name, username, password) para crear el objeto de credencial. Consulte Procedimiento CREATE_CREDENTIAL para obtener más información.

Para el proveedor email, el usuario necesita un punto final de conexión SMTP para que el servidor de Email Delivery obtenga smtp_host. El usuario también necesita un remitente aprobado por SMTP y sus credenciales para autenticarse con el servidor Email Delivery para obtener credential_name. Se debe configurar la conexión SMTP y se deben generar y aprobar las credenciales SMTP.
Para el proveedor msteams, el usuario necesita la aplicación Microsoft Teams y un bot configurado en ella. La aplicación debe publicarse en la organización e instalarse después de obtener la aprobación del administrador del centro de administración. El usuario también necesita acceso para los permisos Files.ReadWrite.All y ChannelSettings.Read.All para Graph API desde su portal de Azure. Para generar el token necesario, el usuario necesita bot_id en el nombre de usuario y bot_secret en la contraseña.
Para el proveedor slack, el valor username puede ser cualquier cadena válida y password es el token de bot de Slack.

Ejemplos

Enviar un mensaje de texto con el proveedor 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;
/

Enviar un mensaje de texto con el proveedor 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;
/

Enviar un mensaje de texto con el proveedor 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;
/

Tema principal: Resumen de los subprogramas DBMS_CLOUD_NOTIFICATION

Documentación de Oracle Cloud Infrastructure

Visión general de DBMS_CLOUD_NOTIFICATION

Resumen de los subprogramas DBMS_CLOUD_NOTIFICATION

Procedimiento SEND_DATA

Procedimiento SEND_MESSAGE