Oracle | DBMS_AWR_WAREHOUSE

Oracle DBMS_AWR_WAREHOUSE_SOURCE Version 23c

General Information

Library Note

Morgan's Library Page Header

ACE Director Alum Daniel Morgan, founder of Morgan's Library, is scheduling complimentary technical Workshops on Database Security for the first 30 Oracle Database customers located anywhere in North America, EMEA, LATAM, or APAC that send an email to asra_us@oracle.com. Request a Workshop for your organization today.

Purpose Utilities used to configure a source database to utilize an AWR Warehouse Database.

AUTHID DEFINER

Dependencies

DBMS_AWRHUB_SOURCE

DBMS_AWRWH_LIB

DBMS_WORKLOAD_REPOSITORY

Documented No

Exceptions

Error Code	Reason
ORA-13554	`The database is not registered as a AWRHub source`
ORA-13571	AWR import or export operation failed: Unsupported API
ORA-13572	Input parameters to AWRHub operation are invalid: Invalid packaging method input string

First Available 19c

Security Model Owned by SYS with EXECUTE granted to DBA

Source {ORACLE_HOME}/rdbms/admin/dbmsawr.sql

Subprograms

CONFIGURE_SOURCE	MODIFY_PACKAGING_METHOD	REGISTER_AWR_DELIVERY_SERVICE
GET_MAILPKG_TO_DELIVER	NOTIFY_MAILPKG_DELIVERED	UNCONFIG_SOURCE

CONFIGURE_SOURCE

Configures the source database to utilize the specified warehouse dbms_awr_warehouse_source.config_source( src_name IN VARCHAR2, warehouse_name IN VARCHAR2, mailbox_loc IN VARCHAR2);

TBD

GET_MAILPKG_TO_DELIVER

Retrieves one mail package (i.e., AWR dump file) that is ready to send to the warehouse dbms_awr_warehouse_source.get_mailpkg_to_deliver( mpkname OUT VARCHAR2, mpkname_l IN NUMBER, mbloc OUT VARCHAR2, mbloc_l IN NUMBER) RETURN BOOLEAN;

TBD

MODIFY_PACKAGING_METHOD

Enables modifying the packaging method to APS or DATAPUMP dbms_awr_warehouse_source.modify_packaging_method(pkg_method IN VARCHAR2);

exec dbms_awr_warehouse_source.modify_packaging_method('DATAPUMP');

      

      PL/SQL procedure successfully completed.

NOTIFY_MAILPKG_DELIVERED

Invoked at an AWR warehouse client to notify the database that the provided package has successfully delivered to the warehouse dbms_awr_warehouse_source.notify_mailpkg_delivered(mpk_name IN VARCHAR2);

exec dbms_awr_warehouse_source.drop_warehouse('ZZYZX');

      *

      ORA-13565: The database is not registered as a AWRHub source.

REGISTER_AWR_DELIVERY_SERVICE

Registers the AWR delivery service for moving an AWR mail package from the source to the warehouse site by RDBMS kernel dbms_awr_warehouse_source.register_awr_delivery_service(server_mailbox IN VARCHAR2);

exec dbms_awr_warehouse_source.register_awr_delivery_service('CLOUD');

      *

      ORA-13571: AWR import or export operation failed: Unsupported API

UNCONFIG_SOURCE

Unconfigures the database as an AWR warehouse source dbms_awr_warehouse_source.unconfig_source;

exec dbms_awr_warehouse_source.unconfig_source;

      *

      ORA-13565: The database is not registered as a AWRHub source.