EXPORT_TABLE_STATS

更新时间：2026-06-28 19:22:47

EXPORT_TABLE_STATS 过程用于导出表级的统计信息。

功能适用性

该内容仅适用于 OceanBase 数据库企业版。OceanBase 数据库社区版暂不支持。

语法

DBMS_STATS.EXPORT_TABLE_STATS (
  ownname           VARCHAR2,
  tabname           VARCHAR2,
  partname          VARCHAR2 DEFAULT NULL,
  stattab           VARCHAR2,
  statid            VARCHAR2 DEFAULT NULL,
  cascade           BOOLEAN  DEFAULT TRUE,
  statown           VARCHAR2 DEFAULT NULL,
  stat_category     VARCHAR2 DEFAULT DEFAULT_STAT_CATEGORY);

参数解释

参数	解释
ownname	用户名。如果用户名设置为 `NULL`，会默认使用当前登录的用户名。
tabname	表名称。
partname	表分区的名称。如果表已分区而 `partname` 为 `NULL`，则导出全局和分区列统计信息。
stattab	指定存储统计信息用户表的表名。
statid	说明当前版本暂不支持此参数。
cascade	是否一并导出列级的统计信息。默认为 `TRUE`。
statown	指定存储统计信息用户表的用户名称。
stat_category	说明当前版本暂不支持此参数。

异常情况

错误码 OBE-20000 表示该对象不存在或权限不足。

使用说明

要调用此过程，您必须是表的所有者。对于 SYS 拥有的对象，需要是表的所有者或具有 SYSDBA 权限才能调用此过程。
不支持跨不同字符集的数据库导出或导入统计信息。

示例

创建用户 testUser02 的统计信息用户表 test_stat。

obclient> CALL DBMS_STATS.CREATE_STAT_TABLE('testUser02', 'test_stat');
Query OK, 0 rows affected

将用户 testUser01 的 tbl1 表的统计信息导出到 test_stat 中。

obclient> CALL DBMS_STATS.EXPORT_TABLE_STATS('testUser01', 'tbl1', stattab=>'test_stat',
    statown=>'testUser02');
Query OK, 0 rows affected