DBMS_DATAMART-Packagereferenz

Dieses Kapitel enthält Informationen zu den Paketen, die Sie mit dem Data Marketplace-Tool in Data Studio verwenden. Das Thema DBMS_DATAMART behandelt auch die Prozeduren im Package DBMS_DATAMART. Das Package DBMS_DATAMART stellt APIs zur Unterstützung allgemeiner Vorgänge mit Data Marketplace bereit.

Zusammenfassung der DBMS_DATAMART-Unterprogramme

Mit den Oracle Data Marketplace-APIs können Sie Datasets registrieren und darauf zugreifen.

DBMS_DATAMART-Packageunterprogramme

Das Package DBMS_DATAMART vereinfacht gemeinsame Vorgänge mit Oracle Data Marketplace, wie das Registrieren von Objekten, das Anfordern von Zugriff, das Gewähren von Zugriff, das Entziehen von Zugriff, das Aufheben der Registrierung und das Auflisten von Datasets.

In der folgenden Tabelle werden die DBMS_DATAMART-Unterprogramme aufgeführt und kurz beschrieben.

Unterprogramm Beschreibung
register_object

Mit diesem Verfahren werden Datasets registriert.

request_access

Dieses Verfahren fordert den Zugriff auf ein bestimmtes Dataset an.

grant_access

Diese Prozedur erteilt Zugriff auf ein bestimmtes Dataset.

revoke_access

Mit diesem Verfahren wird der Zugriff auf ein bestimmtes Dataset entzogen.

Registrierung aufheben

Mit diesem Verfahren wird die Registrierung eines Datasets aufgehoben.

list_data_sets

Diese Prozedur gibt die Liste der Datasets zurück.

get_stock_image_urls

Dieses Verfahren gibt die URL-Basis zurück, aus der Sie Bilder auswählen können.

get_reserved_namespaces

Diese Prozedur zeigt ein JSON-Array mit Namespaces an, die vom System reserviert sind und nicht von Ihnen verwendet werden können.

update_registration

Mit diesem Verfahren wird eine vorhandene Registrierung aktualisiert.

Objekt registrieren - Prozedur

Mit diesem Verfahren werden Datasets registriert.

Syntax

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

Objektparameter registrieren

Wenn Sie auf Register Object-Prozeduren zugreifen, verwenden Sie die folgenden Parameter.

Parameter Beschreibung

schema_name

Der Name für das Schema.

object_name

Der Name des Objekts.

namespace

Der Namespace für das Objekt.

data_set_name

Der Name des Datasets.

scope

Dieser Parameter gibt an, wer remote auf die Daten zugreifen kann. Der Geltungsbereich kann auf verschiedene Ebenen festgelegt werden, z.B. auf die Region, in der sich die Datenbank befindet, auf einzelne Mandanten oder auf Compartments. MY$REGION wird nicht unterstützt.

thumbnail

Das Bild, das das Tool in der Abdeckung eines Datensatzes anzeigt. Sie können diesen Parameter nicht verwenden.

thumbnail_url

Sie können keine eigene thumbnail_url angeben. Oracle stellt diesen Parameter bereit.

thumbnail_mime_type

Es gibt den MIME-Typ (Multipurpose Internet Mail Extensions) eines Thumbnails an.

Parameters

Es gibt JSON-Parameter an, wie tags, description, data_set_owner, authorization_required, offload_targets, offload_targets und store_sample.

Zugriffsanforderung - Vorgehensweise

Dieses Verfahren fordert Zugriff auf das angegebene Dataset an.

Syntax

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

Anforderungszugriffsparameter

Wenn Sie auf die Prozedur Request Access zugreifen, verwenden Sie die folgenden Parameter.

Parameter Beschreibung

Namespace

Der Namespace für das Objekt.

Dataset name

Der Name des Datasets.

Auth Info

Dieser Parameter wird bei der Rückgabe als JSON aufgefüllt. Wenn der Dataset-Provider eine E-Mail-Adresse angegeben hat und der anfordernde Benutzer seine Data Studio-SMTP-Einstellungen eingerichtet hat, wird die Anforderung per E-Mail weitergeleitet, und dieser Parameter wird generiert, wobei das Feld delivery auf "SMTP" gesetzt ist. Andernfalls wird das Feld delivery auf browser gesetzt, und Sie müssen die restlichen Metadaten verwenden, um ihre eigene Anforderung per E-Mail weiterzuleiten.

Zugriffsberechtigung erteilen - Vorgehensweise

Diese Prozedur erteilt Zugriff auf das angegebene Dataset. Der Parameter für die Authentifizierungsinformationen muss die Freigabe-ID enthalten.

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

Zugriffsrechte widerrufen - Vorgehensweise

Mit diesem Verfahren wird der Zugriff auf das angegebene Dataset entzogen. Der Parameter für die Authentifizierungsinformationen muss die Freigabe-ID enthalten.

Syntax

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

Registrierung der Prozedur aufheben

Mit diesem Verfahren wird der Zugriff auf das angegebene Dataset entzogen. Der Parameter für die Authentifizierungsinformationen muss die Freigabe-ID enthalten.

Syntax

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

Listen-Dataset-Prozedur

Im Folgenden wird eine Liste der Datasets angezeigt.

Syntax

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

Wenn registrations true ist, wird die Liste der Datasets zurückgegeben, die Sie registrieren. Wenn false verwendet wird, werden die verfügbaren Datasets zurückgegeben.

URL-Prozedur für Stockbild abrufen

Im Folgenden wird die URL angezeigt, aus der Sie Bilder auswählen können.

Syntax

function get_stock_image_url return varchar2;

Prozedur "Reservierte Namespaces abrufen"

Diese Prozedur zeigt ein JSON-Array mit Namespaces an, die vom System reserviert sind. Sie können diese Namespaces nicht verwenden.

Syntax

function get_reserved_namespaces return clob;

Aufnahmeverfahren aktualisieren

Mit diesem Verfahren wird eine vorhandene Registrierung aktualisiert.

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

Die Parameter dieses Verfahrens sind bereits oben beschrieben.