OceanBase管理数据库统计信息收集策略 Prefs 配置项管理功能

统计信息 Prefs 主要用于配置统计信息收集过程中收集策略的默认值，例如 granularity、method_opt 等的默认值。

统计信息收集策略 Prefs 配置项

Oracle 模式下提供如下虚拟表来查询当前设置的 Prefs：

• SYS.ALL_VIRTUAL_OPTSTAT_GLOBAL_PREFS_REAL_AGENT 用于查询 GLOBAL 级的 Prefs设置。

• SYS.ALL_VIRTUAL_OPTSTAT_USER_PREFS_REAL_AGENT 用于查询表级的 Prefs 设置。

可配置的统计信息收集策略 Prefs 如下表所示。

统计信息策略 Prefs 设置与获取

全局统计信息策略 Prefs 设置与获取

全局统计信息策略 Prefs 通过如下存储过程进行设置与获取：

• reset_global_pref_defaults

• reset_param_defaults

• set_global_prefs

• set_param

• get_param

具体的定义如下：

PROCEDURE reset_global_pref_defaults;

PROCEDURE reset_param_defaults;

PROCEDURE set_global_prefs(
  pname         VARCHAR2,
  pvalue        VARCHAR2
);

PROCEDURE set_param(
  pname          VARCHAR2,
  pval           VARCHAR2
);

FUNCTION get_param (
  pname           VARCHAR2
)RETURN VARCHAR2;

参数解释如下：

• pname：Prefs 的名字。

• pvalue：Prefs 的值。

表级的统计信息策略 Prefs 设置与获取

表级统计信息策略 Prefs 通过如下存储过程进行设置与获取：

• set_schema_prefs

• set_table_prefs

• delete_schema_prefs

• delete_table_prefs

• get_prefs

具体的定义如下：

PROCEDURE set_schema_prefs(
  ownname        VARCHAR2,
  pname          VARCHAR2,
  pvalue         VARCHAR2
);

PROCEDURE set_table_prefs(
  ownname        VARCHAR2,
  tabname        VARCHAR2,
  pname          VARCHAR2,
  pvalue         VARCHAR2
);

PROCEDURE delete_schema_prefs(
  ownname        VARCHAR2,
  pname          VARCHAR2
);

PROCEDURE delete_table_prefs (
  ownname        VARCHAR2,
  tabname        VARCHAR2,
  pname          VARCHAR2
);

FUNCTION get_prefs (
  pname           VARCHAR2,
  ownname         VARCHAR2 DEFAULT NULL,
  tabname         VARCHAR2 DEFAULT NULL
) RETURN VARCHAR2;

参数解释如下表所示。

示例

• 设置全局级别的 APPROXIMATE_NDV 默认值为 FALSE。

  CALL dbms_stats.set_global_prefs('APPROXIMATE_NDV', 'FALSE');
  

• 还原全局级别的所有 Prefs 默认值。

  CALL reset_global_pref_defaults();
  

• 设置用户 test 的 tbl1 的收集策略的 DEGREE 默认值为 128。

  CALL dbms_stats.set_table_prefs('test', 'tbl1', 'DEGREE', '128');
  

• 删除用户 test 的 tbl1 的收集策略的 DEGREE 默认值。

  CALL dbms_stats.delete_table_prefs('test', 'tbl1', 'DEGREE');