The IMPORT_SCHEMA_STATS procedure imports the statistics on all tables of the specified user.
Applicability
This topic applies only to OceanBase Database Enterprise Edition. OceanBase Database Community Edition provides only the MySQL mode.
Syntax
DBMS_STATS.IMPORT_SCHEMA_STATS (
ownname VARCHAR2,
stattab VARCHAR2,
statown VARCHAR2 DEFAULT NULL,
no_invalidate BOOLEAN DEFAULT FALSE,
force BOOLEAN DEFAULT FALSE
);
Parameters
| Parameter | Description |
|---|---|
| ownname | The username. If the parameter is set to NULL, the current login username is used by default. |
| stattab | The name of the statistics user table from which the statistics are retrieved. |
| statown | The username of the user statistics table from which the statistics are retrieved. |
| no_invalidate | Specifies whether to refresh the plan cache during statistics collection. If you set the value to TRUE, the plan cache will not be refreshed during statistics collection. |
| force | Specifies whether to perform forced import and ignore the lock status. The default value is FALSE. If you set the value to TRUE, statistics will be imported even if they are locked. |
Exceptions
| Error code | Description |
|---|---|
| OBE-20000 | The object does not exist, or you do not have the required privileges. |
| OBE-20001 | The values in the user statistics table are invalid or inconsistent. |
Considerations
To call this procedure, you must be the owner of the table. To call this procedure on a table object owned by the
SYSuser, you must be the table owner or have theSYSDBAprivilege.You cannot export or import statistics across databases that use different character sets.
Examples
Import the statistics on all tables of the hr user from the test_stat table owned by the testUser01 user.
obclient> CALL DBMS_STATS.IMPORT_SCHEMA_STATS(ownname=>'hr', stattab=>'test_stat', statown=>'testUser01');
Query OK, 0 rows affected