DBMS_DATAMART Référence de package

Cette section fournit des informations sur les packages utilisés avec l'outil Data Marketplace dans Data Studio. La rubrique DBMS_DATAMART couvre également les procédures incluses dans le package DBMS_DATAMART. Le package DBMS_DATAMART fournit des API pour prendre en charge les opérations courantes avec Data Marketplace.

Récapitulatif des sous-programmes DBMS_DATAMART

Vous pouvez utiliser les API Oracle Data Marketplace pour inscrire des ensembles de données et y accéder.

DBMS_DATAMART Sous-programmes de package

Le package DBMS_DATAMART simplifie les opérations courantes avec Oracle Data Marketplace, telles que l'enregistrement d'objets, la demande d'accès, l'octroi d'accès, la révocation d'accès, l'annulation de l'enregistrement et la création de listes d'ensembles de données.

Le tableau suivant répertorie les sous-programmes DBMS_DATAMART et les décrit brièvement.

Sous-programme Description
register_object

Cette procédure enregistre les jeux de données.

request_access

Cette procédure demande l'accès à un ensemble de données spécifique.

grant_access

Cette procédure permet d'accéder à un ensemble de données spécifique.

revoke_access

Cette procédure révoque l'accès à un jeu de données spécifique.

désinscrire

Cette procédure annule l'enregistrement d'un jeu de données.

list_data_sets

Cette procédure renvoie la liste des ensembles de données.

get_stock_image_urls

Cette procédure renvoie la base d'URL à partir de laquelle vous pouvez sélectionner des images.

get_reserved_namespaces

Cette procédure affiche un tableau JSON d'espaces de noms qui sont réservés par le système et ne peuvent pas être utilisés par vous.

update_registration

Cette procédure met à jour un enregistrement existant.

Enregistrer une procédure d'objet

Cette procédure enregistre les jeux de données.

Syntaxe

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

Enregistrer les paramètres d'objet

Si vous accédez aux procédures Register Object, utilisez les paramètres suivants.

Paramètre Description

schema_name

Nom du schéma.

object_name

Nom de l'objet.

namespace

Espace de noms de l'objet.

data_set_name

Nom du jeu de données.

scope

Ce paramètre indique qui peut accéder à distance aux données. La portée peut être définie sur différents niveaux, y compris sur la région dans laquelle réside la base de données, sur des locations individuelles ou sur des compartiments. MY$REGION n'est pas pris en charge.

thumbnail

Image affichée par l'outil dans la couverture d'un jeu de données. Vous ne pouvez pas utiliser ce paramètre.

thumbnail_url

Vous ne pouvez pas indiquer votre propre thumbnail_url. Ce paramètre est fourni par Oracle.

thumbnail_mime_type

Il spécifie le type de miniature Multipurpose Internet Mail Extensions (MIME).

Parameters

Il indique les paramètres JSON tels que tags, description, data_set_owner, authorization_required, offload_targets, offload_targets et store_sample.

Procédure de demande d'accès

Cette procédure demande l'accès à l'ensemble de données spécifié.

Syntaxe

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

Paramètres d'accès de demande

Si vous accédez à la procédure Request Access, utilisez les paramètres suivants.

Paramètre Description

Namespace

Espace de noms de l'objet.

Dataset name

Nom du jeu de données.

Auth Info

Ce paramètre est généré avec la valeur JSON lors du retour. Si le fournisseur de jeu de données a fourni une adresse électronique et que l'utilisateur demandeur a configuré ses paramètres SMTP Data Studio, la demande sera soumise par courriel et ce paramètre sera généré avec le champ delivery défini sur SMTP. Sinon, le champ delivery sera défini sur browser et vous devez utiliser le reste des métadonnées pour soumettre leur propre demande par courriel.

Procédure d'autorisation d'accès

Cette procédure accorde l'accès à l'ensemble de données spécifié. Le paramètre d'informations d'authentification doit contenir l'ID partage.

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

Procédure de révocation d'accès

Cette procédure révoque l'accès au jeu de données spécifié. Le paramètre d'informations d'authentification doit contenir l'ID partage.

Syntaxe

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

Annuler l'inscription de la procédure

Cette procédure révoque l'accès au jeu de données spécifié. Le paramètre d'informations d'authentification doit contenir l'ID partage.

Syntaxe

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

Procédure de liste des ensembles de données

Cette procédure affiche la liste des jeux de données.

Syntaxe

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

Si registrations a la valeur true, il renvoie la liste des ensembles de données que vous enregistrez. Si la valeur est false, elle renvoie les ensembles de données disponibles.

Procédure d'obtention d'URL d'image de stock

Cette procédure affiche l'URL à partir de laquelle vous pouvez sélectionner des images.

Syntaxe

function get_stock_image_url return varchar2;

Procédure d'obtention des espaces de noms réservés

Cette procédure affiche le tableau JSON des espaces de noms réservés par le système. Vous ne pouvez pas utiliser ces espaces de noms.

Syntaxe

function get_reserved_namespaces return clob;

Mettre à jour la procédure d'enregistrement

Cette procédure met à jour un enregistrement existant.

Syntaxe
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);

Les paramètres de cette procédure sont déjà décrits ci-dessus.