Documentazione dell'infrastruttura Oracle Cloud

DBMS_DATAMART Riferimento al package

In questo capitolo vengono fornite informazioni sui pacchetti utilizzati con lo strumento Data Marketplace in Data Studio. L'argomento DBMS_DATAMART riguarda anche le procedure incluse nel pacchetto DBMS_DATAMART. Il pacchetto DBMS_DATAMART fornisce API per supportare operazioni comuni con Data Marketplace.

Argomento padre: Strumento Data Marketplace

Riepilogo dei sottoprogrammi DBMS_DATAMART

È possibile utilizzare le API Oracle Data Marketplace per registrare e accedere ai set di dati.

DBMS_DATAMART Sottoprogrammi del pacchetto

Il pacchetto DBMS_DATAMART semplifica le operazioni comuni con Oracle Data Marketplace, ad esempio la registrazione degli oggetti, la richiesta di accesso, la concessione dell'accesso, la revoca dell'accesso, l'annullamento della registrazione e l'elencazione dei set di dati.

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

Sottoprogramma descrizione;
register_object

Questa procedura registra i set di dati.
request_access

Questa procedura richiede l'accesso a un set di dati specifico.
grant_access

Questa procedura concede l'accesso a un set di dati specifico.
revoke_access

Questa procedura revoca l'accesso a un set di dati specifico.
annulla registrazione

Questa procedura annulla la registrazione di un set di dati.
list_data_sets

Questa procedura restituisce l'elenco dei set di dati.
get_stock_image_urls

Questa procedura restituisce la base di URL da cui è possibile selezionare le immagini.
get_reserved_namespaces

Questa procedura visualizza un array JSON di spazi di nomi riservati dal sistema e non utilizzabili dall'utente.
update_registration

Questa procedura aggiorna una registrazione esistente.

Procedura di registrazione oggetto

Questa procedura registra i set di dati.

Sintassi

procedure register_object(schema_name         in varchar2,
                          object_name         in varchar2,
                          namespace           in varchar2,
                          data_set_name       in varchar2,
                          scope               in clob default null,
                          thumbnail           in blob default null,
                          thumbnail_url       in varchar2 default null,
                          thumbnail_mime_type in varchar2 default null,
                          parameters          in clob default null);

Registra parametri oggetto

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

Parametro descrizione;

schema_name

Nome dello schema.

object_name

Il nome dell'oggetto.

namespace

Spazio di nomi per l'oggetto.

data_set_name

Il nome del data set.

scope

Questo parametro indica chi può accedere in remoto ai dati. L'ambito può essere impostato su vari livelli, inclusa l'area in cui risiede il database, a singole tenancy o a compartimenti. MY$REGION non è supportato.

thumbnail

Immagine visualizzata dallo strumento nella copertina di un set di dati. Impossibile utilizzare questo parametro.

thumbnail_url

Non è possibile specificare il proprio thumbnail_url. Oracle fornisce questo parametro.

thumbnail_mime_type

Specifica il tipo di anteprima ridotta Multipurpose Internet Mail Extensions (MIME).

Parameters

Specifica i parametri JSON quali tags, description, data_set_owner, authorization_required, offload_targets, offload_targets e store_sample.

Richiedi procedura di accesso

Questa procedura richiede l'accesso al set di dati specificato.

Sintassi

procedure request_access(namespace     in  varchar2,
                         data_set_name in  varchar2,
                         auth_info     out clob);

Parametri di accesso richiesta

Se si accede alla procedura Request Access, utilizzare i parametri riportati di seguito.

Parametro descrizione;

Namespace

Spazio di nomi per l'oggetto.

Dataset name

Il nome del data set.

Auth Info

Questo parametro viene generato popolato come JSON al ritorno. Se il provider di set di dati ha fornito un indirizzo e-mail e l'utente richiedente ha impostato le impostazioni SMTP di Data Studio, la richiesta verrà inviata via e-mail e questo parametro verrà generato con il campo delivery impostato su SMTP. In caso contrario, il campo delivery verrà impostato su browser ed è necessario utilizzare il resto dei metadati per inviare la propria richiesta tramite e-mail.

Consenti procedura di accesso

Questa procedura concede l'accesso al set di dati specificato. Il parametro delle informazioni di autenticazione deve contenere l'ID condivisione.

Sintassi
procedure grant_access(namespace     in varchar2,
                       data_set_name in varchar2,
                       auth_info     in clob);

Revoca procedura di accesso

Questa procedura revoca l'accesso al set di dati specificato. Il parametro delle informazioni di autenticazione deve contenere l'ID condivisione.

Sintassi

procedure revoke_access(namespace     in varchar2,
                        data_set_name in varchar2,
                        auth_info     in clob);

Annulla registrazione procedura

Questa procedura revoca l'accesso al set di dati specificato. Il parametro delle informazioni di autenticazione deve contenere l'ID condivisione.

Sintassi

procedure unregister(namespace     in varchar2,
                     data_set_name in varchar2);

Elenca procedura data set

Questa procedura visualizza un elenco di set di dati.

Sintassi

function list_data_sets(registrations in boolean default false)
  return clob;

Se registrations è true, restituisce l'elenco dei set di dati registrati. Se false, restituisce i data set disponibili.

Procedura recupero URL immagine stock

Questa procedura visualizza l'URL da cui è possibile selezionare le immagini.

Sintassi

function get_stock_image_url return varchar2;

Procedura di recupero degli spazi di nomi riservati

Questa procedura visualizza un array JSON di spazi di nomi riservati dal sistema. Non è possibile utilizzare questi spazi di nomi.

Sintassi

function get_reserved_namespaces return clob;

Aggiorna procedura di registrazione

Questa procedura aggiorna una registrazione esistente.

Sintassi
procedure update_registration(namespace           in varchar2,
                              data_set_name       in varchar,
                              scope               in clob default null,
                              thumbnail           in blob default null,
                              thumbnail_url       in varchar2 default null,
                              thumbnail_mime_type in varchar2 default null,
                              parameters          in clob default null);

I parametri di questa procedura sono già descritti sopra.