DBMS_DATAMART Référence du 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 enregistrer et accéder aux ensembles de données.

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 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 des 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 jeu de données spécifique.

revoke_access

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

désinscrire

Cette procédure désinscrit un ensemble de données.

list_data_sets

Cette procédure renvoie 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 une admission existante.

Procédure d'enregistrement d'objet

Cette procédure enregistre des 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, notamment la région où réside la base de données, les locations individuelles ou les compartiments. MY$REGION n'est pas pris en charge.

thumbnail

Image affichée par l'outil dans la couverture d'un ensemble de données. Ce paramètre ne peut pas être utilisé.

thumbnail_url

Vous ne pouvez pas indiquer 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 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 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 aux demandes

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 le format 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 les autres métadonnées pour soumettre leur propre demande par courriel.

Procédure d'octroi d'accès

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 de partage.

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

Révoquer la procédure 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 de partage.

Syntaxe

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

Désinscription 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 de partage.

Syntaxe

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

Procédure de liste de jeux 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 est true, il renvoie la liste des jeux de données que vous enregistrez. Si false, il renvoie les ensembles de données disponibles.

Obtenir l'URL de l'image de stock - Procédure

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

Syntaxe

function get_stock_image_url return varchar2;

Obtenir les espaces de noms réservés - Procédure

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'admission

Cette procédure met à jour une admission existante.

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.