DBMS_LIVE_FEED Riferimento al package

In questo capitolo vengono fornite informazioni sui package utilizzati con lo strumento di caricamento dati in Data Studio. L'argomento DBMS_LIVE_FEED riguarda anche le procedure incluse nel pacchetto DBMS_LIVE_FEED.

argomenti:

Riepilogo dei sottoprogrammi DBMS_LIVE_FEED

DBMS_LIVE_FEED Procedure

Riepilogo dei sottoprogrammi DBMS_LIVE_FEED
Il package DBMS_LIVE_FEED semplifica le operazioni comuni, ad esempio l'esecuzione di una tabella attiva basata su richiesta, su una pianificazione o come risultato di aggiornamenti basati su notifiche a una tabella basati su nuovi oggetti nei bucket dell'area di memorizzazione degli oggetti.

Argomento padre: pagina Caricamento dati

Riepilogo dei sottoprogrammi DBMS_LIVE_FEED

Il package DBMS_LIVE_FEED semplifica le operazioni comuni, ad esempio l'esecuzione di un feed di tabella attiva su richiesta, in una pianificazione o come risultato di aggiornamenti basati su notifiche a una tabella basati su nuovi oggetti nei bucket dell'area di memorizzazione degli oggetti.

DBMS_LIVE_FEED Sottoprogrammi del pacchetto

La tabella seguente elenca i sottoprogrammi DBMS_LIVE_FEED e li descrive brevemente.

Sottoprogramma	descrizione;
create_for_storage_link	Questa procedura crea un feed attivo per il collegamento di memorizzazione.
create_for_directory	Questa procedura crea un feed attivo per la directory.
create_for_url	Questa procedura crea un feed attivo dall'URL.
modify_live_feed	Questa procedura modifica un feed attivo.
drop_live_feed	Questa procedura elimina un feed live.
load_new_content	Questa procedura carica il nuovo contenuto in un feed attivo esistente.
get_notification_key	Questa procedura recupera la chiave di notifica da un feed attivo.
get_confirmation_url	Questa procedura riceve l'URL di conferma da un feed attivo.
get_notification_state	Questa procedura riceve lo stato di notifica da un feed attivo.

Procedura Crea per collegamento di memorizzazione

Questa procedura crea un feed di tabella attiva da un collegamento di memorizzazione cloud. Un collegamento di storage cloud è un'associazione denominata tra un URI bucket OCI e un nome di credenziale locale.

Sintassi

procedure create_for_storage_link(live_feed_name     IN VARCHAR2,
                                           table_name         IN VARCHAR2,
                                           storage_link_name  IN VARCHAR2,
                                           schema             IN VARCHAR2 DEFAULT NULL,
                                           table_schema       IN VARCHAR2 DEFAULT NULL,
                                           column_list        IN CLOB     DEFAULT NULL,
                                           object_type        IN VARCHAR2 DEFAULT NULL,
                                           object_format      IN VARCHAR2 DEFAULT NULL,
                                           object_filter      IN VARCHAR2 DEFAULT NULL,
                                           object_filter_type IN VARCHAR2 DEFAULT NULL,
                                           scheduled          IN BOOLEAN  DEFAULT NULL,
                                           scheduler_interval IN VARCHAR2 DEFAULT NULL,
                                           notifications      IN BOOLEAN  DEFAULT NULL,
                                           job_class          IN VARCHAR2 DEFAULT NULL,
                                           start_date         IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
                                           end_date           IN TIMESTAMP WITH TIME ZONE DEFAULT NULL);

DBMS_ LIVE_FEED Parametri

Se si accede alle procedure DBMS_LIVE_FEED, utilizzare i parametri riportati di seguito.

Parametro	descrizione;
`live_feed_name`	Il nome del feed attivo che si desidera creare.
`storage_link_name`	Il nome del collegamento di memorizzazione cloud. Il nome del collegamento deve essere conforme alle convenzioni di denominazione Oracle standard.
`table_name`	Nome della tabella di destinazione di Autonomous Database in cui il feed attivo caricherà i dati dallo storage degli oggetti cloud.
`Object_filter`	Nome della tabella di destinazione in cui verranno caricati i dati del feed attivo nell'istanza di Autonomous Database per accedere allo storage degli oggetti cloud.
`object_filter_type`	Espressione regolare per limitare il feed della tabella attiva solo ai file nel bucket che corrispondono all'espressione. . Può essere un'espressione regolare o un glob, a seconda del parametro `object_filter_type`.
`scheduled`	L'impostazione predefinita è `TRUE`. Se `TRUE`, è possibile impostare una pianificazione per l'esecuzione dell'oggetto feed della tabella attiva.
`notifications`	L'impostazione predefinita è `FALSE`. Quando `TRUE`, lo strumento Live Feed consente al tuo livefeed di essere avvisato dallo storage degli oggetti che ci sono nuovi file da caricare.
`schema`	Nome dello schema. Nome dello schema del livefeed. Al momento è supportato solo lo schema corrente.
`table_schema`	Schema della tabella di destinazione.
`object_type`	Il tipo dell'oggetto. I tipi di file che è possibile caricare sono CSV, JSON e Parquet.
`object_format`	Questa è una delle opzioni di SQL Loader. Accetta il formato ricevuto dalla procedura `DBMS_CLOUD.COPY_DATA`.
`scheduler_interval`	Questo parametro visualizza l'intervallo in base al quale viene eseguito il livefeed utilizzando la sintassi `DBMS_SCHEDULER`.
`job_class`	Classe del processo Scheduler. I valori sono `TPURGENT,TP,HIGH,MEDIUM` e `LOW`.
`start_date`	Data di inizio del job feed attivo.
`end_date`	Data di fine del job feed attivo.

Nota

Nella tabella precedente sono elencati i parametri di tutte le procedure descritte di seguito.

Esempio

In questo esempio, viene creato un feed attivo denominato MYLIVEFEED sull'URL specificato.

SQL> BEGIN
   dbms_live_feed.create_for_storage_link(
     live_feed_name => 'MYLIVEFEED',
     storage_link_name => 'DATATOOLS_LF_BUCKET',
     table_name => 'MALTESE',
     object_filter => 'fndcalday?.csv',
     object_filter_type => 'GLOB',
     scheduled => false,
     notifications => false);
end;
/;
PL/SQL procedure successfully completed.

Procedura di creazione per la directory

Questa procedura crea un feed di tabella attiva da una directory.

Sintassi

procedure create_for_directory(live_feed_name     IN VARCHAR2,
                                 table_name         IN VARCHAR2,
                                 directory_name     IN VARCHAR2,
                                 schema             IN VARCHAR2 DEFAULT NULL,
                                 table_schema       IN VARCHAR2 DEFAULT NULL,
                                 column_list        IN CLOB     DEFAULT NULL,
                                 object_type        IN VARCHAR2 DEFAULT NULL,
                                 object_format      IN VARCHAR2 DEFAULT NULL,
                                 object_filter      IN VARCHAR2 DEFAULT NULL,
                                 object_filter_type IN VARCHAR2 DEFAULT NULL,
                                 scheduled          IN BOOLEAN  DEFAULT NULL,
                                 scheduler_interval IN VARCHAR2 DEFAULT NULL,
                                 notifications      IN BOOLEAN  DEFAULT NULL,
                                 job_class          IN VARCHAR2 DEFAULT NULL,
                                 start_date         IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
                                 end_date           IN TIMESTAMP WITH TIME ZONE DEFAULT NULL);

Procedura Crea per URL

Questa procedura crea un feed di tabelle attive da un URL.

Sintassi

 procedure create_for_url(live_feed_name     IN VARCHAR2,
                           table_name         IN VARCHAR2,
                           url                IN VARCHAR2,
                           credential_name    IN VARCHAR2,
                           schema             IN VARCHAR2 DEFAULT NULL,
                           table_schema       IN VARCHAR2 DEFAULT NULL,
                           column_list        IN CLOB     DEFAULT NULL,
                           object_type        IN VARCHAR2 DEFAULT NULL,
                           object_format      IN VARCHAR2 DEFAULT NULL,
                           object_filter      IN VARCHAR2 DEFAULT NULL,
                           object_filter_type IN VARCHAR2 DEFAULT NULL,
                           scheduled          IN BOOLEAN  DEFAULT NULL,
                           scheduler_interval IN VARCHAR2 DEFAULT NULL,
                           notifications      IN BOOLEAN  DEFAULT NULL,
                           job_class          IN VARCHAR2 DEFAULT NULL,
                           start_date         IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
                           end_date           IN TIMESTAMP WITH TIME ZONE DEFAULT NULL);

Modifica procedura feed attivo

Questa procedura modifica il feed di una tabella attiva.

Sintassi

procedure modify_live_feed(live_feed_name     IN VARCHAR2,
                             schema             IN VARCHAR2 DEFAULT NULL,
                             scheduled          IN BOOLEAN  DEFAULT NULL,
                             scheduler_interval IN VARCHAR2 DEFAULT NULL,
                             notifications      IN BOOLEAN  DEFAULT NULL,
                             job_class          IN VARCHAR2 DEFAULT NULL,
                             start_date         IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
                             end_date           IN TIMESTAMP WITH TIME ZONE DEFAULT NULL);

Esempio

In questo esempio, viene modificato un feed attivo denominato MYLIVEFEED.

begin
   dbms_live_feed.modify_live_feed(
     live_feed_name => 'MYLIVEFEED',
     scheduled => true,
     scheduler_interval => 'FREQ=daily;INTERVAL=1',
     notifications => true);
end;
/

Elimina procedura feed attivo

Questa procedura elimina un feed del tavolo attivo.

Sintassi

procedure drop_live_feed(live_feed_name     IN VARCHAR2,
                                  schema             IN VARCHAR2 DEFAULT NULL);

Esempio

In questo esempio, viene eliminato un feed attivo denominato MYLIVEFEED.

begin
   dbms_live_feed.drop_live_feed(live_feed_name => 'MYLIVEFEED');
end;
/

Procedura di caricamento nuovo contenuto

Questa procedura carica nuovi contenuti nel feed.

Sintassi

 procedure load_new_content(live_feed_name IN VARCHAR2,
                                     schema         IN VARCHAR2 DEFAULT NULL);

Procedura recupero chiave notifica

Questa procedura riceve la chiave di notifica Live Table Feed. Viene utilizzato per un feed attivo con notifiche abilitate per creare un URL di notifica per fornire un servizio cloud. Per creare un feed attivo basato su notifiche, attenersi alle istruzioni del capitolo Creating a Notification-Based Live Table Feed.

Sintassi

function get_notification_key(live_feed_name IN VARCHAR2,
                                       schema         IN VARCHAR2 DEFAULT NULL)
    return VARCHAR2;

Recupera URL di conferma

Questa procedura riceve l'URL di conferma che verifica che l'endpoint possa ricevere le notifiche.

È necessario visitare questo URL per abilitare le notifiche ricevute da un servizio cloud. Non è possibile confermare l'abilitazione automatica delle notifiche a causa delle limitazioni del firewall del database. Fare clic su questo URL per abilitare le notifiche, altrimenti non si riceveranno notifiche.

Sintassi

function get_confirmation_url(live_feed_name IN VARCHAR2,
                                       schema         IN VARCHAR2 DEFAULT NULL)
    return VARCHAR2;

Richiedi stato notifica

Questa procedura riceve lo stato di notifica dell'esecuzione del job Feed attivo.

Sintassi

 function get_notification_state(live_feed_name IN VARCHAR2,
                                          schema         IN VARCHAR2 DEFAULT NULL)
    return VARCHAR2;

Argomento padre: DBMS_LIVE_FEED Riferimento pacchetto

Documentazione dell'infrastruttura Oracle Cloud

DBMS_LIVE_FEED Riferimento al package

Riepilogo dei sottoprogrammi DBMS_LIVE_FEED