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 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 |
---|---|
|
Der Name für das Schema. |
|
Der Name des Objekts. |
|
Der Namespace für das Objekt. |
|
Der Name des Datasets. |
|
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. |
|
Das Bild, das das Tool in der Abdeckung eines Datensatzes anzeigt. Sie können diesen Parameter nicht verwenden. |
|
Sie können keine eigene |
|
Es gibt den MIME-Typ (Multipurpose Internet Mail Extensions) eines Thumbnails an. |
|
Es gibt JSON-Parameter an, wie |
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 |
---|---|
|
Der Namespace für das Objekt. |
|
Der Name des Datasets. |
|
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 |
Zugriffsberechtigung erteilen - Vorgehensweise
Diese Prozedur erteilt Zugriff auf das angegebene Dataset. Der Parameter für die Authentifizierungsinformationen muss die Freigabe-ID enthalten.
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.
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 Paketreferenz