Documentación de Oracle Cloud Infrastructure

Referencia de Paquete DBMS_DATAMART

En este capítulo se proporciona información sobre los paquetes que se utilizan 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 Data Marketplace

Resumen de subprogramas DBMS_DATAMART

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

Subprogramas de Paquete DBMS_DATAMART

El paquete DBMS_DATAMART simplifica las operaciones comunes con Oracle Data Marketplace, como el registro de objetos, la solicitud de acceso, la concesión de acceso, la revocación de acceso, la anulación del registro y la enumeración de 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 juegos de datos.
request_access

Este procedimiento solicita acceso a un conjunto 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 juegos 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 reservados por el sistema y que no puede utilizar.
update_registration

Este procedimiento actualiza un registro existente.

Registrar procedimiento de objeto

Este procedimiento registra los juegos 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 está accediendo 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 conjunto de datos.

scope

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

thumbnail

Imagen que muestra la herramienta en la portada de un conjunto 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 de 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 conjunto de datos.

Auth Info

Este parámetro se genera rellenado como JSON a la devolución. Si el proveedor del juego de datos ha proporcionado una dirección de correo electrónico y el usuario solicitante ha configurado la 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 concesión de acceso

Este procedimiento otorga acceso al juego de datos especificado. El parámetro auth info debe contener el ID de uso compartido.

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

Procedimiento de revocación de acceso

Este procedimiento revoca el acceso al juego de datos especificado. El parámetro auth info 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 auth info debe contener el ID de uso compartido.

Sintaxis

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

Lista - Procedimiento de juego 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 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 para obtener 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.