![\"CapturePlantxt.PNG\"](\"https://www.dbi-services.com/blog/wp-content/uploads/sites/2/2022/04/CapturePlantxt.png\" "\\"CapturePlantxt.PNG\\"")
.
\nYou have a query that takes too long and you want help to analyze the execution plan? Then you need to get it with relevant information, and correctly formatted. Autotrace is not a good option as it does not bind the variables in the same way as your application. Explain plan only shows estimations, but if we have a performance issue, this probably means that the estimation is wrong. I prefer SQL Monitoring when we have Tuning Pack, or the cursor plan with row-source statistics in all other cases. If you post it in a forum, don’t forget to keep it formatted or it’s impossible to read.
Here are the two ways I prefer to get an execution plan, depending on whether you have the tuning pack licence or not.
\nI set the sqlplus environment to nicely spool to text file and set the STATISTICS_LEVEL to ALL in order to gather plan execution statistics:
\n\nset pagesize 10000 linesize 300 trimspool on serveroutput off\nalter session set statistics_level=all;\nThen I execute the query. Don’t forget to set the current_schema to the user that executes the statement, and to bind variables:
\n\n-- set the schema\nalter session set current_schema=SCOTT;\n-- define variables\nvariable minimum_salary number\n-- bind values\nexec :minimum_salary := 3000\n-- execute the query\nSELECT * FROM DEPT JOIN EMP USING(DEPTNO) WHERE SAL>:minimum_salary;\nFinally I get the execution plan to a text file:
\n\nspool plan.txt\nselect * from table(dbms_xplan.display_cursor(format=>'allstats last +outline +peeked_binds +cost'));\nspool off\nThe plan will have both the estimations (E-Rows) and the actual number of rows (A-Rows) from the last execution. Note that if it is a parallel query statement, you must omit the ‘last’ in the format or you will have statistics only for the coordinator process.
\nWhen you have tuning pack, you have access to the great SQL monitoring feature.
\n\nSQL> show parameter pack\nNAME TYPE VALUE\n ------------------------------------ ----------- ------------------------------\n control_management_pack_access string DIAGNOSTIC+TUNING\nI set the sqlplus environment to nicely spool to html file:
\n\nset pagesize 0 linesize 10000 trimspool on serveroutput off long 1000000 longc 1000000 echo off feedback off\nThen I execute the query. Don’t forget to set the current_schema to the user that executes the statement, and to bind variables.
\nOne difference here: the MONITOR hint to force SQL Monitoring.
\n\n-- set the schema\nalter session set current_schema=SCOTT;\n-- define variables\nvariable minimum_salary number\n-- bind values\nexec :minimum_salary := 3000\n-- execute the query\nSELECT /*+ monitor */ * FROM DEPT JOIN EMP USING(DEPTNO) WHERE SAL>:minimum_salary;Finally, get the execution plan to a html file:
\n\n-- in 12c avoid compression of xml because there is additional information:\nalter session set events='emx_control compress_xml=none';\n-- errors with French NLS_LANG\nalter session set NLS_NUMERIC_CHARACTERS=',.';\n\nspool plan.htm\nselect dbms_sqltune.report_sql_monitor(report_level=>'all',type=>'active') from dual;\nspool off\nThe html file is very small but will be rendered by an online flash automatically loaded from the oracle.com website.
\nYou can see both output, plan.txt, and plan.htm from this zip: xplans.zip
\nHere is how they look like (but please never send me screenshots of execution plans…):
\n
And the colorful active report from SQL Monitoring:
\n![\"CapturePlanHtm.PNG\"](\"https://www.dbi-services.com/blog/wp-content/uploads/sites/2/2022/04/CapturePlanHtm.png\" "\\"CapturePlanHtm.PNG\\"")
The goal of this blog post is to simply (copy/paste) the formatting and the plan gathering code, so if you have any improvement ideas, please share.
\nThanks to Tyler Muth (@tmuth) I added the emx_control event to avoid compression of xml in 12c. See his Query Test Framework
\n", "protected": false } }