Merge pull request #330 from oracle-devrel/ulrike-testingspa

Ulrike testingspa assets

Author: JesusGitHubOracle

data-platform/core-converged-db/real-application-testing/README.md

@@ -0,0 +1,37 @@
+# Real Application Testing
+Real Application Testing comes in two flavors - Database Replay (DB Replay) and SQL Performance Analyzer (SPA). Both can be used independently of each other but are also a good complement. 
+With SQL Performance Analyzer you can check the SQL performance. It focuses on detailed statement analysis of a defined SQL workload made available via a SQL Tuning Set (STS).
+Statements from a SQL workload can be tested and compared and tuned if necessary.
+
+Database Replay can be used to capture a real workload on the production system and replay it on a test system with the exact timing, concurrency, and transaction characteristics of the original workload. This enables you to test the effects of a system change without affecting the production system. 
+
+## Useful Links
+
+### Documentation
+
+- [Testing Guide 19c](https://docs.oracle.com/en/database/oracle/oracle-database/19/ratug/index.html#Oracle%C2%AE-Database)
+- [PL/SQL Packages and Types Reference](https://docs.oracle.com/en/database/oracle/oracle-database/19/arpls/index.html#Oracle%C2%AE-Database)
+
+
+### Team Publications
+
+- [Testing with Oracle Database Replay](https://blogs.oracle.com/coretec/post/testing-with-oracle-database-replay)
+- [Autonomous Database Replay](https://blogs.oracle.com/coretec/post/adb-database-replay)
+- [Real Application Testing Database Replay Demo](https://blogs.oracle.com/coretec/post/rat-demo)
+- [Smooth transition to Autonomous Database using SPA](https://blogs.oracle.com/coretec/post/spa-in-autonomous-database)
+- [Oracle SQL Tuning Sets (STS) - The foundation for SQL Tuning](https://blogs.oracle.com/coretec/post/oracle-sql-tuning-sets-the-basis-for-sql-tuning)
+
+
+### LiveLabs Workshops
+
+- [Real Application Testing : SQL Performance Analyzer and Database Replay](https://apexapps.oracle.com/pls/apex/r/dbpm/livelabs/view-workshop?wid=858&clear=RR,180&session=112790027738609)
+
+
+
+# License
+
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See LICENSE for more details.

data-platform/core-converged-db/real-application-testing/sql-performance-analyzer/README.md

@@ -0,0 +1,27 @@
+# SQL Performance Analyzer
+
+SQL Performance Analyzer (SPA) as part of Real Application Testing focuses on detailed statement analysis of a defined SQL workload made available via a SQL Tuning Set (STS). The workload runs twice - once BEFORE the change and then AFTER a change. The resulting reports are a detailed comparative analysis (before and after the change) of the individual statements, measured by different metrics such as elapsed time, cpu time, etc. Optionally, you can automate the tuning process using SQL Tuning Advisor or SQL Plan Baselines. 
+
+## Useful Links
+
+### Documentation
+
+- [Testing Guide](https://docs.oracle.com/en/database/oracle/oracle-database/19/ratug/sql-performance-analyzer.html#GUID-8CE976A3-FB73-45FF-9B18-A6AB3F158A95)
+- [PL/SQL Packages and Types Reference - DBMS_SQLPA](https://docs.oracle.com/en/database/oracle/oracle-database/19/arpls/DBMS_SQLPA.html#GUID-9AAF3672-1CF3-4354-AF41-5BA50BA295F8)
+
+### Team Publication
+- [Smooth transition to Autonomous Database using SPA](https://blogs.oracle.com/coretec/post/spa-in-autonomous-database)
+- [Oracle SQL Tuning Sets (STS) - The foundation for SQL Tuning](https://blogs.oracle.com/coretec/post/oracle-sql-tuning-sets-the-basis-for-sql-tuning)
+
+### Livelabs/HOL
+- [Real Application Testing : SQL Performance Analyzer and Database Replay](https://apexapps.oracle.com/pls/apex/r/dbpm/livelabs/view-workshop?wid=858&clear=RR,180&session=112790027738609)
+- [HOL 19c SQL Performance Analyzer](https://mikedietrichde.com/hol-19c-sql-performance-analyzer/)
+
+
+# License
+
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See LICENSE for more details.

data-platform/core-converged-db/real-application-testing/sql-performance-analyzer/scripts-spa/README.md

@@ -0,0 +1,49 @@
+## scripts-spa
+This folder provides SQL scripts for the usage of SQL Performance Analyzer (SPA). They can be used to test changes on the same system or to run tests on a remote server.
+
+Before you start with SQL Performance Analyzer, you need to provide a SQL Tuning Set. 
+For more information see also:   
+- [Github scripts for SQL Tuning Sets](https://github.com/oracle-devrel/technology-engineering/tree/main/data-platform/core-converged-db/sql-performance/sql-tuning-sets/scripts-for-sts)
+
+Please note all SQL Performance Analyzer tasks require the privilege ADVISOR.
+
+## SQL Performance Analyzer Scripts
+Please follow the steps in the suggested order. In step 2 you can choose between two test scenarios - on the same system or on a remote system. The tuning of regressed statements with SQL Plan Baselines at the end is optional.
+
+1. Create and monitor the tuning task and executions
+- Create a SPA task     : create-spa-task.sql
+- Drop SPA task         : drop-spa-task.sql
+- Monitor SPA task      : monitor-task.sql
+- Monitor SPA executions: monitor-executions.sql
+ 
+Scenario A: 
+2. Execute trials on the same system
+- Execute first trial : trial-execute.sql 
+- Make changes on the system
+- Execute second trial: trial-execute.sql  
+
+Scenario B: 
+2. Import STS on the remote system and use execution statistics for the first trial 
+- Use the executions statistics for the first trial: trial-use-stats.sql
+- Execute the trial (more than once is recommended): trial-execute.sql 
+
+
+3. Generate the comparison results
+- Compare performance of two executions: compare-performance.sql
+
+4. Generate reports
+- Generate summary report in HTML : report-summary.sql 
+- Generate detailed report in HTML: report-all-details.sql
+
+
+Optional: 
+Tune regressed statements with SQL Plan Baselines
+1. Create STS for regressed statements: create-sts-regressed.sql
+2. Load original plans                : loadplans-for-regressed.sql
+
+# License
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See LICENSE for more details.

data-platform/core-converged-db/real-application-testing/sql-performance-analyzer/scripts-spa/compare-performance.sql

@@ -0,0 +1,6 @@
+REM Script: compare-performance.sql
+REM Compare performance of two executions
+  
+-- enter task name (see also monitor-tasks.ql)
+-- enter name for execution 1 and execution 2 (monitor-executions.sql lists the execution names)
+execute dbms_sqlpa.execute_analysis_task(task_name => '&taskname', execution_type => 'COMPARE PERFORMANCE',execution_params => DBMS_ADVISOR.ARGLIST('execution_name1', '&name1','execution_name2', '&name2'));

data-platform/core-converged-db/real-application-testing/sql-performance-analyzer/scripts-spa/create-spa-task.sql

@@ -0,0 +1,13 @@
+REM Script: create-spa-task.sql
+REM Create a SQL Performance Analyzer task
+
+-- enter STS name and owner of the STS
+-- print task name
+
+set serveroutput on 
+declare tname varchar2(100);
+begin    
+   tname := dbms_sqlpa.create_analysis_task(sqlset_name => '&STSname', sqlset_owner=>'&STSOwner');
+   dbms_output.put_line('task name: ' || tname);
+end;
+/

data-platform/core-converged-db/real-application-testing/sql-performance-analyzer/scripts-spa/create-sts-regressed.sql

@@ -0,0 +1,18 @@
+REM Script: create-sts-regressed.sql
+REM Generate STS for regressed statements
+
+-- create SQL Tuning Set for regressed statements
+execute DBMS_SQLTUNE.CREATE_SQLSET(sqlset_name => '&stsname', description=> 'Regressed Statements');
+
+-- use task and execution name from compare-performance.sql or check with monitor-executions.sql
+DECLARE
+  sqlset_cur  DBMS_SQLTUNE.SQLSET_CURSOR;
+BEGIN  
+  OPEN sqlset_cur FOR
+    SELECT value(p)
+    FROM table(
+      DBMS_SQLTUNE.SELECT_SQLPA_TASK('&taskname', '&STSowner','&execution_name', 'REGRESSED')) p;
+      DBMS_SQLTUNE.LOAD_SQLSET(sqlset_name => '&STSname', populate_cursor => sqlset_cur);
+  CLOSE sqlset_cur;
+END;
+/

data-platform/core-converged-db/real-application-testing/sql-performance-analyzer/scripts-spa/drop-spa-task.sql

@@ -0,0 +1,6 @@
+REM Script: drop-spa-task.sql
+REM drop SQL Performance Analyzer task 
+
+-- enter SPA task name  
+execute dbms_sqlpa.drop_analysis_task(task_name => '&taskname');
+-- check SPA tasks with monitor_task.sql

data-platform/core-converged-db/real-application-testing/sql-performance-analyzer/scripts-spa/loadplans-for-regressed.sql

@@ -0,0 +1,10 @@
+REM Script: loadplans-for-regressed.sql
+REM Load original execution plans 
+
+-- enter STS name from create-sts-regressed.sql
+DECLARE
+  my_plans PLS_INTEGER;
+BEGIN
+  my_plans := DBMS_SPM.LOAD_PLANS_FROM_SQLSET(sqlset_name => '&STSname');
+END;
+/

data-platform/core-converged-db/real-application-testing/sql-performance-analyzer/scripts-spa/monitor-executions.sql

@@ -0,0 +1,10 @@
+REM Script: monitor-executions.sql
+REM Monitor SQL Performance Analyzer executions
+
+-- list task name and executions for advisor
+-- use SQL PERFORMANCE ANALYZER for advisor_name in the case of SPA  
+col execution_name format a25
+col task_name format a25 
+
+select task_name, execution_name, status
+from dba_advisor_executions where upper(advisor_name)='&Advisorname';

data-platform/core-converged-db/real-application-testing/sql-performance-analyzer/scripts-spa/monitor-task.sql

@@ -0,0 +1,8 @@
+REM Script: monitor-task.sql
+REM Monitor SQL Performance Analyzer task
+
+col owner format a15
+col task_name format a30
+-- check status and name of SQL Performance Analyzer task
+SELECT owner, task_name, status FROM dba_advisor_tasks 
+WHERE upper(advisor_name)='SQL PERFORMANCE ANALYZER';