DMann-SQLDeveloper4Reporting
- 1. Getting the Most Out of SQL Developer User-Defined Reports David Mann - Biogen Idec - ECOUG 2014
- 2. Topics • Context • Why use SQL Developer for reports? • Canned Report Review • Basic User Defined Reports • Supplying Parameters to Reports • Parent/Child & Drill Down • Advanced - Charts, HTML, Command Line Reports • Where do you go from here?
- 3. Bio • Graphic Arts Background • Development Background • Lead Oracle DBA @ • Interests : • Tools, Performance, Data Visualization
- 4. Context • GUI Java Application • Available for Windows/Mac OS X/Linux • Free from Oracle • Connects to databases via JDBC • No OCI client required (usually) • TNS / LDAP / Custom connection parameters
- 5. Why use SQL Developer for reports?
- 6. Ease of Use • Ready to go infrastructure • Multiple OSes supported • Quick download and install • Just need a JVM + GUI
- 7. Features • Feature Rich Admin and Query Tool • Source Code Control Integration • Unit testing • Data Modeling • DBA Module • Vote for features • Its a democracy, get some you want, some you don’t • Access to expertise
- 8. Reporting • Robust reporting feature set • Canned reports • User Defined Reports • HTML/PDF Output Options • Command Line Report Generation • Extensible • Customizable / Extensions • Portable report definitions • Sharing is caring
- 9. 4.0 - Not Your Father’s SQL Developer • Faster report development round trips • Live Preview in report editor during design time • 50+ Charting Options • Live preview also available for charts • Comprehensive reports included out of the box • Command Line Report Generation
- 11. Personal Reporting Process • DBA 1.0? • Get out of the query-> export -> Excel Graph rut • Too cumbersome to repeat reliably • Slow to repeat • Hard to share with others • Hard to motivate others to use your methods • Put this power into user’s hands with UDRs
- 12. Canned Reports
- 13. Canned Reports • Lots of useful reports included • Database Administration • Data Dictionary • Object Info • Application Express • Performance • + more
- 14. Other Canned Report Uses • Good learning tool • Copy + Modify • Can be the target of your own Drill Down reports
- 15. Basic User Defined Reports
- 16. Create a Simple UDR
- 18. Set SQL Query
- 19. Run It
- 20. Gauge Example
- 21. Building Gauges • SQLDEV:GAUGE • min:max:low thresh:upper threshold:value
- 25. “All” Option • Provide for optional use of Bind Variables
- 27. • Consist of a pair of related queries • Child query refreshed when Parent row clicked • Related by bind variable
- 28. Parent/Child
- 30. Features • Like Parent/Child but Child is hidden • Multiple Children can be attached to each Parent • Usage • Right click on Parent data element • Select drill down report name • Helps navigate your data
- 31. Creation • Create target report • Add to parent report* • Drilled report has access to bind variables
- 34. Charts
- 35. Charts • Prepare data series • Position 1 : Category Group (Y Axis) • Position 2 : Series (Legend) • Position 3 : Data Value (X Axis) • Choose best representation • Customize styles • Test it!
- 36. Chart Usage • Combine Parent Summary chart with Child Detail report • Can click on chart region to generate child report • Best of both worlds - digest the summary but have access to detail
- 37. Save as HTML
- 38. Options
- 39. Table Report as HTML
- 40. Chart Rendered in SQL Dev
- 41. Chart as HTML
- 42. Advanced : Internal HTML Render & PL/SQL DBMS_OUTPUT
- 43. HTML - Internal Render • PL/SQL DBMS_OUTPUT or Table Cell • Supports HTML subset • Supports inline CSS • No: • Style sheets • Javascript
- 44. HTML Example 1 Source Code
- 45. HTML Example 2 Source Code
- 46. HTML Example 3 Source Code
- 47. HTML Example 4 Source Code
- 48. Advanced: HTML External Render PL/SQL DBMS_OUTPUT
- 49. HTML - External Render • Many report types will save to local HTML file • Formatting decisions made for you • Not all features may translate
- 50. Advanced: Command Line Interface
- 51. Command Line • Develop in SQL Developer, call from Command Line • Leverages SQL Developer connection info • Can supply Bind variables • Con: Heavyweight JVM Startup ./sdcli reports generate -report "User Defined Reports/My Report" -db "PDB1 - dmann" -file /tmp/test.html -bind name=value
- 52. Putting It All Together • Let’s make the most complicated UDF we can • HTML Report • External render • Javascript referencing external libraries • Kick it off via the command line • Look at familiar data in a new way
- 53. Example Output Source Code
- 54. Behind the Scenes • Check the XML • Do you feel lucky?
- 55. Where Do You Go From Here? • Start your own collection of UD Reports • SQL Analytic Features • Custom Actions • What can you automate? • SQL Developer Exchange, OTN • http://github.com/dmann99/SQLDevUDRepPack • “5 in 5” at http://ba6.us
- 56. Questions Slides, code, links : http://ba6.us david@ba6.us @ba6dotus http://github.com/dmann99
- 57. References • http://www.thatjeffsmith.com/archive/2014/04/ how-to-add-custom-actions-to-your-user-reports/ • http://www.thatjeffsmith.com/archive/2012/07/ customizing-monitor-sessions-in-oracle-sql-developer/
- 58. Abstract • SQL Developer has proved itself as one of the most innovative and useful tools available for Oracle users, DBAs, and developers. With the release of version 4.0 the included and custom report options have been greatly expanded. This session will review the different types of reports available in SQL developer and review the powerful Custom Reports features. Demos will include creating simple and complex user defined reports, leveraging the new graph types, as well as a discussion and demo of the new command line HTML reports generation features.