Prerequisites and Restrictions

When preparing to export optimizer statistics, note the following:

• Before exporting statistics, you must create a table to hold the statistics. The procedure DBMS_STATS.CREATE_STAT_TABLE creates the statistics table.

• The optimizer does not use statistics stored in a user-owned table. The only statistics used by the optimizer are the statistics stored in the data dictionary. To make the optimizer use statistics in user-defined tables, import these statistics into the data dictionary using the DBMS_STATS import procedure.

• The Data Pump Export and Import utilities export and import optimizer statistics from the database along with the table. When a column has system-generated names, Original Export (exp) does not export statistics with the data, but this restriction does not apply to Data Pump Export.

  Note:

  Exporting and importing statistics using DBMS_STATS is a distinct operation from using Data Pump Export and Import.

Assumptions

This tutorial assumes the following:

• You want to generate representative sh schema statistics on a production database and use DBMS_STATS to import them into a test database.

• Administrative user dba1 exists on both production and test databases.

• You intend to create table opt_stats to store the schema statistics.

• You intend to use Oracle Data Pump to export and import table opt_stats.

To generate schema statistics and import them into a separate database:

1. On the production host, start SQL*Plus and connect to the production database as administrator dba1.

2. Create a table to hold the production statistics.

   For example, execute the following PL/SQL program to create user statistics table opt_stats:

   BEGIN
     DBMS_STATS.CREATE_STAT_TABLE ( 
       ownname => 'dba1'
   ,   stattab => 'opt_stats'
   );
   END;
   /
   

3. Gather schema statistics.

   For example, manually gather schema statistics as follows:

   -- generate representative workload
   EXEC DBMS_STATS.GATHER_SCHEMA_STATS('SH');
   

4. Use DBMS_STATS to export the statistics.

   For example, retrieve schema statistics and store them in the opt_stats table created previously:

   BEGIN
     DBMS_STATS.EXPORT_SCHEMA_STATS (
       ownname => 'dba1'
   ,   stattab => 'opt_stats'
   );
   END;
   /
   

5. Use Oracle Data Pump to export the contents of the statistics table.

   For example, run the expdp command at the operating schema prompt:

   expdp dba1 DIRECTORY=dpump_dir1 DUMPFILE=stat.dmp TABLES=opt_stats
   

6. Transfer the dump file to the test database host.

7. Log in to the test host, and then use Oracle Data Pump to import the contents of the statistics table.

   For example, run the impdp command at the operating schema prompt:

   impdp dba1 DIRECTORY=dpump_dir1 DUMPFILE=stat.dmp TABLES=opt_stats 
   

8. On the test host, start SQL*Plus and connect to the test database as administrator dba1.

9. Use DBMS_STATS to import statistics from the user statistics table and store them in the data dictionary.

   The following PL/SQL program imports schema statistics from table opt_stats into the data dictionary:

   BEGIN
     DBMS_STATS.IMPORT_SCHEMA_STATS( 
       ownname => 'dba1'
   ,   stattab => 'opt_stats' 
   );
   END;
   /