Documentación de Oracle Cloud Infrastructure

DBMS_DATAMART Referencia del Paquete

Esta sección proporciona información sobre los paquetes utilizados con la herramienta Data Marketplace en Data Studio. El tema DBMS_DATAMART también abarca los procedimientos incluidos en el paquete DBMS_DATAMART. El paquete DBMS_DATAMART proporciona API para soportar operaciones comunes con Data Marketplace.

Tema principal: Herramienta de Data Marketplace

Resumen de Subprogramas DBMS_DATAMART

Puede utilizar las API de Oracle Data Marketplace para registrar y acceder a conjuntos de datos.

Subprogramas del Paquete DBMS_DATAMART

El paquete DBMS_DATAMART simplifica las operaciones comunes con Oracle Data Marketplace, como registrar objetos, solicitar acceso, otorgar acceso, revocar acceso, anular el registro y mostrar juegos de datos.

En la siguiente tabla, se muestran los subprogramas DBMS_DATAMART y se describen brevemente.

Subprograma Descripción
register_object

Este procedimiento registra los conjuntos de datos.
request_access

Este procedimiento solicita acceso a un juego de datos específico.
grant_access

Este procedimiento otorga acceso a un juego de datos específico.
revoke_access

Este procedimiento revoca el acceso a un juego de datos específico.
anular registro

Este procedimiento anula el registro de un juego de datos.
list_data_sets

Este procedimiento devuelve la lista de conjuntos de datos.
get_stock_image_urls

Este procedimiento devuelve la base de URL desde la que puede seleccionar imágenes.
get_reserved_namespaces

Este procedimiento muestra una matriz de JSON de espacios de nombres que el sistema reserva y que no puede utilizar.
update_registration

Este procedimiento actualiza un registro existente.

Registrar procedimiento de objeto

Este procedimiento registra los conjuntos de datos.

Sintaxis

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

Registrar parámetros de objeto

Si accede a los procedimientos Register Object, utilice los siguientes parámetros.

Parámetro Descripción

schema_name

Nombre del esquema.

object_name

Nombre del objeto.

namespace

Espacio de nombres para el objeto.

data_set_name

El nombre del juego de datos.

scope

Este parámetro indica quién puede acceder de forma remota a los datos. El ámbito se puede definir en varios niveles, incluidos la región en la que reside la base de datos, los arrendamientos individuales o los compartimentos. MY$REGION no está soportado.

thumbnail

Imagen que muestra la herramienta en la portada de un juego de datos. No puede utilizar este parámetro.

thumbnail_url

No puede especificar su propio thumbnail_url. Oracle proporciona este parámetro.

thumbnail_mime_type

Especifica el tipo de miniatura Multipurpose Internet Mail Extensions (MIME).

Parameters

Especifica parámetros JSON como tags, description, data_set_owner, authorization_required, offload_targets, offload_targets y store_sample.

Procedimiento de solicitud de acceso

Este procedimiento solicita acceso al juego de datos especificado.

Sintaxis

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

Parámetros de acceso de solicitud

Si está accediendo al procedimiento Request Access, utilice los siguientes parámetros.

Parámetro Descripción

Namespace

Espacio de nombres para el objeto.

Dataset name

El nombre del juego de datos.

Auth Info

Este parámetro se genera como JSON en la devolución. Si el proveedor del conjunto de datos ha proporcionado una dirección de correo electrónico y el usuario solicitante ha configurado su configuración SMTP de Data Studio, la solicitud se enviará por correo electrónico y este parámetro se generará con el campo delivery definido en SMTP. De lo contrario, el campo delivery se definirá en browser y debe utilizar el resto de los metadatos para enviar su propia solicitud por correo electrónico.

Procedimiento de acceso de otorgamiento

Este procedimiento otorga acceso al juego de datos especificado. El parámetro de información de autenticación debe contener el ID de uso compartido.

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

Revocar procedimiento de acceso

Este procedimiento revoca el acceso al juego de datos especificado. El parámetro de información de autenticación debe contener el ID de uso compartido.

Sintaxis

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

Anular registro de procedimiento

Este procedimiento revoca el acceso al juego de datos especificado. El parámetro de información de autenticación debe contener el ID de uso compartido.

Sintaxis

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

Enumerar procedimiento de conjunto de datos

Este procedimiento muestra una lista de conjuntos de datos.

Sintaxis

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

Si registrations es true, devuelve la lista de juegos de datos que registra. Si es false, devuelve los juegos de datos disponibles.

Obtener procedimiento de URL de imagen de stock

Este procedimiento muestra la URL desde la que puede seleccionar imágenes.

Sintaxis

function get_stock_image_url return varchar2;

Procedimiento de obtención de espacios de nombres reservados

Este procedimiento muestra la matriz JSON de espacios de nombres reservados por el sistema. No puede utilizar estos espacios de nombres.

Sintaxis

function get_reserved_namespaces return clob;

Actualizar procedimiento de registro

Este procedimiento actualiza un registro existente.

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

Los parámetros de este procedimiento ya se han descrito anteriormente.