DBMS_LIVE_FEED 套裝程式參照

本章提供您在 Data Studio 中搭配「資料載入工具」使用的套裝程式相關資訊。DBMS_LIVE_FEED 主題也涵蓋 DBMS_LIVE_FEED 套裝程式中包含的程序。

主題：

DBMS_LIVE_FEED 子程式摘要

  • DBMS_LIVE_FEED 子程式摘要
    DBMS_LIVE_FEED 套裝程式可簡化一般作業，例如視需要執行即時表格饋送、排程執行，或根據物件存放區儲存桶中的新物件更新表格通知導向的結果。

父項主題：資料載入頁面

DBMS_LIVE_FEED 子程式摘要

DBMS_LIVE_FEED 套裝程式可簡化一般作業，例如依需求、排程執行即時表格饋送，或根據物件存放區儲存桶中的新物件更新表格通知導向的結果。

DBMS_LIVE_FEED 套裝程式子程式

下表列出 DBMS_LIVE_FEED 子程式並簡短說明它們。

子程式 描述
建立儲存連結 (_F)

此程序會為儲存連結建立即時饋送。
建立目錄 (_F)

此程序會為目錄建立即時饋送。
建立 URL

此程序會從 URL 建立即時饋送。
修改即時饋送

此程序會修改即時饋送。
退房日期

此程序會刪除即時饋送。
載入新內容

此程序會在現有的 Live Feed 中載入新內容。
取得通知金鑰

此程序會從即時饋送擷取通知索引鍵。
取得確認 URL

此程序會從即時饋送接收確認 URL。
取得通知狀態

此程序會從 Live Feed 接收通知狀態。

建立儲存連結程序

此程序會從雲端儲存體連結建立即時表格饋送。雲端儲存連結是 OCI 儲存桶 URI 與本機證明資料名稱之間的具名關聯。

語法
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 參數

如果您正在存取 DBMS_LIVE_FEED 程序，請使用下列參數。

Parameter - 參數 描述

live_feed_name

您要建立的 Live Feed 的名稱。

storage_link_name

雲端儲存連結的名稱。連結的名稱應遵循標準 Oracle 命名慣例。

table_name

即時饋送將從 Cloud Object Storage 載入資料的 Autonomous Database 目標表格名稱。

Object_filter

即時饋送資料將載入 Autonomous Database 執行處理的目標表格名稱，以存取雲端物件儲存。

object_filter_type

將即時表格饋送限制為只顯示儲存桶中符合表示式之檔案的正規表示式。視 object_filter_type 參數而定，它可以是正規表示式或 glob。

scheduled

預設值為 TRUE。如果是 TRUE，您可以設定執行即時表格饋送物件的排程。

notifications

預設值為 FALSE。當 TRUE 時，Live Feed 工具允許物件儲存通知您的即時饋送有要載入的新檔案。

schema

綱要的名稱。

即時饋送的綱要名稱。目前只支援目前的綱要。

table_schema

目標表格的綱要。

object_type

物件的類型。您可以載入的檔案類型為 CSV、JSON 和 Parquet。

object_format

這是「SQL 載入器」選項之一。

它接受 DBMS_CLOUD.COPY_DATA 程序所收到的格式。

scheduler_interval

此參數顯示使用 DBMS_SCHEDULER 語法執行即時饋送的間隔。

job_class

Scheduler 工作類別。值為 TPURGENT,TP,HIGH,MEDIUM 和 LOW。

start_date

即時饋送工作的開始日期。

end_date

即時饋送工作的結束日期。

附註：

下表列出下述所有程序的參數。

範例

在此範例中，會在指定的 URL 上建立名為 MYLIVEFEED 的即時饋送。 

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.

為目錄程序建立

此程序會從目錄建立即時表格饋送。

語法

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

建立 URL 程序

此程序會從 URL 建立即時表格饋送。

語法

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

修改即時饋送程序

此程序會修改即時表格饋送。

語法

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

範例

在此範例中，已修改名為 MYLIVEFEED 的即時饋送。 

begin
   dbms_live_feed.modify_live_feed(
     live_feed_name => 'MYLIVEFEED',
     scheduled => true,
     scheduler_interval => 'FREQ=daily;INTERVAL=1',
     notifications => true);
end;
/

Drop Live Feed 程序

此程序會刪除即時表格饋送。

語法

procedure drop_live_feed(live_feed_name     IN VARCHAR2,
                                  schema             IN VARCHAR2 DEFAULT NULL);

範例

在此範例中，會刪除名為 MYLIVEFEED 的即時饋送。 

begin
   dbms_live_feed.drop_live_feed(live_feed_name => 'MYLIVEFEED');
end;
/

載入新內容程序

此程序會在摘要中載入新內容。

語法

 procedure load_new_content(live_feed_name IN VARCHAR2,
                                     schema         IN VARCHAR2 DEFAULT NULL);

取得通知索引鍵程序

此程序會接收「即時表格饋送通知索引鍵」。它是用於啟用通知的即時饋送，以建構提供雲端服務的通知 URL。依照建立通知型即時表格饋送章節中的指示，建立以通知為基礎的即時饋送。

語法

function get_notification_key(live_feed_name IN VARCHAR2,
                                       schema         IN VARCHAR2 DEFAULT NULL)
    return VARCHAR2;

取得確認 URL

此程序會收到確認 URL，此 URL 會驗證端點是否能夠接收通知。

您必須瀏覽此 URL，才能啟用從雲端服務收到的通知。由於資料庫防火牆限制，因此無法確認自動啟用通知。按一下此 URL 以啟用通知，否則您將不會收到任何通知。

語法

function get_confirmation_url(live_feed_name IN VARCHAR2,
                                       schema         IN VARCHAR2 DEFAULT NULL)
    return VARCHAR2;

取得通知狀態

此程序會收到 Live Feed 工作執行的通知狀態。

語法

 function get_notification_state(live_feed_name IN VARCHAR2,
                                          schema         IN VARCHAR2 DEFAULT NULL)
    return VARCHAR2;

父項主題：DBMS_LIVE_FEED 套裝程式參照