Call now: 252-767-6166  
Oracle Training Oracle Support Development Oracle Apps

 E-mail Us
 Oracle Articles
New Oracle Articles

 Oracle Training
 Oracle Tips

 Oracle Forum
 Class Catalog

 Remote DBA
 Oracle Tuning
 Emergency 911
 RAC Support
 Apps Support
 Oracle Support

 SQL Tuning

 Oracle UNIX
 Oracle Linux
 Remote s
 Remote plans
 Application Server

 Oracle Forms
 Oracle Portal
 App Upgrades
 SQL Server
 Oracle Concepts
 Software Support

 Remote S


 Consulting Staff
 Consulting Prices
 Help Wanted!


 Oracle Posters
 Oracle Books

 Oracle Scripts

Don Burleson Blog 







Oracle SQL Repair Advisor

Oracle Database Tips by Donald Burleson

Advanced Oracle Utilities: The Definitive Reference by Rampant TechPress is written by four of the top Oracle database experts (Bert Scalzo, Andrew Kerber, Donald Burleson, and Steve Callan).  The following is an excerpt from the book.

The SQL Repair Advisor can be accessed via OEM or via a command-line API using the DBMS_SQLDIAG PL/SQL built-in. Two types of failures can be worked on - those related to incidents and those which are not. The distinction is that statement failure(s) related to an incident will be part of the incident package. Non-incident failures can be worked on via the SQL Worksheet and also through the Support Workbench.


The GUI approach is basically enter a query, select links related to the repair advisor, and attempt to apply a SQL patch if available. The SQL patch (not a patch as in a download from MOSC) is a query transformation of the original statement. If the patch is accepted, then the original repairable SQL can be entered and the transformation will take care of the fix.


The difficulty in testing this is finding a statement that can be repaired. If the DBA comes across one, the steps to repair via DBMS_SQLDIAG are shown below.


A statement is run, and an error is returned. The test table t is a copy of EMP in the SCOTT schema.



  2  (SELECT MAX(ROWID) FROM scott.t1 GROUP by empno);

(SELECT MAX(ROWID) FROM scott.t1 GROUP by empno)


ERROR at line 2:

ORA-01427: single-row subquery returns more than one row


Create a diagnosis task using the CREATE_DIAGNOSIS_TASK subprogram. Pass in the SQL text and assign a task name for identification later.



  report_out clob;

  task_id varchar2(50);



    sql_text => 'DELETE FROM t1 WHERE ROWID <>

                (SELECT MAX(ROWID) FROM t1 GROUP by empno)',






Optionally, view the task by querying from DBA_ADVISOR_TASKS.


SELECT task_id, task_name,

to_char(created,'DD-MON HH24:MI'),

advisor_name, status

FROM dba_advisor_tasks



------- ---------- ------------ ------------------ ---------

     54 test_task1 21-SEP 19:30 SQL Repair Advisor COMPLETED


Execute the diagnosis and generate a report.


exec dbms_sqldiag.execute_diagnosis_task('test_task1');



 rep_out CLOB;


  rep_out := dbms_sqldiag.report_diagnosis_task('test_task1',



  dbms_output.put_line('Report : ' || rep_out);




The output from the report can be lengthy. Part of what the API tries is using different optimizer settings based on version. The extract below shows a path from to and this is just a snippet.


- Plan for

strategy optimizer features enabled toggle with plan directive


OPTIMIZER_FEATURES_ENABLE('') has cost 7 with plan hash

  value 3950489424

- Plan for

strategy optimizer features enabled toggle with plan directive


OPTIMIZER_FEATURES_ENABLE('') has cost 7 with plan hash

  value 3950489424

- Plan for

strategy optimizer features enabled toggle with plan directive


OPTIMIZER_FEATURES_ENABLE('') has cost 7 with plan hash

  value 3950489424    


If a patch is recommended, apply it.



 (task_name => 'test_task1', task_owner => 'SYS');


If needed or desired, then delete the task.


exec DBMS_SQLTUNE.DROP_TUNING_TASK(task_name => 'test_task1');


Overall, the SQL Repair Advisor is pretty easy to use, especially within OEM. The command-line API can be somewhat cryptic at times, depending on which subprogram the DBA is trying to use.



Oracle Training at Sea
oracle dba poster

Follow us on Twitter 
Oracle performance tuning software 
Oracle Linux poster


Burleson is the American Team

Note: This Oracle documentation was created as a support and Oracle training reference for use by our DBA performance tuning consulting professionals.  Feel free to ask questions on our Oracle forum.

Verify experience! Anyone considering using the services of an Oracle support expert should independently investigate their credentials and experience, and not rely on advertisements and self-proclaimed expertise. All legitimate Oracle experts publish their Oracle qualifications.

Errata?  Oracle technology is changing and we strive to update our BC Oracle support information.  If you find an error or have a suggestion for improving our content, we would appreciate your feedback.  Just  e-mail:  

and include the URL for the page.


Burleson Consulting

The Oracle of Database Support

Oracle Performance Tuning

Remote DBA Services


Copyright © 1996 -  2020

All rights reserved by Burleson

Oracle ® is the registered trademark of Oracle Corporation.