Professional Documents
Culture Documents
Debugging With The PL/SQL Debugger: Philipp
Debugging With The PL/SQL Debugger: Philipp
Philipp
BASEL | BERN | BRUGG | BUKAREST | DÜSSELDORF | FRANKFURT A.M. | FREIBURG I.BR. | GENF
HAMBURG | KOPENHAGEN | LAUSANNE | MANNHEIM | MÜNCHEN | STUTTGART | WIEN | ZÜRICH
Philipp
• Database centric development
• Model Driven Software Development
• Author of free SQL Developer Extensions
PL/SQL Unwrapper, PL/SQL Cop,
utPLSQL, plscope-utils, oddgen and
Bitemp Remodeler
@phsalvisberg https://www.salvis.com/blog
BASEL | BERN | BRUGG | BUKAREST | DÜSSELDORF | FRANKFURT A.M. | FREIBURG I.BR. | GENF
HAMBURG | KOPENHAGEN | LAUSANNE | MANNHEIM | MÜNCHEN | STUTTGART | WIEN | ZÜRICH
Visit Us at Our Booth on Level 3
§ Trivadis barista (good coffee from morning to night)
§ Birthday cake (daily from 14:00)
§ Speed-Sessions at the booth with raffle:
• Di 14:45: Martin Berger "Oracle Cloud Free Tier – eben
mal kurz ausprobiert…"
• Mi 10:45: Guido Schmutz "Warum ich Apache Kafka als
IT-Spezialist kennen sollte!"
• Mi 14:45: Stefan Oehrli "PDB Sicherheit und Isolation,
Herausforderungen von Oracle Container DB‘s"
• Do 10:45: Chris Antognini "Welche Query-Optimizer
Funktionalitäten sind nur in Autonomous Database
verfügbar? “
§ Participation in our DOAG raffle
§ Networking and discussions with our speakers
Agenda
1. Motivation
2. Fundamentals
3. Prerequisites
4. Run & Debug in SQL Developer
5. Run APEX App & Debug in SQL Developer
6. Core Messages
Motivation
APEX Debugging – 101
See: https://www.doag.org/de/home/news/aufgezeichnet-peter-raganitsch-apex-debugging-101/detail/
"Debugging"
What Do You Think of First?
Explain Code Line by Line?
Change Log Level?
Add Log Entries?
Run Tests?
Set a Breakpoint?
Yes, But…
Fundamentals
DBMS_DEBUG (deprecated since 12.2)
• Allows a user to connect any of the specified user’s logon sessions to a debugger to debug
another user's session or his own
• Access to public and nonpublic variables, methods, and types of any PL/SQL code in the DB
• Place breakpoint in any PL/SQL code in the DB
BEGIN
dbms_network_acl_admin.append_host_ace (
host => '<host_name>',
ace => sys.xs$ace_type(
privilege_list => sys.xs$name_list('JDWP') ,
principal_name => '<target_user>',
principal_type => sys.xs_acl.ptype_db
)
);
END;
Run & Debug
in SQL Developer
Use Case
SQL> select * from dept;
1 row updated.
BEGIN
dbms_network_acl_admin.append_host_ace (
host =>'*',
ace => sys.xs$ace_type(
privilege_list => sys.xs$name_list('JDWP') ,
principal_name => 'ogdemo',
principal_type => sys.xs_acl.ptype_db
)
);
END;
Change Debug Preferences
Debug Anonymous PL/SQL Block
Step Into On Update Statement
Watch Data While Stepping Over/Into
Found
Using DBMS_DEBUG
in SQL Developer
Step 1 – Close SQL Developer
Saves
configuration
files
DatabaseDebuggerDisableJDWP=true
Run APEX App &
Debug in SQL Developer
Grant Privileges
• Access from APEX_PUBLIC_USER to parsing schema OGDEMO
• Avoid "ORA-01031: insufficient privileges"
sys.owa_util.get_cgi_env
('REMOTE_ADDR')
parsing schema
must be set
(wwv_flow_security_pkg)
Connect From Browser to SQL Developer
macOS HyperKit VM
en17: 192.168.1.26 (sqldev) eth0: 192.168.65.3
odb190 Container
eth0: 172.17.0.2
ORDS
Debug Session
Oracle Database
Helper Sessio
n
Listen for Incoming Debug Connections
1 2
3
Connect to Debugger from APEX App
Demo
Apply Changes
Debug in SQL Developer
Debug Session Is Automatically Closed
Core Messages
Instrument Your Code
• The PL/SQL debugger is no replacement for log messages in your code
• Look at existing frameworks, such as
• APEX_DEBUG
• Logger
• Use log levels consistently
• Change log level filters at runtime
• Avoid ad-hoc Instrumentation
Use the PL/SQL Debugger
• Set up the PL/SQL Debugger in your development environment
• The PL/SQL Debugger is not perfect
• You cannot change code while debugging
• Showing or changing values has limitations
• Expression support is poor
• Querying data in the target session
is not possible in SQL Developer
"Most coders think debugging
• But it helps software is about fixing a mistake,
but that's bullshit. Debugging's
• Finding bugs actually all about finding the bug,
• Understanding the code about understanding why the bug
was there to begin with, about
knowing its existence was no
accident."
-- Elliot Alderson, Mr. Robot