DBMS_LIVE_FEED Riferimento pacchetto

Questo capitolo fornisce informazioni sui pacchetti 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 pacchetto DBMS_LIVE_FEED semplifica le operazioni comuni come l'esecuzione di un feed di tabelle attive su richiesta, in base a 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 pacchetto DBMS_LIVE_FEED semplifica le operazioni comuni come l'esecuzione di un feed di tabelle attive su richiesta, in base a una pianificazione o come risultato di aggiornamenti basati su notifiche a una tabella in base a 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 live 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 nuovi contenuti in un Live Feed esistente.
get_notification_key	Questa procedura recupera la chiave di notifica da un Live Feed.
get_confirmation_url	Questa procedura riceve l'URL di conferma da un Live Feed.
get_notification_state	Questa procedura riceve lo stato di notifica da un Live Feed.

Procedura Crea per collegamento memorizzazione

Questa procedura crea un feed tabella attiva da un collegamento allo storage cloud. Un collegamento allo storage cloud è un'associazione denominata tra un URI bucket OCI e un nome 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);

Parametri DBMS_ LIVE_FEED

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

Parametro	Descrizione
`live_feed_name`	Il nome del feed live che si desidera creare.
`storage_link_name`	Il nome del collegamento allo storage 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`	Il 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. Potrebbe 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 tabella attiva.
`notifications`	L'impostazione predefinita è `FALSE`. Quando `TRUE`, lo strumento Live Feed consente al livefeed di essere avvisato dallo storage degli oggetti che ci sono nuovi file da caricare.
`schema`	Il nome dello schema. Il nome dello schema del feed attivo. 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 di esecuzione del feed attivo utilizzando la sintassi `DBMS_SCHEDULER`.
`job_class`	La classe del job Scheduler. I valori sono `TPURGENT,TP,HIGH,MEDIUM` e `LOW`.
`start_date`	La data di inizio del job feed attivo.
`end_date`	Data di fine del job Live Feed.

Nota

I parametri di tutte le procedure descritte di seguito sono elencati nella tabella precedente.

Esempio

In questo esempio viene creato un feed attivo denominato MYLIVEFEED nell'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 Crea per 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 tabella attiva 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 Live Feed

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;
/

Procedura eliminazione feed live

Questa procedura elimina un feed di tabelle attive.

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 feed della tabella attiva. Utilizzato per un feed attivo con notifiche abilitate per creare un URL di notifica per fornire un servizio cloud. Seguire le istruzioni riportate nel capitolo Creating a Notification-Based Live Table Feed per creare un feed attivo basato su notifiche.

Sintassi

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

Ottieni URL conferma

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

È necessario visitare questo URL per abilitare le notifiche ricevute da un servizio cloud. Non è possibile confermare l'abilitazione delle notifiche automaticamente a causa delle restrizioni del firewall del database. Fare clic su questo URL per abilitare le notifiche, altrimenti non si riceverà alcuna notifica.

Sintassi

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

Recupera stato notifica

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

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 pacchetto

Riepilogo dei sottoprogrammi DBMS_LIVE_FEED