DBMS_LIVE_FEED Referência do Pacote
Este capítulo fornece informações sobre os pacotes que você usa com a Ferramenta de Carregamento de Dados no Data Studio. O tópico DBMS_LIVE_FEED
também abrange os procedimentos incluídos no pacote DBMS_LIVE_FEED
.
- Resumo de Subprogramas DBMS_LIVE_FEED
O pacoteDBMS_LIVE_FEED
simplifica operações comuns, como executar um feed de tabela ao vivo sob demanda, em uma programação ou como resultado de atualizações orientadas por notificação para uma tabela com base em novos objetos em buckets de armazenamento de objetos.
Tópico pai: Página Carga de Dados
Resumo dos Subprogramas DBMS_LIVE_FEED
O pacote DBMS_LIVE_FEED
simplifica operações comuns, como executar um feed de tabela ao vivo sob demanda, em uma programação ou como resultado de atualizações orientadas por notificação para uma tabela com base em novos objetos em buckets de armazenamento de objetos.
Subprogramas do Pacote DBMS_LIVE_FEED
A tabela a seguir lista os subprogramas DBMS_LIVE_FEED
e os descreve brevemente.
Subprograma | Descrição |
---|---|
create_for_storage_link |
Este procedimento cria um link de feed ativo para armazenamento. |
create_for_directory |
Este procedimento cria um feed ativo para o diretório. |
create_for_url |
Este procedimento cria um feed ativo a partir do URL. |
modify_live_feed |
Este procedimento modifica um feed ativo. |
drop_live_feed |
Este procedimento elimina um feed ativo. |
load_new_content |
Este procedimento carrega novo conteúdo em um Live Feed existente. |
get_notification_key |
Este procedimento recupera a Chave de Notificação de um Feed Ativo. |
get_confirmation_url |
Este procedimento recebe o URL de confirmação de um feed ao vivo. |
get_notification_state |
Este procedimento recebe o estado de notificação de um RSS. |
Criar para Procedimento de Link de Armazenamento
Este procedimento cria um feed de tabela ativa a partir de um link de armazenamento na nuvem. Um link de armazenamento na nuvem é uma associação nomeada entre um URI de bucket do OCI e um nome de credencial local.
procedure create_for_storage_link(live_feed_name IN VARCHAR2,
table_name IN VARCHAR2,
storage_link_name IN VARCHAR2,
schema IN VARCHAR2 DEFAULT NULL,
table_schema IN VARCHAR2 DEFAULT NULL,
column_list IN CLOB DEFAULT NULL,
object_type IN VARCHAR2 DEFAULT NULL,
object_format IN VARCHAR2 DEFAULT NULL,
object_filter IN VARCHAR2 DEFAULT NULL,
object_filter_type IN VARCHAR2 DEFAULT NULL,
scheduled IN BOOLEAN DEFAULT NULL,
scheduler_interval IN VARCHAR2 DEFAULT NULL,
notifications IN BOOLEAN DEFAULT NULL,
job_class IN VARCHAR2 DEFAULT NULL,
start_date IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
end_date IN TIMESTAMP WITH TIME ZONE DEFAULT NULL);
DBMS_ LIVE_FEED Parâmetros
Se você estiver acessando procedimentos DBMS_LIVE_FEED
, use os parâmetros a seguir.
Parâmetro | Descrição |
---|---|
|
O nome do feed ao vivo que deseja criar. |
|
O nome do link de armazenamento na nuvem. O nome do link deve seguir as convenções de nomenclatura padrão da Oracle. |
|
O nome da tabela de destino do Autonomous Database na qual o feed ativo carregará dados do Cloud Object Storage. |
|
O nome da tabela de destino na qual os dados do feed ativo serão carregados na sua instância do Autonomous Database para acessar o Cloud Object Storage. |
|
A expressão regular para limitar o feed de tabela ativa somente aos arquivos no bucket que correspondem à expressão. Pode ser uma expressão regular ou um glob, dependendo do parâmetro |
|
O padrão é |
|
O padrão é |
|
O nome do esquema. O nome do esquema do livefeed. Somente o esquema atual é suportado no momento. |
|
O esquema da tabela de destino. |
|
O tipo do objeto. Os tipos de arquivos que você pode carregar são CSV, JSON e Parquet. |
|
Esta é uma das opções do SQL Loader. Aceita o formato recebido pelo procedimento |
|
Esse parâmetro exibe o intervalo no qual o livefeed é executado usando a sintaxe |
|
A classe de job do Scheduler. Os valores são |
|
A data inicial da tarefa de alimentação ativa. |
|
A data final do trabalho de feed ao vivo. |
Os parâmetros de todos os procedimentos descritos abaixo são listados na tabela acima.
Exemplo
Neste exemplo, um feed ao vivo chamado MYLIVEFEED
é criado no URL fornecido.
SQL> BEGIN
dbms_live_feed.create_for_storage_link(
live_feed_name => 'MYLIVEFEED',
storage_link_name => 'DATATOOLS_LF_BUCKET',
table_name => 'MALTESE',
object_filter => 'fndcalday?.csv',
object_filter_type => 'GLOB',
scheduled => false,
notifications => false);
end;
/;
PL/SQL procedure successfully completed.
Criar para Procedimento de Diretório
Este procedimento cria um feed de tabela ativa a partir de um diretório.
Sintaxe
procedure create_for_directory(live_feed_name IN VARCHAR2,
table_name IN VARCHAR2,
directory_name IN VARCHAR2,
schema IN VARCHAR2 DEFAULT NULL,
table_schema IN VARCHAR2 DEFAULT NULL,
column_list IN CLOB DEFAULT NULL,
object_type IN VARCHAR2 DEFAULT NULL,
object_format IN VARCHAR2 DEFAULT NULL,
object_filter IN VARCHAR2 DEFAULT NULL,
object_filter_type IN VARCHAR2 DEFAULT NULL,
scheduled IN BOOLEAN DEFAULT NULL,
scheduler_interval IN VARCHAR2 DEFAULT NULL,
notifications IN BOOLEAN DEFAULT NULL,
job_class IN VARCHAR2 DEFAULT NULL,
start_date IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
end_date IN TIMESTAMP WITH TIME ZONE DEFAULT NULL);
Criar para Procedimento de URL
Este procedimento cria um feed de tabela ativa a partir de um URL.
Sintaxe
procedure create_for_url(live_feed_name IN VARCHAR2,
table_name IN VARCHAR2,
url IN VARCHAR2,
credential_name IN VARCHAR2,
schema IN VARCHAR2 DEFAULT NULL,
table_schema IN VARCHAR2 DEFAULT NULL,
column_list IN CLOB DEFAULT NULL,
object_type IN VARCHAR2 DEFAULT NULL,
object_format IN VARCHAR2 DEFAULT NULL,
object_filter IN VARCHAR2 DEFAULT NULL,
object_filter_type IN VARCHAR2 DEFAULT NULL,
scheduled IN BOOLEAN DEFAULT NULL,
scheduler_interval IN VARCHAR2 DEFAULT NULL,
notifications IN BOOLEAN DEFAULT NULL,
job_class IN VARCHAR2 DEFAULT NULL,
start_date IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
end_date IN TIMESTAMP WITH TIME ZONE DEFAULT NULL);
Modificar Procedimento do Live Feed
Este procedimento modifica um feed de tabela ativa.
Sintaxe
procedure modify_live_feed(live_feed_name IN VARCHAR2,
schema IN VARCHAR2 DEFAULT NULL,
scheduled IN BOOLEAN DEFAULT NULL,
scheduler_interval IN VARCHAR2 DEFAULT NULL,
notifications IN BOOLEAN DEFAULT NULL,
job_class IN VARCHAR2 DEFAULT NULL,
start_date IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
end_date IN TIMESTAMP WITH TIME ZONE DEFAULT NULL);
Exemplo
Neste exemplo, um feed ao vivo chamado MYLIVEFEED
é modificado.
begin
dbms_live_feed.modify_live_feed(
live_feed_name => 'MYLIVEFEED',
scheduled => true,
scheduler_interval => 'FREQ=daily;INTERVAL=1',
notifications => true);
end;
/
Procedimento Drop Live Feed
Este procedimento elimina um feed de tabela ativa.
Sintaxe
procedure drop_live_feed(live_feed_name IN VARCHAR2,
schema IN VARCHAR2 DEFAULT NULL);
Exemplo
Neste exemplo, um feed ao vivo chamado MYLIVEFEED
é eliminado.
begin
dbms_live_feed.drop_live_feed(live_feed_name => 'MYLIVEFEED');
end;
/
Carregar novo procedimento de conteúdo
Este procedimento carrega novo conteúdo no feed.
Sintaxe
procedure load_new_content(live_feed_name IN VARCHAR2,
schema IN VARCHAR2 DEFAULT NULL);
Obter Procedimento da Chave de Notificação
Este procedimento recebe a Chave de Notificação do Feed da Tabela Ativa. Ele é usado para um feed ao vivo com notificações ativadas para construir um URL de notificação para fornecer um serviço de nuvem. Siga as instruções no capítulo Criando um Feed de Tabela ao Vivo Baseado em Notificação para criar um feed ao vivo baseado em notificação.
Sintaxe
function get_notification_key(live_feed_name IN VARCHAR2,
schema IN VARCHAR2 DEFAULT NULL)
return VARCHAR2;
Obter URL de Confirmação
Este procedimento recebe o URL de confirmação que verifica se o ponto final pode receber notificações.
Você deve visitar este URL para ativar as notificações que recebe de um serviço de nuvem. Não é possível confirmar a ativação de notificações automaticamente devido a restrições de firewall de banco de dados. Clique neste URL para ativar as notificações; caso contrário, você não receberá nenhuma notificação.
Sintaxe
function get_confirmation_url(live_feed_name IN VARCHAR2,
schema IN VARCHAR2 DEFAULT NULL)
return VARCHAR2;
Obter Estado da Notificação
Este procedimento recebe o estado de notificação da execução do job do Live Feed.
Sintaxe
function get_notification_state(live_feed_name IN VARCHAR2,
schema IN VARCHAR2 DEFAULT NULL)
return VARCHAR2;
Tópico principal: Referência do Pacote DBMS_LIVE_FEED