DBMS_DATAMART Referência de Pacote

Este capítulo fornece informações sobre os pacotes que você usa com a Ferramenta Data Marketplace no Data Studio. O tópico DBMS_DATAMART também abrange os procedimentos incluídos no pacote DBMS_DATAMART. O pacote DBMS_DATAMART fornece APIs para suportar operações comuns com o Data Marketplace.

Resumo de Subprogramas DBMS_DATAMART

Você pode usar as APIs do Oracle Data Marketplace para registrar e acessar conjuntos de dados.

DBMS_DATAMART Subprogramas do Pacote

O pacote DBMS_DATAMART simplifica operações comuns com o Oracle Data Marketplace, como registrar objetos, solicitar acesso, conceder acesso, revogar acesso, cancelar registro e listar conjuntos de dados.

A tabela a seguir lista os subprogramas DBMS_DATAMART e os descreve brevemente.

Subprograma Descrição
register_object

Este procedimento registra conjuntos de dados.

request_access

Este procedimento solicita acesso a um conjunto de dados específico.

grant_access

Este procedimento concede acesso a um conjunto de dados específico.

revoke_access

Este procedimento revoga o acesso a um conjunto de dados específico.

cancelar o registro

Este procedimento cancela o registro de um conjunto de dados.

list_data_sets

Este procedimento retorna a lista de conjuntos de dados.

get_stock_image_urls

Este procedimento retorna a base de URL da qual você pode selecionar imagens.

get_reserved_namespaces

Este procedimento exibe um array JSON de namespaces que são reservados pelo sistema e não podem ser usados por você.

update_registration

Este procedimento atualiza um registro existente.

Registrar Procedimento do Objeto

Este procedimento registra conjuntos de dados.

Sintaxe

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 do Objeto

Se você estiver acessando procedimentos Register Object, use os parâmetros a seguir.

Parâmetro Descrição

schema_name

O nome do esquema.

object_name

O nome do objeto.

namespace

O namespace do objeto.

data_set_name

O nome do conjunto de dados.

scope

Este parâmetro indica quem pode acessar remotamente os dados. O escopo pode ser definido para vários níveis, inclusive para a região em que o banco de dados reside, para tenancies individuais ou para compartimentos. MY$REGION não é suportado.

thumbnail

A imagem que a ferramenta exibe na capa de um conjunto de dados. Você não pode usar este parâmetro.

thumbnail_url

Você não pode especificar seu próprio thumbnail_url. A Oracle fornece esse parâmetro.

thumbnail_mime_type

Ele especifica o tipo de miniatura MIME (Multipurpose Internet Mail Extensions).

Parameters

Ele especifica parâmetros JSON, como tags, description, data_set_owner, authorization_required, offload_targets, offload_targets e store_sample.

Procedimento de Solicitação de Acesso

Este procedimento solicita acesso ao conjunto de dados especificado.

Sintaxe

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

Solicitar Parâmetros de Acesso

Se você estiver acessando o procedimento Request Access, use os parâmetros a seguir.

Parâmetro Descrição

Namespace

O namespace do objeto.

Dataset name

O nome do conjunto de dados.

Auth Info

Este parâmetro é gerado preenchido como JSON ao retornar. Se o provedor do conjunto de dados tiver fornecido um endereço de e-mail e o usuário solicitante tiver configurado suas definições SMTP do Data Studio, a solicitação será enviada por e-mail e esse parâmetro será gerado com o campo delivery definido como SMTP. Caso contrário, o campo delivery será definido como browser e você deverá usar o restante dos metadados para enviar sua própria solicitação por e-mail.

Conceder Procedimento de Acesso

Este procedimento concede acesso ao conjunto de dados especificado. O parâmetro de informações de autorização deve conter o ID de Compartilhamento.

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

Procedimento de Revogação de Acesso

Este procedimento revoga o acesso ao conjunto de dados especificado. O parâmetro de informações de autorização deve conter o ID de Compartilhamento.

Sintaxe

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

Cancelar Registro do Procedimento

Este procedimento revoga o acesso ao conjunto de dados especificado. O parâmetro de informações de autorização deve conter o ID de Compartilhamento.

Sintaxe

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

Listar Procedimento do Conjunto de Dados

Este procedimento exibe uma lista de conjuntos de dados.

Sintaxe

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

Se registrations for true, ele retornará a lista de conjuntos de dados registrados. Se false, ele retornará os conjuntos de dados disponíveis.

Obter Procedimento de URL de Imagem de Estoque

Este procedimento exibe o URL do qual você pode selecionar imagens.

Sintaxe

function get_stock_image_url return varchar2;

Obter Procedimento de Namespaces Reservados

Este procedimento exibe o array JSON de namespaces reservados pelo sistema. Você não pode usar esses namespaces.

Sintaxe

function get_reserved_namespaces return clob;

Atualizar Procedimento de Registro

Este procedimento atualiza um registro existente.

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

Os parâmetros deste procedimento já estão descritos acima.