首批通过分布式安全可靠测评，为关键业务系统打造
GATHER_SCHEMA_STATS
更新时间：2026-07-03 17:33:53
编辑
分享
GATHER_SCHEMA_STATS 过程用于收集指定 Schema 中所有对象的统计信息。
语法
DBMS_STATS.GATHER_SCHEMA_STATS (
ownname VARCHAR2,
estimate_percent NUMBER DEFAULT AUTO_SAMPLE_SIZE,
block_sample BOOLEAN DEFAULT FALSE,
method_opt VARCHAR2 DEFAULT DEFAULT_METHOD_OPT,
degree NUMBER DEFAULT NULL,
granularity VARCHAR2 DEFAULT DEFAULT_GRANULARITY,
cascade BOOLEAN DEFAULT NULL,
no_invalidate BOOLEAN DEFAULT FALSE,
stattype VARCHAR2 DEFAULT 'DATA',
force BOOLEAN DEFAULT FALSE);
参数说明
| 参数 | 解释 |
|---|---|
| ownname | 表所在的 Schema。 |
| estimate_percent | 预估行的百分比。有效范围为 [0.000001,100]。 |
| block_sample | 确定数据库是使用随机块抽样 (TRUE) 还是随机行抽样 (FALSE)。默认值为 FALSE。随机块采样效率更高，但如果数据不是随机分布在磁盘上，那么样本值可能存在相关性。 |
| method_opt | 在全局、Schema、数据库或字典级别设置首选项时，只允许使用 FOR ALL 语法。除此之外，method_opt 只能为以下选项之一，或两者的组合：
FOR ALL COLUMNS SIZE AUTO。 |
| degree | 并行度。默认值是 NULL。NULL 表示使用由 CREATE TABLE 或 ALTER TABLE 语句中的 DEGREE 子句指定的表默认值。当使用 DEGREE=>NULL、DEGREE=>n 时，如果对象的大小不保证实现并行执行，则 DBMS_STATS 可能会使用串行执行。 |
| granularity | 要收集的统计信息的粒度（仅适用于当表已分区时）。
|
| cascade | 除了收集表和列统计信息之外，还会收集有关索引的统计信息，等效于在 Schema 中的每个索引上运行 GATHER_INDEX_STATS 过程。 |
| no_invalidate | 收集统计信息时是否刷 Plan Cache。设置为 TRUE 表示收集统计信息时不刷 Plan Cache。 |
| stattype | 当前统计信息所存储的位置。 |
| force | 是否强制收集，并忽略锁的状态。默认为 FALSE。如果设置为 TRUE，即使统计信息被锁定，也会收集统计信息。 |
异常情况
| 错误码 | 描述 |
|---|---|
| HY000 |
|
使用说明
要调用此过程，必须是表的所有者。对于使用由 SYS 所拥有的对象，需要是表的所有者或具有 SYSDBA 权限才能调用此过程。
示例
收集 hr Schema 下所有表的统计信息。
obclient> CALL DBMS_STATS.GATHER_SCHEMA_STATS ('hr', degree=>64,no_invalidate=>TRUE);
Query OK, 0 rows affected
相关文档
更多关于收集指定 Schema 中所有对象统计信息的介绍，参见 手动统计信息收集。
