Download as PDF, PPTX
![Can the app connect to the database?
$ eval $(curl https://.../ |jq --raw-output '. | @sh
"L_DB_CONN=([.database_connection]);
L_DB_ERR=([.database_error])"
')
$ echo $L_DB_CONN
error
$ echo $L_DB_ERR
ORA-12541: TNS:no listener](https://image.slidesharecdn.com/sloveniaords-191008143950/85/Let-your-DBAs-get-some-REST-api-44-320.jpg)
![Can the app connect to the database?
$ eval $(curl https://.../ |jq --raw-output '. | @sh
"L_DB_CONN=([.database_connection]);
L_DB_ERR=([.database_error])"
')
$ echo $L_DB_CONN
error
$ echo $L_DB_ERR
ORA-12541: TNS:no listener
After intervention:
relocate, restore, restart…](https://image.slidesharecdn.com/sloveniaords-191008143950/85/Let-your-DBAs-get-some-REST-api-45-320.jpg)
![GRANT SELECT ON v_$rman_status TO dbarest;
CONN dbarest/dbarest
BEGIN
ORDS.DEFINE_TEMPLATE(
p_module_name => 'dbarest', p_pattern => 'lastbackup/',
p_priority => 0, p_etag_type => 'HASH');
ORDS.DEFINE_HANDLER(
p_module_name => 'dbarest', p_pattern => 'lastbackup/',
p_method => 'GET', p_source_type => 'json/query',
p_items_per_page => 0, p_mimes_allowed => '',
p_source =>
‘SELECT operation, status, object_type,
TO_CHAR(start_time, ''YYYY/MM/DD:HH24:MI:SS'') as start_time,
TO_CHAR(end_time, ''YYYY/MM/DD:HH24:MI:SS'') as end_time
FROM sys.v_$rman_status WHERE start_time=(
SELECT MAX(start_time) FROM sys.v_$rman_status WHERE operation = ''BACKUP'')'
);
COMMIT;
END;
$ curl https://.../dbarest/lastbackup/
{"items":[
{"operation":"BACKUP",
"status":"COMPLETED",
"object_type":"ARCHIVELOG",
"start_time":"03/24/2019:12:29:30",
"end_time":"03/24/2019:12:33:20"}
]}](https://image.slidesharecdn.com/sloveniaords-191008143950/85/Let-your-DBAs-get-some-REST-api-53-320.jpg)
![GRANT SELECT ON v_$rman_status TO dbarest;
CONN dbarest/dbarest
BEGIN
ORDS.DEFINE_TEMPLATE(
p_module_name => 'dbarest', p_pattern => 'lastbackup/',
p_priority => 0, p_etag_type => 'HASH');
ORDS.DEFINE_HANDLER(
p_module_name => 'dbarest', p_pattern => 'lastbackup/',
p_method => 'GET', p_source_type => 'json/query',
p_items_per_page => 0, p_mimes_allowed => '',
p_source =>
‘SELECT operation, status, object_type,
TO_CHAR(start_time, ''YYYY/MM/DD:HH24:MI:SS'') as start_time,
TO_CHAR(end_time, ''YYYY/MM/DD:HH24:MI:SS'') as end_time
FROM sys.v_$rman_status WHERE start_time=(
SELECT MAX(start_time) FROM sys.v_$rman_status WHERE operation = ''BACKUP'')'
);
COMMIT;
END;
$ curl https://.../dbarest/lastbackup/
{"items":[
{"operation":"BACKUP",
"status":"COMPLETED",
"object_type":"ARCHIVELOG",
"start_time":"03/24/2019:12:29:30",
"end_time":"03/24/2019:12:33:20"}
]}
DEMO?](https://image.slidesharecdn.com/sloveniaords-191008143950/85/Let-your-DBAs-get-some-REST-api-54-320.jpg)
Uploaded byLudovico Caldara
Let your DBAs get some REST(api)
The document discusses how REST APIs and ORDS can help DBAs adopt more agile practices. It provides examples of how DBAs can expose database operations and metadata via REST endpoints to improve communication and automation between developers and DBAs. This includes endpoints for checking database connectivity, putting applications in maintenance mode, retrieving backup status, creating/deleting restore points, refreshing schemas, and more. The document argues that REST and ORDS can help make DBAs more agile by standardizing their operations and facilitating integration with other tools and services.
More Related Content
Similar to Let your DBAs get some REST(api)
![Getting Started with Apache Spark: Big Data Made Simple [Free Meetup]](https://cdn.slidesharecdn.com/ss_thumbnails/apachesparkgettingstarted-260203175547-8361bcc3-thumbnail.jpg?width=640&height=640&fit=bounds)
Let your DBAs get some REST(api)
- 1. Let Your DBAsGet Some REST(api) Ludovico Caldara - Computing Engineer @CERN, Oracle ACE Director
- 2. ■ http://www.ludovicocaldara.net ■ @ludodba ■ludovicocaldara ■ Two decades of DBA experience (Not Only Oracle) ■ ITOUG co-founder ■ OCP (11g, 12c, MySQL) & OCE ■ Italian living in Switzerland Ludovico Caldara
- 3. Effective Oracle HomeManagement 3 The Large Hadron Collider (LHC) Largest machine in the world 27km, 6000+ superconducting magnets Emptiest place in the solar system High vacuum inside the magnets Hottest spot in the galaxy During Lead ion collisions create temperatures 100 000x hotter than the heart of the sun Fastest racetrack on Earth Protons circulate 11245 times/s (99.9999991% the speed of light)
- 4. SQL> select sum(bytes/power(1024,5))as "PetaBytes" > from dba_data_files; PetaBytes -------------- 1.052794738695 Large databases
- 5.
- 6. oracle.com/gbtour New Free Tier AlwaysFree Oracle Cloud Infrastructure Services you can use for unlimited time 30-Day Free Trial Free credits you can use for more services +
- 7. 10/8/2019 Document reference7 Haaa, the joy of development!
- 8. 10/8/2019 Document reference8 Trello
- 9. 10/8/2019 Document reference9 Trello Atom
- 10. 10/8/2019 Document reference10 Trello Atom Git
- 11. 10/8/2019 Document reference11 Trello Atom Git Jira
- 12. 10/8/2019 Document reference12 Trello Jenkins Atom Git Jira
- 13. 10/8/2019 Document reference13 Trello Jenkins Atom Git Jira Docker
- 14. Everything is beautifuland clean, and you feel more agile than ever
- 15. Still something ismissing… you need some magic from the DBA
- 16.
- 17. 10/8/2019 Document reference17 Puppet
- 18. 10/8/2019 Document reference18 Puppet Git
- 19. 10/8/2019 Document reference19 Puppet Ansible Git
- 20. 10/8/2019 Document reference20 Puppet Ansible Rundeck Git
- 21. 10/8/2019 Document reference21 Puppet Ansible Rundeck Git ELK
- 22. 10/8/2019 Document reference22 Puppet Ansible Rundeck REST Git ELK
- 23. Now, if yourDBAs use those agile methods you are in the wrong room!
- 24. But if youenter the DBA office and the DBA is like…
- 26. The not-so-agile DBAproblem… • In one word: BASH • DBA’s script are not complex • Underlying operations are complex • OS commands everywhere • Not-so-agile-DBAs do not need anything else
- 27. Expectation vs reality Quickbackup before going production: • You need to ask it at least 4h in advance • The backup takes ages • The DBA must check the outcome
- 28. Expectation vs reality Refreshof the test database: • You need to ask it at least 24h in advance • “It will not be accessible for the whole next working day”
- 29. Expectation vs reality Killinga session urgently: • “Urgently is dead” • “Test your (*) code before going production” * Put your favorite bad word here
- 30. Expectation vs reality Checkwhy the database is so slow: • “The database is fine” • “The database would be just fine without your crappy code” • Eventually, no action at all
- 32.
- 33. 10/8/2019 Document reference33(/ˈdʒeɪsən/)JSON
- 34. REST endpoints • Standard,widely used • Flexible • De-coupled • Tons of libraries and 3rd party integration
- 35.
- 36. REST for DBAs?ORDS! • Definition in the database • PL/SQL: DBA friendly • Powerful • Damn simple
- 37. REST for DBAs?ORDS! SOLUTION
- 38. REST for DBAs?ORDS! SOLUTION INGREDIENT
- 39. 4 shades ofREST
- 40. • DEV ->DEV • DEV -> DBA • DBA -> DEV • DBA -> DBA
- 41.
- 42. Developer’s endpoint forthe DBA • Can the app connect to the database?
- 43. Can the appconnect to the database? $ curl https://portal_prod/check/dbstatus/ { "database_error": "ORA-12541: TNS:no listener", "database_connection": "error", "application": "portal_prod" }
- 44. Can the appconnect to the database? $ eval $(curl https://.../ |jq --raw-output '. | @sh "L_DB_CONN=([.database_connection]); L_DB_ERR=([.database_error])" ') $ echo $L_DB_CONN error $ echo $L_DB_ERR ORA-12541: TNS:no listener
- 45. Can the appconnect to the database? $ eval $(curl https://.../ |jq --raw-output '. | @sh "L_DB_CONN=([.database_connection]); L_DB_ERR=([.database_error])" ') $ echo $L_DB_CONN error $ echo $L_DB_ERR ORA-12541: TNS:no listener After intervention: relocate, restore, restart…
- 46. Developer’s endpoint forthe DBA • Can you connect to the database? • Put the application in maintenance mode
- 47. Put the applicationin maintenance mode # put the app in maintenance curl –X POST --header "Content-Type: application/json“ -d "{"maintenance":"true"}" http://myapp/backend/maintenance_mode # do maintenance ... # put the app online ...
- 48.
- 49.
- 50. Schema/module definition BEGIN ORDS.ENABLE_SCHEMA( p_enabled =>TRUE, p_schema => 'DBAREST', p_url_mapping_type => 'BASE_PATH', p_url_mapping_pattern => 'dbarest', p_auto_rest_auth => FALSE); ORDS.DEFINE_MODULE( p_module_name => 'dbarest', p_base_path => '/dbarest/', p_items_per_page => 0, p_status => 'PUBLISHED', p_comments => NULL); https://oraweb.cern.ch/ords/xepdb1/dbarest/...
- 51. DBA’s endpoint forthe developer • Check backup before deployment
- 52. GRANT SELECT ONv_$rman_status TO dbarest; CONN dbarest/dbarest BEGIN ORDS.DEFINE_TEMPLATE( p_module_name => 'dbarest', p_pattern => 'lastbackup/', p_priority => 0, p_etag_type => 'HASH'); ORDS.DEFINE_HANDLER( p_module_name => 'dbarest', p_pattern => 'lastbackup/', p_method => 'GET', p_source_type => 'json/query', p_items_per_page => 0, p_mimes_allowed => '', p_source => ‘SELECT operation, status, object_type, TO_CHAR(start_time, ''YYYY/MM/DD:HH24:MI:SS'') as start_time, TO_CHAR(end_time, ''YYYY/MM/DD:HH24:MI:SS'') as end_time FROM sys.v_$rman_status WHERE start_time=( SELECT MAX(start_time) FROM sys.v_$rman_status WHERE operation = ''BACKUP'')' ); COMMIT; END;
- 53. GRANT SELECT ONv_$rman_status TO dbarest; CONN dbarest/dbarest BEGIN ORDS.DEFINE_TEMPLATE( p_module_name => 'dbarest', p_pattern => 'lastbackup/', p_priority => 0, p_etag_type => 'HASH'); ORDS.DEFINE_HANDLER( p_module_name => 'dbarest', p_pattern => 'lastbackup/', p_method => 'GET', p_source_type => 'json/query', p_items_per_page => 0, p_mimes_allowed => '', p_source => ‘SELECT operation, status, object_type, TO_CHAR(start_time, ''YYYY/MM/DD:HH24:MI:SS'') as start_time, TO_CHAR(end_time, ''YYYY/MM/DD:HH24:MI:SS'') as end_time FROM sys.v_$rman_status WHERE start_time=( SELECT MAX(start_time) FROM sys.v_$rman_status WHERE operation = ''BACKUP'')' ); COMMIT; END; $ curl https://.../dbarest/lastbackup/ {"items":[ {"operation":"BACKUP", "status":"COMPLETED", "object_type":"ARCHIVELOG", "start_time":"03/24/2019:12:29:30", "end_time":"03/24/2019:12:33:20"} ]}
- 54. GRANT SELECT ONv_$rman_status TO dbarest; CONN dbarest/dbarest BEGIN ORDS.DEFINE_TEMPLATE( p_module_name => 'dbarest', p_pattern => 'lastbackup/', p_priority => 0, p_etag_type => 'HASH'); ORDS.DEFINE_HANDLER( p_module_name => 'dbarest', p_pattern => 'lastbackup/', p_method => 'GET', p_source_type => 'json/query', p_items_per_page => 0, p_mimes_allowed => '', p_source => ‘SELECT operation, status, object_type, TO_CHAR(start_time, ''YYYY/MM/DD:HH24:MI:SS'') as start_time, TO_CHAR(end_time, ''YYYY/MM/DD:HH24:MI:SS'') as end_time FROM sys.v_$rman_status WHERE start_time=( SELECT MAX(start_time) FROM sys.v_$rman_status WHERE operation = ''BACKUP'')' ); COMMIT; END; $ curl https://.../dbarest/lastbackup/ {"items":[ {"operation":"BACKUP", "status":"COMPLETED", "object_type":"ARCHIVELOG", "start_time":"03/24/2019:12:29:30", "end_time":"03/24/2019:12:33:20"} ]} DEMO?
- 55. DBA’s endpoint forthe developer • Check backup before deployment • Create/delete restore point
- 56. Create/delete restore point RESTORE_POINT CREATE(p_name IN) DROP (p_name IN) HTTP POST : /dbarest/restorepoint/ HTTP DELETE : /dbarest/restorepoint/ HTTP GET : /dbarest/restorepoint/ SELECT name, time FROM v$restore_point;
- 57. Create/delete restore point RESTORE_POINT CREATE(p_name IN) DROP (p_name IN) HTTP POST : /dbarest/restorepoint/ HTTP DELETE : /dbarest/restorepoint/ HTTP GET : /dbarest/restorepoint/ SELECT name, time FROM v$restore_point; DEMO?
- 58. DBA’s endpoint forthe developer • Check backup before deployment • Create/delete restore point • Refresh Schema
- 59.
- 60.
- 61. Refresh Schema EXPDP/IMPDP DBA SCRIPT xepdb1 xepdb1 ORDS USER HTTPPOST HR@ PDB2 HR@ PDB3 DUMP
- 62.
- 63.
- 64. DBA’s endpoint forthe developer • Check backup before deployment • Create/delete restore point • Refresh Schema • Create new users
- 65. DBA’s endpoint forthe developer • Check backup before deployment • Create/delete restore point • Refresh Schema • Create new users • Create new databases
- 66. DBA’s endpoint forthe developer • Check backup before deployment • Create/delete restore point • Refresh Schema • Create new users • Create new databases • Create Guaranteed Restore Points
- 67.
- 68. DBA’s endpoint forthe DBA • Collect metrics • Various metadata, e.g.: • Retrieve unsuccessful backup
- 69. Real production example@ CERN
- 70. Thank you! Ludovico Caldara- Computing Engineer @CERN, Oracle ACE Director