执行 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。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-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')

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

重新启用 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()

为 Oracle 数据库实例启用大页

Amazon RDS for Oracle 支持 Linux 内核大页，提高了数据库扩展能力。大页会导致页表变小，花在内存管理上的 CPU 时间也减少，从而提高大数据库实例的性能。有关更多信息，请参阅 Oracle 文档中的巨页概述。

您可对下列 Oracle 数据库版本使用大页：

use_large_pages 参数控制是否为数据库实例启用大页。该参数的可能设置包括 ONLY、FALSE 和 {DBInstanceClassHugePagesDefault}。在 Oracle 的默认数据库参数组中，use_large_pages 参数设置为 {DBInstanceClassHugePagesDefault}。

要控制是否自动为数据库实例启用大页，您可以在参数组中使用 DBInstanceClassHugePagesDefault 公式变量。该值如下所示确定：

默认情况下，不为以下数据库实例类启用大页。

有关数据库实例类的更多信息，请参阅 的数据库实例类的硬件规格。

要为新的或现有的数据库实例手动启用大页，请将 use_large_pages 参数设置为 ONLY。大页不能与 Oracle 自动内存管理 (AMM) 一起使用。如果将 use_large_pages 参数设置为 ONLY，则还必须将 memory_target 和 memory_max_target 都设置为 0. 有关为数据库实例设置数据库参数的更多信息，请参阅使用参数组。

您也可以设置 sga_target、sga_max_size 和 pga_aggregate_target 参数。当设置系统全局区域 (SGA) 和程序全局区域 (PGA) 内存参数时，请将这些值加在一起。从可用实例内存 (DBInstanceClassMemory) 中减去此计算得到的总计值，可确定大页分配后的可用内存。必须保留至少 2 GiB 可用内存或总可用实例内存的 10% (取两者中较小的值)。

配置参数之后，必须重启数据库实例才能使更改生效。有关更多信息，请参阅“重启中的数据库实例”。

针对大页，以下示例参数配置手动启用大页。您应根据自己的需要设置这些值。

memory_target            = 0
memory_max_target        = 0
pga_aggregate_target     = {DBInstanceClassMemory*1/8}
sga_target               = {DBInstanceClassMemory*3/4}
sga_max_size             = {DBInstanceClassMemory*3/4}
use_large_pages          = ONLY

假设在参数组中设置以下参数值。

memory_target            = IF({DBInstanceClassHugePagesDefault}, 0, {DBInstanceClassMemory*3/4})
memory_max_target        = IF({DBInstanceClassHugePagesDefault}, 0, {DBInstanceClassMemory*3/4})
pga_aggregate_target     = IF({DBInstanceClassHugePagesDefault}, {DBInstanceClassMemory*1/8}, 0)
sga_target               = IF({DBInstanceClassHugePagesDefault}, {DBInstanceClassMemory*3/4}, 0)
sga_max_size             = IF({DBInstanceClassHugePagesDefault}, {DBInstanceClassMemory*3/4}, 0)
use_large_pages          = {DBInstanceClassHugePagesDefault}

参数组由内存小于 100 GiB 的 db.r4 数据库实例类使用。如果使用这些参数设置并将 use_large_pages 设置为 {DBInstanceClassHugePagesDefault}，则会在 db.r4 实例上启用 HugePages。

请考虑在参数组中设置了以下参数值的另一个示例。

memory_target           = IF({DBInstanceClassHugePagesDefault}, 0, {DBInstanceClassMemory*3/4})
memory_max_target       = IF({DBInstanceClassHugePagesDefault}, 0, {DBInstanceClassMemory*3/4})
pga_aggregate_target    = IF({DBInstanceClassHugePagesDefault}, {DBInstanceClassMemory*1/8}, 0)
sga_target              = IF({DBInstanceClassHugePagesDefault}, {DBInstanceClassMemory*3/4}, 0)
sga_max_size            = IF({DBInstanceClassHugePagesDefault}, {DBInstanceClassMemory*3/4}, 0)
use_large_pages         = FALSE
        

该参数组由内存小于 100 GiB 的 db.r4 数据库实例类和 db.r5 数据库实例类使用。使用这些参数设置，则将在 db.r4 和 db.r5 实例上禁用 HugePages。

当大页在数据库实例上处于活动状态后，您可以启用增强监控以查看大页信息。有关更多信息，请参阅“使用增强监控来监控操作系统指标”。

启用扩展数据类型

Amazon RDS Oracle Database 12c 支持扩展的数据类型。对于扩展数据类型，VARCHAR2、NVARCHAR2 和 RAW 数据类型的最大大小为 32,767 字节。要使用扩展数据类型，请将 MAX_STRING_SIZE 参数设置为 EXTENDED。有关更多信息，请参阅 Oracle 文档中的扩展数据类型。

如果您不希望使用扩展数据类型，请将 MAX_STRING_SIZE 参数设置为 STANDARD（默认值）。在将该参数设置为 STANDARD 时，VARCHAR2 和 NVARCHAR2 数据类型的大小限制为 4,000 字节，RAW 数据类型的大小限制为 2,000 字节。

您可以在新的或现有的数据库实例上启用扩展数据类型。对于新的数据库实例，在启用扩展数据类型时，数据库实例的创建时间通常较长。对于现有的数据库实例，数据库实例在转换过程中不可用。

下面是启用了扩展数据类型的数据库实例的注意事项：

如果由于 incompatible-parameters 设置而导致数据库实例状态为 MAX_STRING_SIZE，数据库实例将保持不可用状态，直到您将 MAX_STRING_SIZE 参数设置为 EXTENDED 并重新引导数据库实例。

为新数据库实例启用扩展数据类型

为现有数据库实例启用扩展数据类型

在修改数据库实例以启用扩展数据类型时，将转换数据库中的数据以使用扩展大小。数据库实例在转换期间不可用。转换数据所需的时间取决于数据库实例使用的数据库实例类和数据库大小。