Pacchetto DBMS_CLOUD_NOTIFICATION
Il pacchetto DBMS_CLOUD_NOTIFICATION
consente di inviare messaggi o l'output di una query SQL a un provider.
Prerequisiti
- Crea un gateway NAT nella rete cloud virtuale (VCN) in cui risiedono le tue risorse di Autonomous Database seguendo le istruzioni riportate in Crea un gateway NAT nella documentazione di Oracle Cloud Infrastructure.
- Dopo aver creato il gateway NAT, aggiungere una regola di instradamento e una regola di sicurezza di uscita a ogni subnet (nella VCN) in cui risiedono le risorse di Autonomous Database in modo che queste risorse possano utilizzare il gateway per ottenere una chiave pubblica dall'istanza di Azure AD:
- Andare alla pagina Dettagli subnet per la subnet.
- Nella scheda Informazioni subnet, fare clic sul nome della tabella di instradamento della subnet per visualizzare la relativa pagina Dettagli tabella di instradamento.
- Nella tabella delle regole di instradamento esistenti, verificare se esiste già una regola con le seguenti caratteristiche:
- Data: 0.0.0.0/0
- Tipo di destinazione: gateway NAT
- Destinazione: il nome del gateway NAT appena creato nella VCN
Se la regola non esiste, fare clic su Aggiungi regole di instradamento e aggiungere una regola di instradamento con queste caratteristiche.
- Tornare alla pagina Dettagli subnet per la subnet.
- Nella tabella Elenchi di sicurezza della subnet, fare clic sul nome della lista di sicurezza della subnet per visualizzare la relativa pagina Dettagli lista di sicurezza.
- Nel menu laterale, in Risorse, fare clic su Regole di uscita.
- Nella tabella delle regole di uscita esistenti, verificare se esiste già una regola con le seguenti caratteristiche:
- Tipo di destinazione: CIDR
- Data: 0.0.0.0/0
- Protocollo IP: TCP
- Intervallo porte di origine: 443
- Intervallo di porte di destinazione: tutte
Se una regola di questo tipo non esiste, fare clic su Aggiungi regole di uscita e aggiungere una regola di uscita con queste caratteristiche.
Le impostazioni del proxy HTTP nell'ambiente devono consentire al database di accedere al provider di servizi cloud.
Nota
La configurazione di rete, incluso il proxy HTTP, può essere modificata solo fino a quando lo stato dell'infrastruttura Exadata non è Richiede attivazione. Una volta attivato, non è possibile modificare tali impostazioni.L'impostazione di un proxy HTTP per un'infrastruttura Exadata già fornita richiede una richiesta di servizio (SR) in My Oracle Support. Per informazioni dettagliate, vedere Create a Service Request in My Oracle Support.
Riepilogo dei sottoprogrammi DBMS_CLOUD_NOTIFICATION
Questa tabella contiene un riepilogo dei sottoprogrammi inclusi nel pacchetto.
Sottoprogramma | Descrizione |
---|---|
Inviare l'output della query SQL a un provider. |
|
Invia un messaggio di testo a un provider. |
SEND_DATA Procedura
La procedura SEND_DATA
invia i risultati della query specificata a un provider.
Sintassi
DBMS_CLOUD_NOTIFICATION.SEND_DATA
(
provider IN VARCHAR2,
credential_name IN VARCHAR2,
query IN CLOB,
params IN CLOB
);
Parametri
Parametro | Descrizione |
---|---|
|
Specifica il provider. I valori validi sono: ' Questo parametro è obbligatorio. |
|
Il nome dell'oggetto credenziale per accedere al provider. Per il provider di posta elettronica, la credenziale è il nome della credenziale del mittente approvato SMTP che contiene il nome utente e la password. Per il provider msteams, la credenziale è il nome della credenziale. Per il provider Slack, il nome utente della credenziale deve essere Questo parametro è obbligatorio. |
|
Specifica la query SQL da eseguire. I risultati vengono inviati al provider. Questo parametro è obbligatorio. |
|
Specifica parametri specifici per Per il tipo di provider
Per il tipo di provider
Per il tipo di provider
Questo parametro è obbligatorio. |
Note sull'uso
Per creare l'oggetto credenziale, utilizzare la procedura DBMS_CLOUD.CREATE_CREDENTIAL
(credential_name
, username
, password)
. Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedura.
- Per il provider
email
, l'utente richiede un endpoint di connessione SMTP per il server di consegna tramite e-mail per otteneresmtp_host
. L'utente richiede inoltre che un mittente approvato SMTP e le relative credenziali vengano autenticate con il server di consegna tramite e-mail per ottenerecredential_name
. È necessario configurare la connessione SMTP e generare e approvare le credenziali SMTP. - Per il provider
msteams
, l'utente richiede l'applicazione Microsoft Teams e un bot configurato al suo interno. L'applicazione deve essere pubblicata nell'organizzazione e installata dopo aver ottenuto l'approvazione dall'amministratore dal centro di amministrazione. L'utente richiede inoltre l'accesso per l'autorizzazioneFiles.ReadWrite.All
eChannelSettings.Read.All
per l'API Graph dal proprio portale Azure. Per generare il token richiesto, l'utente richiedebot_id
nel nome utente ebot_secret
nella password. La dimensione massima supportata per i file che utilizzanoDBMS_CLOUD_NOTIFICATION.SEND_DATA
per Microsoft Teams è di 4 MB. - Per il provider
slack
, il valoreusername
può essere qualsiasi stringa valida epassword
è il token bot Slack.
Esempio
Inviare l'output SQL con il provider 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;
/
Inviare l'output SQL con il provider 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;
/
Inviare l'output SQL con il provider 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;
/
SEND_MESSAGE Procedura
La procedura invia un messaggio di testo a un provider.
Sintassi
DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE
(
provider IN VARCHAR2,
credential_name IN VARCHAR2,
message IN CLOB,
params IN CLOB
);
Parametri
Parametro | Descrizione |
---|---|
|
Specifica il provider. I valori validi sono: ' Questo parametro è obbligatorio. |
|
Il nome dell'oggetto credenziale per accedere al provider. Per il provider di posta elettronica, la credenziale è il nome della credenziale del mittente approvato SMTP che contiene il nome utente e la password. Per il provider msteams, la credenziale deve contenere sia il nome utente che la password Per il provider Slack, il nome utente della credenziale deve essere Questo parametro è obbligatorio. |
|
Specifica il testo del messaggio Questo parametro è obbligatorio. |
|
Specifica parametri specifici per Per il tipo di provider
email , i parametri validi sono:
Per il tipo di provider
msteams , il parametro valido è:
Per il tipo di provider
slack , il parametro valido è:
L'ID canale è un ID univoco per un canale ed è diverso dal nome del canale. In Slack, quando si visualizzano i dettagli del canale, è possibile trovare l'ID canale nella scheda "Informazioni". Questo parametro è obbligatorio. |
Note sull'uso
Per creare l'oggetto credenziale, utilizzare la procedura DBMS_CLOUD.CREATE_CREDENTIAL
(credential_name
, username
e password)
. Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedure.
- Per il provider
email
, l'utente richiede un endpoint di connessione SMTP per il server di consegna tramite e-mail per otteneresmtp_host
. L'utente richiede inoltre che un mittente approvato SMTP e le relative credenziali vengano autenticate con il server di consegna tramite e-mail per ottenerecredential_name
. È necessario configurare la connessione SMTP e generare e approvare le credenziali SMTP. - Per il provider
msteams
, l'utente richiede l'applicazione Microsoft Teams e un bot configurato al suo interno. L'applicazione deve essere pubblicata nell'organizzazione e installata dopo aver ottenuto l'approvazione dall'amministratore dal centro di amministrazione. L'utente richiede inoltre l'accesso per l'autorizzazioneFiles.ReadWrite.All
eChannelSettings.Read.All
per l'API Graph dal proprio portale Azure. Per generare il token richiesto, l'utente richiedebot_id
nel nome utente ebot_secret
nella password. - Per il provider
slack
, il valoreusername
può essere qualsiasi stringa valida epassword
è il token bot Slack.
Esempi
Inviare un messaggio di testo al provider 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;
/
Invia un messaggio di testo al provider 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;
/
Invia un messaggio di testo al provider 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;
/