Merge pull request #308 from oracle-devrel/sdu-branch4

Sdu branch4

Author: JesusGitHubOracle

data-platform/core-converged-db/workshops/README.md

@@ -0,0 +1,11 @@
+# Workshops
+
+In this section you'll detailed material about the workshops we propose to either customers or internally. 
+
+ # License
+
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/folder-structure/LICENSE) for more details.

data-platform/core-converged-db/workshops/multitenant/001.Create.new.PDB.sql

@@ -0,0 +1,10 @@
+-- Create a new PDB in the container database (CDB)
+
+sqlplus / as sysdba
+create pluggable database PDB1 admin user pdbadmin identified by "Oracle_4U"; 
+
+show pdbs
+
+alter pluggable database PDB1 open read write;
+
+show pdbs

data-platform/core-converged-db/workshops/multitenant/002.Unplug.PDB.sql

@@ -0,0 +1,13 @@
+-- Unplug a PDB from its CDB
+
+--- First we connect to the CDB. 
+
+sqlplus / as sysdba
+
+show pdbs
+
+alter pluggable database PDB1 close immediate;
+alter pluggable database PDB1 unplug into '/home/oracle/PDB1.xml';
+drop pluggable database PDB1 keep datafiles; 
+
+show pdbs

data-platform/core-converged-db/workshops/multitenant/003.Check.Compatibility.sql

@@ -0,0 +1,16 @@
+-- Check the PDB compatibility before plugging it in the target CDB
+
+sqlplus / as sysdba
+set serveroutput on
+DECLARE
+    compatible BOOLEAN := FALSE;
+BEGIN
+compatible := DBMS_PDB.CHECK_PLUG_COMPATIBILITY(
+pdb_descr_file => '/home/oracle/PDB1.xml');
+if compatible then
+    DBMS_OUTPUT.PUT_LINE('Is pluggable PDB1.xml compatible? YES'); 
+else 
+    DBMS_OUTPUT.PUT_LINE('Is pluggable PDB1.xml compatible? NO');
+end if;
+END;
+/

data-platform/core-converged-db/workshops/multitenant/004.Plug.by.Cloning.Unplugged.sql

@@ -0,0 +1,27 @@
+-- Plug a PDB by cloning from an unplugged PDB (as clone method)
+
+sqlplus / as sysdba
+
+--- Create a clone of PDB1 using the manifest file generated during the unplug command (copy the original datafiles)
+create pluggable database PDB1_clone as clone using '/home/oracle/PDB1.xml';
+
+-- Plug the unplugged DB with nocopy method (reuse the datafiles)
+create pluggable database PDB1_nocopy using '/home/oracle/PDB1.xml' NOCOPY TEMPFILE REUSE;
+
+show pdbs
+
+alter pluggable database PDB1_nocopy open read write;
+alter pluggable database PDB1_CLONE open read write;
+
+show pdbs
+
+-- Now retrieve the datafiles names of PDB1_nocopy
+alter session set container = PDB1_nocopy;
+
+--- This query retrieves the PDB's datafile names
+select file_name from dba_data_files;
+
+--- Please write down these datafile names, as we will use them later on during the backup/restore lab.
+
+--- Note that PDB GUID is used in the path to the datafiles
+select GUID from v$pdbs;

data-platform/core-converged-db/workshops/multitenant/005.Create.PDB.from.PDB.sql

@@ -0,0 +1,6 @@
+-- Create a new PDB from an existing PDB
+
+sqlplus / as sysdba
+create pluggable database PDB1 from PDB1_nocopy;
+alter pluggable database PDB1 open read write; 
+show pdbs

data-platform/core-converged-db/workshops/multitenant/006.Create.Refreshable.PDB.sql

@@ -0,0 +1,55 @@
+-- Create a refreshable PDB from an existing PDB
+
+-- First we connect to the CDB$ROOT, and create a common user
+sqlplus / as sysdba
+
+--- Note the C## prefix in the username (common user), and the "container=ALL" clause in the grant commands
+create user C##_ADMIN_PDB identified by "Oracle_4U" container=ALL;
+grant CREATE PLUGGABLE DATABASE to C##_ADMIN_PDB container=ALL;
+grant create session to C##_ADMIN_PDB container=ALL;
+
+-- Then we create a database link connected to that user. In our case, the database link is a loopback, since we only have one CDB
+create database link DBL_ORCLCDB connect to C##_ADMIN_PDB identified by "Oracle_4U" using 'myoracledb:1521/ORCLCDB';
+
+--- Check that the database link is working fine 
+select * from dual@DBL_ORCLCDB;
+
+create pluggable database PDB1_REFRESH from PDB1@DBL_ORCLCDB refresh mode manual;
+
+--- A refreshable PDB can only be opened in read only mode. If you try to open it in read write, it will be opened in read only anyway.
+
+alter pluggable database PDB1_REFRESH open read only; 
+
+show pdbs
+
+-- Create some new data in the source PDB
+--- Connect to PDB1 and create a local user with a table 
+
+sqlplus system/Oracle_4U@myoracledb:1521/PDB1
+
+create tablespace USERS datafile size 50M;
+create user TEST_REFRESH identified by "Oracle_4U" temporary tablespace TEMP default tablespace USERS;
+grant connect, resource to TEST_REFRESH;
+alter user TEST_REFRESH quota unlimited on USERS;
+
+--- Connect to TEST_REFRESH schema and create a new table
+sqlplus TEST_REFRESH/Oracle_4U@myoracledb:1521/PDB1 
+create table TT (c1 number);
+insert into TT values (999);
+commit;
+
+--- Connect to PDB1_REFRESH PDB as system, and check
+sqlplus system/Oracle_4U@myoracledb:1521/PDB1_REFRESH
+select username from dba_users where username = 'TEST_REFRESH';
+-- We need to refresh this PDB
+
+-- Then refresh the refreshable clone, and check the new data is there
+sqlplus / as sysdba
+alter pluggable database PDB1_REFRESH close immediate; 
+alter pluggable database PDB1_REFRESH refresh;
+show pdbs
+
+alter pluggable database PDB1_REFRESH open read only;
+
+sqlplus TEST_REFRESH/Oracle_4U@myoracledb:1521/PDB1_REFRESH 
+select * from tt;

data-platform/core-converged-db/workshops/multitenant/007.Create.snap.clone.sql

@@ -0,0 +1,42 @@
+-- Create a snap clone on the refreshable PDB
+
+-- On the PDB1_REFRESH PDB, used as a TEST MASTER, we create two sparse clones
+-- Sparse techonoly 
+-- Sparse datafiles clones are thin clones, that are sustained by the copy on write technology of the storage
+-- Sparse clones creation is extremely fast, as pointers to the TEST MASTER are created, instead of physically cloning the TEST MASTER datafiles
+
+sqlplus / as sysdba
+show pdbs
+
+create pluggable database PDB1_SNAP1 from PDB1_REFRESH snapshot copy; 
+create pluggable database PDB1_SNAP2 from PDB1_REFRESH snapshot copy; 
+alter pluggable database PDB1_SNAP1 open;
+alter pluggable database PDB1_SNAP2 open;
+
+show pdbs
+
+-- Unlike their TEST MASTER, the snapshot copies are opened in read write, allowing users to create their own data.
+-- Connect to PDB1_SNAP1, and run:
+
+sqlplus TEST_REFRESH/Oracle_4U@myoracledb:1521/PDB1_SNAP1 
+select * from tt;
+insert into tt values (1000); 
+commit;
+select * from tt;
+
+-- Now connect to PDB1_SNAP2 and check the TT table: 
+sqlplus TEST_REFRESH/Oracle_4U@myoracledb:1521/PDB1_SNAP2 
+select * from tt;
+
+-- Only the data from the TEST MASTER is visible, not the data created in PDB1_SNAP1
+delete tt;
+insert into tt values (1001); 
+commit;
+select * from tt;
+
+-- We can even modify (delete) the original data, without affecting the TEST MASTER: connect to the TEST MASTER and check:
+sqlplus TEST_REFRESH/Oracle_4U@myoracledb:1521/PDB1_REFRESH 
+select * from tt;
+
+-- This illustrates the "copy on write" functionality
+-- If we refresh the TEST MASTER, we will first drop the snapshot copies, and re-create them after the TEST MASTER refresh.

data-platform/core-converged-db/workshops/multitenant/008.PDB.backup.Restore.sql

@@ -0,0 +1,43 @@
+-- PDB Backup and restore
+
+rman target=/
+
+BACKUP PLUGGABLE DATABASE PDB1_NOCOPY;
+exit
+
+--- Remove a datafile from the operating system: change the file name by your file name !!!
+--- You need to use the file name for tablespace SYSTEM, as returned previously in page 6 
+
+rm /opt/oracle/oradata/ORCLCDB/CDADC32D998ECE2AE053E414010AA42A/datafile/o1_mf_sys tem_jotz78l7_.dbf
+
+--- Connect to the PDB
+sqlplus system/Oracle_4U@myoracledb:1521/PDB1_NOCOPY
+
+-- This fails !!!
+
+ORA-27041: unable to open
+Linux-x86_64 Error: 2: No
+Additional information: 3
+ORA-00604: error occurred
+ORA-01116: error in opening database file 19
+ORA-01110: data file 19: '/opt/oracle/oradata/ORCLCDB/CDADC32D998ECE2AE053E414010AA42A/datafile/o1_mf_sy s
+tem_jotz78l7_.dbf'
+ORA-27041: unable to open file
+Linux-x86_64 Error: 2: No such file or directory Additional information: 3
+
+--- Ensure datafile ID (19) matches with your environment
+
+rman target=/
+
+RUN {
+alter pluggable database PDB1_NOCOPY close immediate; 
+RESTORE datafile 19;
+RECOVER PLUGGABLE DATABASE PDB1_NOCOPY;
+ALTER PLUGGABLE DATABASE PDB1_NOCOPY open;
+}
+
+--- Check that the PDB is now sucessufully opened and accessible
+sqlplus / as sysdba
+show pdbs
+
+sqlplus system/Oracle_4U@myoracledb:1521/PDB1_NOCOPY

data-platform/core-converged-db/workshops/multitenant/009.PDB.Flashback.sql

@@ -0,0 +1,43 @@
+-- PDB Flashback
+
+-- Connect to ORCLPDB1 PDB, and create a local user 
+sqlplus system/"Oracle_4U"@myoracledb:1521/ORCLPDB1
+
+create user TEST_FLASHBACK identified by "Oracle_4U" default tablespace USERS temporary tablespace TEMP;
+grant connect, resource to TEST_FLASHBACK;
+alter user TEST_FLASHBACK quota unlimited on USERS;
+exit
+
+-- Connect to TEST_FASHBACK schema and create a table
+sqlplus TEST_FLASHBACK/"Oracle_4U"@myoracledb:1521/ORCLPDB1 
+
+create table tt (c1 number);
+insert into tt values (1);
+insert into tt values (2);
+commit; 
+exit
+
+-- Now we create a restore point
+sqlplus sys/Oracle_4U@myoracledb:1521/ORCLPDB1 as sysdba 
+create restore point RP_1 guarantee flashback database; 
+exit
+
+-- Now connect to TEST_FLASHBACK schema and drop the table 
+sqlplus TEST_FLASHBACK/"Oracle_4U"@myoracledb:1521/ORCLPDB1 
+drop table tt;
+exit
+
+-- Now connect to the CDB and flashback the PDB to the restore point
+sqlplus / as sysdba
+alter pluggable database ORCLPDB1 close immediate; 
+flashback pluggable database ORCLPDB1 to restore point RP_1;
+
+show pdbs
+
+alter pluggable database ORCLPDB1 open resetlogs;
+
+show pdbs
+
+-- Now connect to TEST_FLASHBACK schema and check the table is back 
+sqlplus TEST_FLASHBACK/"Oracle_4U"@myoracledb:1521/ORCLPDB1
+select * from tt;