执行 Oracle 数据库实例的其他任务

下文中介绍了如何在运行 Oracle 的 Amazon RDS 数据库实例上执行其他 DBA 任务。为了提供托管服务体验，Amazon RDS 不允许通过 shell 访问数据库实例，而仅限访问某些需要高级权限的系统过程和表。

在主数据存储空间中创建和删除目录

要创建目录，请使用 Amazon RDS 过程 rdsadmin.rdsadmin_util.create_directory。您可以创建最多 10000 个目录 (全部位于主数据存储空间中)。要删除目录，请使用 Amazon RDS 过程 rdsadmin.rdsadmin_util.drop_directory。

create_directory 和 drop_directory 过程具有以下必需参数。

以下示例创建一个名为 PRODUCT_DESCRIPTIONS 的新目录。

EXEC rdsadmin.rdsadmin_util.create_directory(p_directory_name => 'product_descriptions');

数据字典以大写形式存储目录名称。您可以通过查询 DBA_DIRECTORIES 列出目录。系统将自动选择实际主机路径名称。以下示例获取名为 PRODUCT_DESCRIPTIONS 的目录的目录路径：

SELECT DIRECTORY_PATH 
  FROM DBA_DIRECTORIES 
 WHERE DIRECTORY_NAME='PRODUCT_DESCRIPTIONS';
        
DIRECTORY_PATH
----------------------------------------
/rdsdbdata/userdirs/01

数据库实例的主用户名在新目录中拥有读取和写入权限，可以向其他用户授予访问权限。EXECUTE 权限不可用于数据库实例上的目录。目录在您的主数据存储空间中创建，将占用空间和 I/O 带宽。

以下示例删除名为 PRODUCT_DESCRIPTIONS 的目录。

EXEC rdsadmin.rdsadmin_util.drop_directory(p_directory_name => 'product_descriptions');

删除目录不会删除其内容。由于 rdsadmin.rdsadmin_util.create_directory 过程可重用路径名称，因此，删除的目录中的文件会显示在新创建的目录中。在您删除目录之前，我们建议您使用 UTL_FILE.FREMOVE 从目录中删除文件。有关更多信息，请参阅 Oracle 文档中的 FREMOVE 过程。

列出数据库实例目录中的文件

要列出目录中的文件，请使用 Amazon RDS 过程 rdsadmin.rds_file_util.listdir。Oracle 副本不支持此过程。listdir 过程具有以下参数。

以下示例将目录 PRODUCT_DESCRIPTIONS 的读/写权限授予用户 rdsadmin，然后列出此目录中的文件。

GRANT READ,WRITE ON DIRECTORY PRODUCT_DESCRIPTIONS TO rdsadmin;
SELECT * FROM TABLE(rdsadmin.rds_file_util.listdir(p_directory => 'PRODUCT_DESCRIPTIONS'));

读取数据库实例目录中的文件

要读取文本文件，请使用 Amazon RDS 过程 rdsadmin.rds_file_util.read_text_file。read_text_file 过程具有以下参数。

以下示例在 rice.txt 目录中创建 PRODUCT_DESCRIPTIONS 文件。

declare
  fh sys.utl_file.file_type;
begin
  fh := utl_file.fopen(location=>'PRODUCT_DESCRIPTIONS', filename=>'rice.txt', open_mode=>'w');
  utl_file.put(file=>fh, buffer=>'AnyCompany brown rice, 15 lbs');
  utl_file.fclose(file=>fh);
end;
/

以下示例读取目录 rice.txt 中的文件 PRODUCT_DESCRIPTIONS。

SELECT * FROM TABLE
    (rdsadmin.rds_file_util.read_text_file(
        p_directory => 'PRODUCT_DESCRIPTIONS',
        p_filename  => 'rice.txt'));

访问 Opatch 文件

Opatch 是一个 Oracle 实用程序，可用于将修补程序应用和回滚到 Oracle 软件。用于确定哪些修补程序已应用于数据库的 Oracle 机制是 opatch lsinventory 命令。为了向自带许可 (BYOL) 客户打开服务请求，Oracle 支持部门会请求 lsinventory 文件，有时还请求由 Opatch 生成的 lsinventory_detail 文件。

为提供托管服务体验，Amazon RDS 未提供对 Opatch 的 Shell 访问权限。相反，lsinventory-dbv.txt 包含与当前引擎版本相关的修补程序信息。当您执行次要或主要升级时，Amazon RDS 会在应用补丁后的一小时内更新 lsinventory-dbv.txt。要验证应用的补丁，请参阅lsinventory-dbv.txt。该操作类似于运行 opatch lsinventory 命令。

清单文件使用 Amazon RDS 命名约定 lsinventory-dbv.txt 和 lsinventory_detail-dbv.txt，其中 dbv 是数据库版本的全名。lsinventory-dbv.txt 文件在所有数据库版本上均可用。对应的 lsinventory_detail-dbv.txt 在 19.0.0.0、ru-2020-01.rur-2020-01.r1 或更高版本上可用。

例如，如果您的数据库版本为 19.0.0.0.ru-2021-07.rur-2021-07.r1，则您的清单文件具有以下名称。

lsinventory-19.0.0.0.ru-2021-07.rur-2021-07.r1.txt
lsinventory_detail-19.0.0.0.ru-2021-07.rur-2021-07.r1.txt

确保下载与当前版本的数据库引擎匹配的文件。

SELECT text
FROM   TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'lsinventory-dbv.txt'));

SET SERVEROUTPUT ON
DECLARE
  v_file              SYS.UTL_FILE.FILE_TYPE;
  v_line              VARCHAR2(1000);
  v_oracle_home_type  VARCHAR2(1000);
  c_directory         VARCHAR2(30) := 'BDUMP';
  c_output_file       VARCHAR2(30) := 'lsinventory-dbv.txt';
BEGIN
  v_file := SYS.UTL_FILE.FOPEN(c_directory, c_output_file, 'r');
  LOOP
    BEGIN
      SYS.UTL_FILE.GET_LINE(v_file, v_line,1000);
      DBMS_OUTPUT.PUT_LINE(v_line);
    EXCEPTION
      WHEN no_data_found THEN
        EXIT;
    END;
  END LOOP;
END;
/

SPOOL /tmp/tracefile.txt
SELECT * 
FROM   rdsadmin.tracefile_listing 
WHERE  FILENAME LIKE 'lsinventory%';
SPOOL OFF;

管理顾问任务

Oracle 数据库中包含许多顾问。每个顾问都支持自动化任务和手动任务。您可以使用 rdsadmin.rdsadmin_util 程序包中的过程来管理一些顾问任务。

以下引擎版本中提供了顾问任务过程：

设置顾问任务参数

要为某些顾问任务设置参数，请使用 Amazon RDS 程序 rdsadmin.rdsadmin_util.advisor_task_set_parameter。advisor_task_set_parameter 过程具有以下参数。

COL PARAMETER_NAME FORMAT a30
COL PARAMETER_VALUE FORMAT a30
SELECT PARAMETER_NAME, PARAMETER_VALUE
FROM DBA_ADVISOR_PARAMETERS
WHERE TASK_NAME='p_task_name'
AND PARAMETER_VALUE != 'UNUSED'
ORDER BY PARAMETER_NAME;

COL PARAMETER_NAME FORMAT a30
COL PARAMETER_VALUE FORMAT a30
SELECT PARAMETER_NAME, PARAMETER_VALUE
FROM DBA_ADVISOR_PARAMETERS
WHERE TASK_NAME='p_task_name'
AND PARAMETER_VALUE != 'UNUSED'
ORDER BY PARAMETER_NAME;

对于 ACCEPT_PLANS，以下 PL/SQL 程序可将 FALSE 设置为 SYS_AUTO_SPM_EVOLVE_TASK。SQL Plan Management 自动化任务可验证计划并生成其调查结果的报告，但不会自动发展计划。您可以使用报告来识别新的 SQL 计划基准并手动接受它们。

BEGIN 
  rdsadmin.rdsadmin_util.advisor_task_set_parameter(
    p_task_name => 'SYS_AUTO_SPM_EVOLVE_TASK',
    p_parameter => 'ACCEPT_PLANS',
    p_value     => 'FALSE');
END;

对于 EXECUTION_DAYS_TO_EXPIRE，以下 PL/SQL 程序可将 10 设置为 AUTO_STATS_ADVISOR_TASK。预定义的任务 AUTO_STATS_ADVISOR_TASK 每天在维护时段自动运行一次。该示例将任务执行的保留周期设置为 10 天。

BEGIN 
  rdsadmin.rdsadmin_util.advisor_task_set_parameter(
    p_task_name => 'AUTO_STATS_ADVISOR_TASK',
    p_parameter => 'EXECUTION_DAYS_TO_EXPIRE',
    p_value     => '10');
END;

禁用 AUTO_STATS_ADVISOR_TASK

要禁用 AUTO_STATS_ADVISOR_TASK，请使用 Amazon RDS 过程 rdsadmin.rdsadmin_util.advisor_task_drop。advisor_task_drop 过程接受以下参数。

以下命令可删除 AUTO_STATS_ADVISOR_TASK。

EXEC rdsadmin.rdsadmin_util.advisor_task_drop('AUTO_STATS_ADVISOR_TASK')

您可以使用 rdsadmin.rdsadmin_util.dbms_stats_init 重新启用 AUTO_STATS_ADVISOR_TASK。

重新启用 AUTO_STATS_ADVISOR_TASK

要重新启用 AUTO_STATS_ADVISOR_TASK，请使用 Amazon RDS 过程 rdsadmin.rdsadmin_util.dbms_stats_init。dbms_stats_init 过程不需要任何参数。

以下命令可重新启用 AUTO_STATS_ADVISOR_TASK。

EXEC rdsadmin.rdsadmin_util.dbms_stats_init()