DBMS_DATAMART-Paketreferenz

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 den 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 DBMS_DATAMART-Package vereinfacht allgemeine Vorgänge mit Oracle Data Marketplace, wie das Registrieren von Objekten, das Anfordern von Zugriff, das Gewähren von Zugriff, das Entziehen des Zugriffs, das Aufheben der Registrierung und das Auflisten von Datasets.

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

Unterprogramm	Beschreibung
register_object	In diesem Verfahren werden Datasets registriert.
request_access	Dieses Verfahren fordert den Zugriff auf ein bestimmtes Dataset an.
grant_access	Dieses Verfahren gewährt Zugriff auf ein bestimmtes Dataset.
revoke_access	Mit diesem Verfahren wird der Zugriff auf ein bestimmtes Dataset entzogen.
Registrierung aufheben	Bei diesem Verfahren wird die Registrierung eines Datensatzes aufgehoben.
list_data_sets	Diese Prozedur gibt die Liste der Datasets zurück.
get_stock_image_urls	Diese Prozedur gibt die URL-Basis zurück, aus der Sie Bilder auswählen können.
get_reserved_namespaces	Diese Prozedur zeigt ein JSON-Array von 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.

Objektprozedur registrieren

In 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 Namen des Schemas.
`object_name`	Der Name des Objekts.
`namespace`	Der Namespace für das Objekt.
`data_set_name`	Der Name des Dataset.
`scope`	Dieser Parameter gibt an, wer remote auf die Daten zugreifen kann. Der Geltungsbereich kann auf verschiedene Ebenen festgelegt werden, einschließlich der 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 Datasets angezeigt wird. 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`	Gibt den MIME-Typ (Multipurpose Internet Mail Extensions) des Thumbnails an.
`Parameters`	Gibt JSON-Parameter an, wie `tags`, `description`, `data_set_owner`, `authorization_required`, `offload_targets`, `offload_targets` und `store_sample`.

Prozedur für Anforderungszugriff

Dieses Verfahren fordert den Zugriff auf das angegebene Dataset an.

Syntax

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

Zugriffsparameter anfordern

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 Dataset.
`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 gesendet, 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 zu übermitteln.

Zugriffsverfahren erteilen

Dieses Verfahren gewährt Zugriff auf das angegebene Dataset. Der Parameter "Authentifizierungsinformationen" muss die Freigabe-ID enthalten.

Syntax

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

Zugriffsverfahren entziehen

Mit diesem Verfahren wird der Zugriff auf das angegebene Dataset entzogen. Der Parameter "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 "Authentifizierungsinformationen" muss die Freigabe-ID enthalten.

Syntax

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

Dataset-Prozedur auflisten

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 registrierten Datasets zurückgegeben. Wenn false vorhanden ist, werden die verfügbaren Datasets zurückgegeben.

URL für Stock Image abrufen - Vorgehensweise

Im folgenden Verfahren wird die URL angezeigt, unter 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 von 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-Paketreferenz

Zusammenfassung der DBMS_DATAMART-Unterprogramme