Merge pull request #286 from oracle-devrel/Ulrikests-assets

Ulrikests assets

Author: JesusGitHubOracle

data-platform/core-converged-db/sql-tuning-sets/README.md

@@ -0,0 +1,35 @@
+# SQL Tuning Sets
+
+A SQL Tuning Set (aka STS) is a database object that you can use as input to tuning tools. An STS includes SQL statements, associated execution context, associated basic execution statistics, and associated execution plans. It enables you to group SQL statements and related metadata in a single database object, which you can use to meet your tuning goals.
+STS can be generated from various sources such as Automatic Workload Repository (AWR), Cursor Cache or Real Application Testing Database Replay. 
+
+## Useful Links
+
+### Documentation
+
+- [PL/SQL Package DBMS_SQLTUNE 19c](https://docs.oracle.com/en/database/oracle/oracle-database/19/arpls/DBMS_SQLTUNE.html#GUID-821462BF-1695-41CF-AFF7-FD23E9999C6A)
+- [SQL Tuning Gudide 19c](https://docs.oracle.com/en/database/oracle/oracle-database/19/tgsql/managing-sql-tuning-sets.html#GUID-91D1B886-A6D7-40B8-93D5-112B8C6E6AFE)
+- [Database Reference 19c ALL_SQLSET](https://docs.oracle.com/en/database/oracle/oracle-database/19/refrn/ALL_SQLSET.html#GUID-7F8980B0-1B5F-4E0E-A79D-CA6B7FD23D8E)
+- [Database Reference 19c ALL_SQLSET_STATEMENTS](https://docs.oracle.com/en/database/oracle/oracle-database/19/refrn/ALL_SQLSET_STATEMENTS.html#GUID-1EE16029-9312-4280-B7BD-396B84652FFE)
+
+### Team Publications
+
+- [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)
+
+
+### Blogs
+
+- [What is the Automatic SQL Tuning Set?](https://blogs.oracle.com/optimizer/post/what-is-the-automatic-sql-tuning-set)
+- [Introducing Oracle Database 23c Free – Developer Release](https://blogs.oracle.com/database/post/oracle-database-23c-free)
+
+### Videos
+
+- [Capture workload information with SQL Tuning Set](https://www.youtube.com/watch?v=V4VlGNPI62g)
+- [Creating SQL Tuning Sets](https://www.youtube.com/watch?v=f3f182gxODY)
+
+
+# License
+
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+Licensed under the Universal Permi

data-platform/core-converged-db/sql-tuning-sets/scripts-for-sts/1-transport-sts-from-source.sql

@@ -0,0 +1,17 @@
+REM Script: 1-transport-sts-from-source.sql
+REM Create a staging table and add the statements to it (source system) 
+
+-- don't use SYS user for this  
+-- Use CREATE_STGTAB_SQLSET to create the staging table
+
+execute dbms_sqltune.create_stgtab_sqlset(table_name => '&tablename', schema_name => '&owner');
+
+-- Load the staging table with data from one or more STS with PACK_STGTAB_SQLSET
+
+execute dbms_sqltune.pack_stgtab_sqlset(sqlset_name => '&stsname', -
+                                        sqlset_owner => '&owner', -
+                                        staging_table_name => '&stagingtab_name',- 
+                                        staging_schema_owner=> '&stagingtab_owner');
+
+
+-- use datapump to export the staging table and import it to the target system

data-platform/core-converged-db/sql-tuning-sets/scripts-for-sts/2-transport-sts-to-target.sql

@@ -0,0 +1,11 @@
+REM Script: 2-transport-sts-to-target.sql
+REM on the the source system create a staging table and add the statements to it 
+
+-- first import the staging table
+-- copy the SQL tuning sets from the staging table into the database
+
+execute dbms_sqltune.unpack_stgtab_sqlset(sqlset_name => '&stsname', -
+                                          sqlset_owner => '&owner', -
+                                          replace => TRUE, -
+                                          staging_schema_owner=>'&stagingtab_owner',- 
+                                          staging_table_name => '&stagingtab_name');

data-platform/core-converged-db/sql-tuning-sets/scripts-for-sts/README.md

@@ -0,0 +1,16 @@
+# scripts-for-sts
+This folder provides useful SQL scripts for SQL Tuning Sets. You may change and edit them accordingly.
+
+## scripts
+You must have the ADMINISTER SQL TUNING SET system privilege to manage SQL tuning sets that you own, or the ADMINISTER ANY SQL TUNING SET system privilege to manage any SQL tuning sets.
+
+- create_sts.sql: Create a new SQL Tuning Set
+- drop-sts.sql: Drop an existing SQL Tuning Set
+- create-sts-from-cursorcache.sql: Load STS from Cursor Cache
+- list_snapshots.sql: Helper script to list and find the required begin and end snap id
+- create-sts-from-awr.sql: Load STS from AWR
+- reduce-sts.sql: Reduce and existing STS
+- check-sts-information.sql: Monitor STS
+- check-sts-statements.sql: Monitor STS with statement execution
+- 1-transport-sts-from-source.sql: Tasks on the source system to transport STS
+- 2-transport-sts-to-target.sql: Tasks on the remote system to transport STS

data-platform/core-converged-db/sql-tuning-sets/scripts-for-sts/check-sts-information.sql

@@ -0,0 +1,11 @@
+REM Script: check-sts-information.sql
+REM Use view ALL_SQLSET
+ 
+-- check all sts 
+
+col name format a20
+col owner format a20
+
+select name, owner, created, statement_count 
+from all_sqlset
+where owner= '&owner';

data-platform/core-converged-db/sql-tuning-sets/scripts-for-sts/check-sts-statements.sql

@@ -0,0 +1,9 @@
+REM Script: check-sts-statements.sql
+REM Use view ALL_SQLSET_STATEMENTS
+ 
+-- check the tuning set, enter name and owner
+
+select executions, cpu_time/1000 cpu_in_ms, elapsed_time/1000 elapsed_in_ms, sql_id, substr(sql_text,1,80) 
+from all_sqlset_statements 
+where sqlset_name='&name' and owner='&owner' 
+order by 3 desc;

data-platform/core-converged-db/sql-tuning-sets/scripts-for-sts/create-sts-from-awr.sql

@@ -0,0 +1,16 @@
+REM Script: create-sts-from-awr.sql
+REM Load STS from AWR with SELECT_WORKLOAD_REPOSITORY and LOAD_SQLSET
+
+-- first create a STS with create-sts.sql
+-- find snap ids with list-snapshots.sql
+-- load statements in the SQL Tuning Set and enter two snap ids 
+ 
+DECLARE
+ cur dbms_sqltune.sqlset_cursor;
+BEGIN
+ OPEN cur FOR
+SELECT VALUE(P) 
+  FROM dbms_sqltune.select_workload_repository(begin_snap=>&startid, end_snap=>&endid) P; 
+  dbms_sqltune.load_sqlset (sqlset_name => '&name', sqlset_owner=>'&schema', populate_cursor => cur); 
+END;
+/

data-platform/core-converged-db/sql-tuning-sets/scripts-for-sts/create-sts-from-cursorcache.sql

@@ -0,0 +1,18 @@
+REM Script: create-sts-from-cursorcache.sql
+REM Load statements from cursor cache with SELECT_CURSOR_CACHE and LOAD_SQLSET
+
+-- first create STS with create-sts.sql
+
+-- enter filter criteria for parsing schema and sql text  
+
+DECLARE
+ cur dbms_sqltune.SQLSET_CURSOR;
+BEGIN
+ OPEN cur FOR
+   SELECT VALUE(P)
+   FROM dbms_sqltune.select_cursor_cache(basic_filter => 
+   'parsing_schema_name = ''&schema'' and upper(sql_text) like ''SELECT%''') P;
+   dbms_sqltune.load_sqlset(sqlset_name => '&stsname', sqlset_owner=>'&owner', populate_cursor => cur);
+  CLOSE cur;
+END;
+/

data-platform/core-converged-db/sql-tuning-sets/scripts-for-sts/create-sts.sql

@@ -0,0 +1,4 @@
+REM Script: create-sts.sql
+REM Create a new SQL Tuning Set with DBMS_SQLTUNE.CREATE_SQLSET
+
+execute dbms_sqltune.create_sqlset(sqlset_name=>'&stsname', sqlset_owner=>'&owner');

data-platform/core-converged-db/sql-tuning-sets/scripts-for-sts/drop-sts.sql

@@ -0,0 +1,6 @@
+REM Script: drop-sts.sql
+REM Drop an existing SQL Tuning Set with DBMS_SQLTUNE.DROP_SQLSET
+
+-- check sts first with check-sts-information.sql
+-- drop sts 
+execute dbms_sqltune.drop_sqlset(sqlset_name=>'&stsname', sqlset_owner=>'&owner');