PolarDB PostgreSQL版（兼容Oracle）提供了DBMS_STATS包，用于收集數據庫運行過程中的統計信息，提供現有統計信息的備份，并支持將備份統計項進行還原。您可以自定義備份統計信息的時間點，根據需求修改表的統計信息，從而輔助優化器生成期望中的執行計劃。

前提條件

  • 已安裝polar_dbms_stats插件，安裝命令如下：
    CREATE EXTENSION polar_dbms_stats;
  • polar_dbms_stats.use_locked_stats參數的狀態為on。
    說明 您可以通過如下命令查看該參數的狀態：
    SHOW polar_dbms_stats.use_locked_stats;

準備測試數據

說明 測試數據僅適用本文中的操作示例。
  1. 創建Schema，名為dbms_stats_schema。
    CREATE SCHEMA dbms_stats_schema;
  2. 創建表，名為dbms_stats_test。
    CREATE TABLE dbms_stats_schema.dbms_stats_test(id int);
  3. 創建索引。
    CREATE INDEX dbms_stats_index on dbms_stats_schema.dbms_stats_test(id);
  4. 插入數據。
    INSERT INTO dbms_stats_schema.dbms_stats_test values (generate_series(1,10000));

DBMS_STATS.GATHER_SCHEMA_STATS

該函數用于收集和備份Schema級的統計信息。

語法

DBMS_STATS.GATHER_SCHEMA_STATS (
        ownname          VARCHAR2
    );

參數

參數描述是否必填
ownname待分析的Schema名稱。是

示例

收集和備份Schema級的統計信息，示例如下：

CALL DBMS_STATS.GATHER_SCHEMA_STATS('dbms_stats_schema');

查詢統計信息的備份情況，查詢示例如下：

SELECT * FROM polar_dbms_stats.backup_history;

DBMS_STATS.GATHER_TABLE_STATS

該函數用于收集和備份表級的統計信息。

語法

DBMS_STATS.GATHER_TABLE_STATS (
        ownname          VARCHAR2, 
        tabname          VARCHAR2
    );

參數

參數描述是否必填
ownname待分析的表所屬的Schema。是
tabname待分析的表名稱。是

示例

收集并備份表級的統計信息，示例如下：

CALL DBMS_STATS.GATHER_TABLE_STATS('dbms_stats_schema', 'dbms_stats_test');

查詢統計信息備份情況，查詢示例如下：

SELECT * FROM polar_dbms_stats.backup_history;

DBMS_STATS.GATHER_DATABASE_STATS

該函數用于收集和備份數據庫級的統計信息。

語法

DBMS_STATS.GATHER_DATABASE_STATS ();

示例

收集并備份數據庫級的統計信息，示例如下：

CALL DBMS_STATS.GATHER_DATABASE_STATS();

查詢統計信息備份情況，查詢示例如下：

SELECT * FROM polar_dbms_stats.backup_history;

DBMS_STATS.GATHER_INDEX_STATS

該函數用于收集和備份索引的統計信息。

語法

DBMS_STATS.GATHER_INDEX_STATS (
        ownname          VARCHAR2, 
        indname          VARCHAR2
    );

參數

參數描述是否必填
ownname待分析的索引所屬的Schema。是
indname待分析的索引名稱。是

示例

收集并備份索引級的統計信息，示例如下：

CALL DBMS_STATS.GATHER_INDEX_STATS('dbms_stats_schema', 'dbms_stats_index');

查詢統計信息備份情況，查詢示例如下：

SELECT * FROM polar_dbms_stats.backup_history;

DBMS_STATS.GATHER_COLUMN_STATS

該函數用于收集和備份指定列的統計信息。

語法

DBMS_STATS.GATHER_COLUMN_STATS (
        ownname         VARCHAR2,
        tablename       VARCHAR2,
        attname         TEXT
    );

參數

參數描述是否必填
ownname待分析的列所屬的Schema。是
tablename待分析的列所屬的表。是
attname待分析的列名稱。是

示例

收集并備份指定列的統計信息，示例如下：

CALL DBMS_STATS.GATHER_COLUMN_STATS('dbms_stats_schema', 'dbms_stats_test', 'id');

查詢統計信息備份情況，查詢示例如下：

SELECT * FROM polar_dbms_stats.backup_history;

DBMS_STATS.RESTORE_SCHEMA_STATS

該函數用于還原指定Schema的統計信息。

語法

DBMS_STATS.RESTORE_SCHEMA_STATS (
        ownname                VARCHAR2, 
        as_of_timestamp        TIMESTAMP WITH TIME ZONE
    );

參數

參數描述是否必填
ownname待還原的Schema名稱。是
as_of_timestamp待還原的時間點。是

示例

還原指定Schema的統計信息，示例如下：

SELECT DBMS_STATS.RESTORE_SCHEMA_STATS('dbms_stats_schema',time) FROM polar_dbms_stats.backup_history WHERE unit='s';

查詢還原后的統計信息，示例如下：

SELECT count(*) FROM polar_dbms_stats.relation_stats_locked WHERE relname LIKE 'dbms_stats_schema%';

DBMS_STATS.RESTORE_DATABASE_STATS

該函數用于還原數據庫的統計信息。

語法

DBMS_STATS.RESTORE_DATABASE_STATS (
        as_of_timestamp        TIMESTAMP WITH TIME ZONE
    );

參數

參數描述是否必填
as_of_timestamp待還原的時間點。是

示例

還原數據庫統計信息，示例如下：

SELECT DBMS_STATS.RESTORE_DATABASE_STATS(time) FROM polar_dbms_stats.backup_history WHERE unit='d';

查詢還原后的統計信息，示例如下：

SELECT count(*) FROM polar_dbms_stats.relation_stats_locked WHERE relname LIKE 'dbms_stats_schema%';

DBMS_STATS.RESTORE_TABLE_STATS

該函數用于還原指定表的統計信息。

語法

DBMS_STATS.RESTORE_TABLE_STATS (
        ownname                   VARCHAR2, 
        tabname                   VARCHAR2, 
        as_of_timestamp           TIMESTAMP WITH TIME ZONE
    );

參數

參數描述是否必填
ownname待還原的表所屬的Schema。是
tabname待還原的表名稱。是
as_of_timestamp待還原的時間點。是

示例

還原指定表統計信息，示例如下：

SELECT DBMS_STATS.RESTORE_TABLE_STATS('dbms_stats_schema', 'dbms_stats_test', time) FROM polar_dbms_stats.backup_history WHERE unit='t';

查詢還原后的統計信息，示例如下：

SELECT count(*) FROM polar_dbms_stats.relation_stats_locked WHERE relname LIKE 'dbms_stats_schema%';

DBMS_STATS.RESTORE_COLUMN_STATS

該函數用于還原指定列的統計信息。

語法

DBMS_STATS.RESTORE_COLUMN_STATS (
        ownname         TEXT,
        tablename       TEXT,
        attname         TEXT,
        as_of_timestamp timestamp with time zone
    );

參數

參數描述是否必填
ownname待還原的列所屬的Schema。是
tabname待還原的列所屬的表。是
attname待還原的列名。是
as_of_timestamp待還原的時間點。是

示例

還原指定列統計信息，示例如下：

SELECT DBMS_STATS.RESTORE_COLUMN_STATS('dbms_stats_schema', 'dbms_stats_test', 'id', time) FROM polar_dbms_stats.backup_history WHERE unit='c';

查詢還原后的統計信息，示例如下：

SELECT count(*) FROM polar_dbms_stats.relation_stats_locked WHERE relname LIKE 'dbms_stats_schema%';

DBMS_STATS.PURGE_STATS

該函數用于刪除指定時間點之前的統計信息備份。

語法

DBMS_STATS.PURGE_STATS (
        before_timestamp timestamp
    );

參數

參數描述是否必填
before_timestamp指定的刪除時間點。是

示例

刪除指定時間點之前的統計信息備份，示例如下：

SELECT DBMS_STATS.PURGE_STATS(time) FROM polar_dbms_stats.backup_history WHERE unit='c';

DBMS_STATS.SET_TABLE_STATS

該函數用于設置指定表的統計信息。

說明 在進行set_table_stats前，如果沒有采集相關表的統計信息，需要先執行gather_schema_stats或者gather_table_stats。

語法

DBMS_STATS.SET_TABLE_STATS (
        ownname       VARCHAR2, 
        tabname       VARCHAR2, 
        numrows       NUMBER   DEFAULT NULL, 
        numblks       NUMBER   DEFAULT NULL
    );

參數

參數描述是否必填
ownname待設置的表所屬的Schema。是
tabname待設置的表名稱。是
numrows設置的表行數。是
numblks設置的表塊數。是

示例

設置表的統計信息，示例如下：

CALL DBMS_STATS.SET_TABLE_STATS('dbms_stats_schema', 'dbms_stats_test', 1234, 4321);

DBMS_STATS.GET_TABLE_STATS

該函數用于獲取指定表的統計信息。

語法

DBMS_STATS.GET_TABLE_STATS (
        ownname       VARCHAR2, 
        tabname       VARCHAR2, 
        numrows       OUT NUMBER, 
        numblks       OUT NUMBER
    );

參數

參數描述是否必填
ownname待獲取的表所屬的Schema。是
tabname待獲取的表名稱。是
numrows獲取的表行數。是
numblks獲取的表塊數。是

示例

獲取表的統計信息，示例如下：

DECLARE
    numrows integer;
    numblks integer;
BEGIN
    CALL DBMS_STATS.GET_TABLE_STATS('dbms_stats_schema', 'dbms_stats_test', numrows, numblks);
    raise notice '%', numrows;
    raise notice '%', numblks;
END;

DBMS_STATS.SET_INDEX_STATS

該函數用于設置索引的統計信息。

語法

DBMS_STATS.SET_INDEX_STATS (
        ownname       VARCHAR2,
        indname       VARCHAR2,
        numrows       NUMBER   DEFAULT NULL, 
        numblks       NUMBER   DEFAULT NULL
    );

參數

參數描述是否必填
ownname待設置的索引所屬的Schema。是
indname待設置的索引名稱。是
numrows設置的索引行數。是
numblks設置的索引塊數。是

示例

設置索引的統計信息，示例如下：

CALL DBMS_STATS.SET_INDEX_STATS('dbms_stats_schema', 'dbms_stats_index', 2345, 5432);

DBMS_STATS.GET_INDEX_STATS

該函數用于獲取指定索引的統計信息。

語法

DBMS_STATS.GET_INDEX_STATS (
        ownname       VARCHAR2, 
        tabname       VARCHAR2, 
        numrows       OUT NUMBER, 
        numblks       OUT NUMBER
    );

參數

參數描述是否必填
ownname待獲取的索引所屬的Schema。是
tabname待獲取的索引名稱。是
numrows獲取的索引行數。是
numblks獲取的索引塊數。是

示例

獲取索引的統計信息，示例如下：

DECLARE
    numrows integer;
    numblks integer;
BEGIN
    CALL DBMS_STATS.GET_INDEX_STATS('dbms_stats_schema', 'dbms_stats_index', numrows, numblks);
    raise notice '%', numrows;
    raise notice '%', numblks;
END;

DBMS_STATS.GET_COLUMN_STATS

該函數用于獲取指定列的統計信息。

語法

DBMS_STATS.GET_COLUMN_STATS (
        ownname       VARCHAR2, 
        tabname       VARCHAR2, 
        colname       VARCHAR2, 
        distcnt OUT NUMBER, 
        nullcnt OUT NUMBER, 
        avgclen OUT NUMBER
    );

參數

參數描述是否必填
ownname待獲取的列所屬的Schema。是
tabname待獲取的列所屬的表。是
colname待獲取的列名稱。是
distcnt獲取的列中不同值的數量。是
nullcnt獲取的列空值數量。是
avgclen獲取的列平均長度。是

示例

獲取列的統計信息，示例如下：

DECLARE
    distcnt integer;
    nullcnt integer;
    avgclen integer;
BEGIN
    CALL DBMS_STATS.GET_COLUMN_STATS('dbms_stats_schema', 'dbms_stats_test', 'id', distcnt, nullcnt, avgclen);
    raise notice '%', distcnt;
    raise notice '%', nullcnt;
    raise notice '%', avgclen;
END;

DBMS_STATS.LOCK_TABLE_STATS

該函數用于鎖定正在使用的表統計信息。

語法

DBMS_STATS.LOCK_TABLE_STATS (
        ownname       VARCHAR2, 
        tabname       VARCHAR2 
    );

參數

參數描述是否必填
ownname待鎖定的表所屬的Schema。是
tabname待鎖定的表名稱。是

示例

鎖定正在使用的表的統計信息，示例如下：

CALL DBMS_STATS.LOCK_TABLE_STATS('dbms_stats_schema', 'dbms_stats_test');

查看鎖定的統計信息，示例如下：

SELECT count(*) FROM polar_dbms_stats.relation_stats_locked WHERE relname = 'dbms_stats_schema.dbms_stats_test';

DBMS_STATS.UNLOCK_TABLE_STATS

該函數用于解鎖正在使用的表統計信息。

語法

DBMS_STATS.UNLOCK_TABLE_STATS (
        ownname       VARCHAR2, 
        tabname       VARCHAR2 
    );

參數

參數描述是否必填
ownname待解鎖的表所屬的Schema。是
tabname待解鎖的表名稱。是

示例

解鎖正在使用的表的統計信息，示例如下：

CALL DBMS_STATS.UNLOCK_TABLE_STATS('dbms_stats_schema', 'dbms_stats_test');

查看鎖定的統計信息，示例如下：

SELECT count(*) FROM polar_dbms_stats.relation_stats_locked WHERE relname = 'dbms_stats_schema.dbms_stats_test';

DBMS_STATS.LOCK_SCHEMA_STATS

該函數用于鎖定正在使用的Schema的統計信息。

語法

DBMS_STATS.LOCK_SCHEMA_STATS (
        ownname       VARCHAR2
    );

參數

參數描述是否必填
ownname待鎖定的Schema名稱。是

示例

鎖定正在使用的Schema的統計信息，示例如下：

CALL DBMS_STATS.LOCK_SCHEMA_STATS('dbms_stats_schema');

查看鎖定的統計信息，示例如下：

SELECT count(*) FROM polar_dbms_stats.relation_stats_locked WHERE relname LIKE 'dbms_stats_schema.%';

DBMS_STATS.UNLOCK_SCHEMA_STATS

該函數用于解鎖正在使用的Schema的統計信息。

語法

DBMS_STATS.UNLOCK_SCHEMA_STATS (
        ownname       VARCHAR2
    );

參數

參數描述是否必填
ownname待解鎖的Schema名稱。是

示例

解鎖正在使用的Schema的統計信息，示例如下：

CALL DBMS_STATS.UNLOCK_SCHEMA_STATS('dbms_stats_schema');

查看鎖定的統計信息，示例如下：

SELECT count(*) FROM polar_dbms_stats.relation_stats_locked WHERE relname LIKE 'dbms_stats_schema.%';

DBMS_STATS.LOCK_COLUMN_STATS

該函數用于鎖定正在使用的列的統計信息。

語法

DBMS_STATS.LOCK_COLUMN_STATS (
        ownname       VARCHAR2, 
        tabname       VARCHAR2, 
        attname       VARCHAR2
    );

參數

參數描述是否必填
ownname待鎖定的列所屬的Schema。是
tabname待鎖定的列所屬的表。是
attname待鎖定的列名稱。是

示例

鎖定正在使用的列的統計信息，示例如下：

CALL DBMS_STATS.LOCK_COLUMN_STATS('dbms_stats_schema', 'dbms_stats_test', 'id');

DBMS_STATS.UNLOCK_COLUMN_STATS

該函數用于解鎖正在使用的列的統計信息。

語法

DBMS_STATS.UNLOCK_COLUMN_STATS (
        ownname       VARCHAR2, 
        tabname       VARCHAR2, 
        attname       VARCHAR2
    );

參數

參數描述是否必填
ownname待解鎖的列所屬的Schema。是
tabname待解鎖的列所屬的表。是
attname待解鎖的列名稱。是

示例

解鎖正在使用的列的統計信息，示例如下：

CALL DBMS_STATS.UNLOCK_COLUMN_STATS('dbms_stats_schema', 'dbms_stats_test', 'id');

DBMS_STATS.DELETE_TABLE_STATS

該函數用于刪除已有的表統計信息。

語法

DBMS_STATS.DELETE_TABLE_STATS (
        ownname       VARCHAR2, 
        tabname       VARCHAR2
    );

參數

參數描述是否必填
ownname待刪除的表所屬的Schema。是
tabname待刪除的表名稱。是

示例

刪除已有的表統計信息，示例如下：

CALL DBMS_STATS.DELETE_TABLE_STATS('dbms_stats_schema', 'dbms_stats_test');

查看刪除后的表統計信息，示例如下：

SELECT count(*) FROM polar_dbms_stats.relation_stats_backup WHERE relname = 'dbms_stats_schema.dbms_stats_test';

DBMS_STATS.DELETE_COLUMN_STATS

該函數用于刪除已有的列統計信息。

語法

DBMS_STATS.DELETE_COLUMN_STATS (
        ownname       VARCHAR2, 
        tabname       VARCHAR2,
        attname       VARCHAR2
    );

參數

參數描述是否必填
ownname待刪除的列所屬的Schema。是
tabname待刪除的列所屬的表。是
attname待刪除的列名稱。是

示例

刪除已有的列統計信息，示例如下：

CALL DBMS_STATS.DELETE_COLUMN_STATS('dbms_stats_schema', 'dbms_stats_test', 'id');

DBMS_STATS.DELETE_SCHEMA_STATS

該函數用于刪除已有的Schema對象統計信息。

語法

DBMS_STATS.DELETE_SCHEMA_STATS (
        ownname       VARCHAR2 
    );

參數

參數描述是否必填
ownname待刪除的Schema名稱。是

示例

刪除已有的Schema統計信息，示例如下：

CALL DBMS_STATS.DELETE_SCHEMA_STATS('dbms_stats_schema');

查詢刪除后的統計信息，示例如下：

SELECT count(*) FROM polar_dbms_stats.relation_stats_backup WHERE relname LIKE 'dbms_stats_schema.%';

DBMS_STATS.DELETE_INDEX_STATS

該函數用于刪除已有的索引對象統計信息。

語法

DBMS_STATS.DELETE_INDEX_STATS (
        ownname       VARCHAR2,
        indname       VARCHAR2 
    );

參數

參數描述是否必填
ownname待刪除的索引所屬的Schema。是
indname待刪除的索引名稱。是

示例

刪除已有的索引統計信息，示例如下：

CALL DBMS_STATS.DELETE_INDEX_STATS('dbms_stats_schema', 'dbms_stats_index');

查詢刪除后的統計信息，示例如下：

SELECT count(*) FROM polar_dbms_stats.relation_stats_backup WHERE relname LIKE 'dbms_stats_schema.%';