DBMS_DATAMART-Packagereferenz

Dieser Abschnitt enthält Informationen zu Paketen, die mit dem Data Marketplace-Tool in Data Studio verwendet werden. Im Thema DBMS_DATAMART werden auch die im Package DBMS_DATAMART enthaltenen Prozeduren behandelt. Das DBMS_DATAMART-Package bietet APIs zur Unterstützung gängiger Vorgänge mit Data Marketplace.

Zusammenfassung der DBMS_DATAMART-Unterprogramme
Mit Oracle Data Marketplace-APIs können Sie Datasets registrieren und darauf zugreifen.

Übergeordnetes Thema: Data Marketplace-Tool

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.

Übergeordnetes Thema: DBMS_DATAMART Packagereferenz

Oracle Cloud Infrastructure-Dokumentation

DBMS_DATAMART-Packagereferenz

Zusammenfassung der DBMS_DATAMART-Unterprogramme