Paquete DBMS_CLOUD_NOTIFICATION
El paquete DBMS_CLOUD_NOTIFICATION
permite enviar mensajes o la salida de una consulta SQL a un proveedor.
Requisitos
- Cree un gateway de NAT en la red virtual en la nube (VCN) en la que residan los recursos de Autonomous Database siguiendo las instrucciones de Creación de un gateway de NAT de la Documentación de Oracle Cloud Infrastructure.
- Después de crear el gateway de NAT, agregue una regla de ruta y una regla de seguridad de salida a cada subred (en la VCN) en la que residan los recursos de Autonomous Database para que estos recursos puedan utilizar el gateway para obtener una clave pública de la instancia de Azure AD:
- Vaya a la página Detalles de subred de la subred.
- En el separador Información de Subred, haga clic en el nombre de la Tabla de Direcciones de la subred para mostrar su página Detalles de Tabla de Direcciones.
- En la tabla de Reglas de ruta existentes, compruebe si ya hay una regla con las siguientes características:
- Destino: 0.0.0.0/0
- Tipo de destino: gateway de NAT
- Destino: nombre del gateway de NAT que acaba de crear en la VCN
Si dicha regla no existe, haga clic en Agregar reglas de ruta y agregue una regla de ruta con estas características.
- Vuelva a la página Detalles de subred de la subred.
- En la tabla Listas de seguridad de la subred, haga clic en el nombre de la lista de seguridad de la subred para mostrar su página Detalles de lista de seguridad.
- En el menú lateral, en Recursos, haga clic en Reglas de salida.
- En la tabla de Reglas de salida existentes, compruebe si ya hay una regla con las siguientes características:
- Tipo de destino: CIDR
- Destino: 0.0.0.0/0
- Protocolo IP: TCP
- Rango de puertos de origen: 443
- Rango de puertos de destino: todos
Si dicha regla no existe, haga clic en Agregar Reglas de Salida y agregue una regla de salida con estas características.
La configuración del proxy HTTP en el entorno debe permitir que la base de datos acceda al proveedor de servicios en la nube.
Note:
La configuración de red, incluido el proxy HTTP, solo se puede editar hasta que la infraestructura de Exadata tenga el estado Necesita activación. Una vez activada, no puede editar esa configuración.La configuración de un proxy HTTP para una infraestructura de Exadata ya aprovisionada necesita una solicitud de servicio (SR) en My Oracle Support. Consulte Creación de una solicitud de servicio en My Oracle Support para obtener más información.
Resumen de subprogramas DBMS_CLOUD_NOTIFICATION
En esta tabla se resumen los subprogramas incluidos en el paquete.
Subprograma | Descripción |
---|---|
Enviar la salida de la consulta SQL a un proveedor. |
|
Enviar un mensaje de texto a un proveedor. |
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 |
---|---|
|
Especifica el proveedor. Los valores válidos son: ' Este parámetro es obligatorio. |
|
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 Este parámetro es obligatorio. |
|
Especifica la consulta SQL que se va a ejecutar. Los resultados se envían al profesional asistencial. Este parámetro es obligatorio. |
|
Especifica parámetros específicos para Para el tipo de proveedor
Para el tipo de proveedor
Para el tipo de proveedor
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 obtengasmtp_host
. El usuario también necesita un remitente aprobado SMTP y sus credenciales para autenticarse con el servidor de Email Delivery para obtenercredential_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 permisosFiles.ReadWrite.All
yChannelSettings.Read.All
para la API de Graph desde su portal de Azure. Para generar el token necesario, el usuario necesitabot_id
en el nombre de usuario ybot_secret
en la contraseña. El tamaño máximo de archivo admitido al utilizarDBMS_CLOUD_NOTIFICATION.SEND_DATA
para Microsoft Teams es de 4 MB. - Para el proveedor
slack
, el valorusername
puede ser cualquier cadena válida ypassword
es el token de bot de Slack.
Ejemplo
Envíe una 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 una 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 una 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;
/
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 |
---|---|
|
Especifica el proveedor. Los valores válidos son: ' Este parámetro es obligatorio. |
|
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 Para el proveedor de Slack, el nombre de usuario de la credencial debe ser Este parámetro es obligatorio. |
|
Especifica el texto del mensaje. Este parámetro es obligatorio. |
|
Especifica parámetros específicos para Para el tipo de proveedor
email , los parámetros válidos son:
Para el tipo de proveedor
msteams , el parámetro válido es:
Para el tipo de proveedor
slack , el parámetro válido es:
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 "About". 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 CREATE_CREDENTIAL Procedure 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 obtengasmtp_host
. El usuario también necesita un remitente aprobado SMTP y sus credenciales para autenticarse con el servidor de Email Delivery para obtenercredential_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 permisosFiles.ReadWrite.All
yChannelSettings.Read.All
para la API de Graph desde su portal de Azure. Para generar el token necesario, el usuario necesitabot_id
en el nombre de usuario ybot_secret
en la contraseña. - Para el proveedor
slack
, el valorusername
puede ser cualquier cadena válida ypassword
es el token de bot de Slack.
Ejemplos
Envíe 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;
/
Envíe 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;
/
Envíe 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;
/