Documentation sur Oracle Cloud Infrastructure

Informations de référence sur l'ensemble DBMS_DATAMART

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 l'ensemble DBMS_DATAMART. L'ensemble DBMS_DATAMART fournit des API pour la prise en charge des opérations communes avec Data Marketplace.

Rubrique parent : Outil Data Marketplace

Sommaire des sous-programmes DBMS_DATAMART

Vous pouvez utiliser les API d'Oracle Data Marketplace pour enregistrer des jeux de données et y accéder.

DBMS_DATAMART Sous-programmes d'ensemble

L'ensemble 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 liste des jeux 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 jeu de données spécifique.
grant_access

Cette procédure permet d'accéder à un jeu 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 retourne la liste des jeux 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.

Procédure d'enregistrement 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 réglée à différents niveaux, notamment à la région où réside la base de données, à des locations individuelles ou à des compartiments. MY$REGION n'est pas pris en charge.

thumbnail

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

thumbnail_url

Vous ne pouvez pas spécifier votre propre thumbnail_url. Oracle fournit ce paramètre.

thumbnail_mime_type

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

Parameters

Elle spécifie des paramètres JSON tels que tags, description, data_set_owner, authorization_required, offload_targets, offload_targets et store_sample.

Procédure d'accès à la demande

Cette procédure demande l'accès au jeu 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 à la 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é alimenté au format JSON lors du retour. Si le fournisseur du jeu de données a fourni une adresse de courriel 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 réglé à SMTP. Sinon, le champ delivery sera réglé à browser et vous devez utiliser le reste des métadonnées pour soumettre leur propre demande par courriel.

Procédure d'accès aux droits

Cette procédure permet d'accéder au jeu 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);

Procédure d'annulation d'enregistrement

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 jeu de données de liste

Cette procédure affiche une liste de jeux de données.

Syntaxe 

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

Si registrations est true, il retourne la liste des jeux de données que vous enregistrez. Si false, il retourne les jeux de données disponibles.

Procédure d'obtention de l'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 Obtenir les espaces de noms réservés

Cette procédure affiche un tableau JSON d'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.