Oracle REST Data Services (ORDS)

Loading ...
nielsdebr...
Other
2636
ORDS –
Oracle
REST Data 
Services
Niels de Bruijn, Business Unit Manager APEX
14.05.2020
Facts & Figures
Technologie-orientiert
Branchen-unabhängig
Hauptsitz
Ratingen
280 
Beschäftigte
Gründung
1994
Niederlassungen in
Frankfurt & Köln
Ausbildungs-
betrieb
Inhabergeführt
Oracle
Platinum
Partner
Microsoft
Gold
Partner
33 Mio. Euro 
Umsatz in 
2018
2
Einführung Oracle REST Data Services (ORDS)
3
Über mich
§ Niels de Bruijn, Fachbereichsleiter APEX
§ Geboren in 1977, verheiratet, drei Töchter, Wohnort Ratingen
§ seit 12.2003 bei der MT AG in Ratingen
§ zuvor 2 Jahre als Berater bei Oracle Nederland B.V. angestellt
§ Beschäftigt sich seit 2004 mit APEX
§ Federführend beim Vertrieb/Marketing/Delivery von APEX Projekten
§ https://apex.mt-ag.com
§ Vorstand Development bei der DOAG & Initiator/Programmleiter von APEX Connect
§ Referent u.A. auf der DOAG Konferenz, APEX World & ODTUG Kscope
§ Auszeichnung “DOAG Botschafter Technologie 2018”
§ Oracle Application Express 18: Developer Certified Professional 
Einführung Oracle REST Data Services (ORDS)
knowledgebase.mt-ag.com
5
Agenda
Einführung Oracle REST Data Services (ORDS)
■ Oracle REST Data Services (ORDS)
■ Use Case 2: REST-API für die Datenbank
■ Use Case 1: APEX
■ Use Case 3: SQL Dev Web
6
Oracle REST Data Services (ORDS)
Ermöglicht den (präferierten) Zugriff auf die Oracle Datenbank mittels HTTP(s)
§ Aktuelle Version ist 19.4
§ Als Java Programm lauffähig auf
§ Jetty (standalone)
§ Oracle WebLogic Server
§ Apache Tomcat
§ Setzt JDK 8+ voraus
§ Installation mit java –jar ords.war install advanced
§ Wichtig: Connection Pool sizen (defaults.xml)!
Einführung Oracle REST Data Services (ORDS)
7
Agenda
Einführung Oracle REST Data Services (ORDS)
■ Use Case 1: APEX
■ Use Case 2: REST-API für die Datenbank
■ Oracle REST Data Services (ORDS)
■ Use Case 3: SQL Dev Web
8
Use Case 1: APEX
Einführung Oracle REST Data Services (ORDS)
GET https://host/ords/f?p=100:1
execute apex_public_user.f(p=> ’100:1’);
über den Connection Pool
JDBC connection p
ool
HTTP/1.1 200 OK
<html>
my APEX page
</html>
{html}
URI
PLSQL
Map & Bind
HTTP Request
HTTP Response
Proxy pass
HTML
ords.war
APEX Metadata Repository
9
Use Case 1: APEX
§ ORDS als Zugriffsweg für APEX empfohlen (statt EPG oder OHS)
§ Benötigte Datenbankbenutzer bei der ORDS Konfiguration
§ APEX_PUBLIC_USER (apexins.sql)
§ APEX_REST_PUBLIC_USER (apex_rest_config.sql)
§ APEX_LISTENER (apex_rest_config.sql)
§ Optional für den Betrieb von APEX, aber empfehlenswert
§ ORDS_METADATA
§ ORDS_PUBLIC_USER
§ Nicht vergessen: nach einem APEX Upgrade java –jar ords.war validate ausführen
Einführung Oracle REST Data Services (ORDS)
10
Agenda
Einführung Oracle REST Data Services (ORDS)
■ Use Case 2: REST-API für die Datenbank
■ Use Case 1: APEX
■ Oracle REST Data Services (ORDS)
■ Use Case 3: SQL Dev Web
11
Use Case 2: REST-API für die Datenbank
Einführung Oracle REST Data Services (ORDS)
GET https://host/ords/hr/emp/
SELECT *
FROM EMPLOYEES
JDBC connection p
ool
HTTP/1.1 200 OK
{ "employee_id": 100,
"first_name": " Niels"
,"last_name": ,"de Bruijn"
, "email": ,"lndb@me.nl"
{json}
URI
SQL & PLSQL
Map & Bind
HTTP Request
HTTP Response
Transform to JSON
SQL Result Set / Standard OUT
ords.war
ORDS Metadata Repository
12
Use Case 2: REST-API für die Datenbank
§ Features:
§ AUTO-REST enable Tabellen/Views oder custom RESTful services bereitstellen
§ Administration über PL/SQL, SQL Developer oder APEX (SQL dev und APEX eingeschränkt)
§ OpenAPI Support (Swagger) inklusive
§ REST Enabled SQL
§ Vordefinierte REST APIs der Oracle Datenbank verwenden
§ DB Creation Assistant, Data Pump (export only), Monitoring, etc.
§ Keine Sorge: alle Features müssen explizit freigeschaltet werden
§ RESTful Web Services können mittels OAuth2 abgesichert werden
§ und/oder ORDS Prehook-Feature in der Datenbank verwenden
§ defaults.xml: <entry key="procedure.rest.preHook">schema.auth_pkg.check</entry>
Einführung Oracle REST Data Services (ORDS)
13
Agenda
Einführung Oracle REST Data Services (ORDS)
■ Use Case 3: SQL Dev Web
■ Use Case 2: REST-API für die Datenbank
■ Oracle REST Data Services (ORDS)
■ Use Case 1: APEX
14
Use Case 3: SQL Dev Web
Einführung Oracle REST Data Services (ORDS)
15
Use Case 3: SQL Dev Web
Einführung Oracle REST Data Services (ORDS)
§ Verfügbar auf cloud.oracle.com
§ ab ORDS 19.4 auch on-premises
§ Hauptfeatures
§ SQL Worksheet
§ Schema Diagram
§ Performance Hub
§ Sonstiges
§ Setzt DB API & REST enabled SQL voraus
§ Authentifizierung mittels DB User und nur für Schemata die “REST enabled” sind
§ Möglich für die Oracle Datenbank ab 11gR2
16
Top ORDS Quellen
Einführung Oracle REST Data Services (ORDS)
§ ORDS Webseite
https://www.oracle.com/database/technologies/appdev/rest.html
§ Product Manager Jeff Smith über ORDS
https://www.slideshare.net/hillbillyToad/presentations
§ David Schleis über ORDS 
https://insum.ca/user-specific-web-services-using-ords
§ Single Sign-On Konfig
http://knowledgebase.mt-ag.com/q/kerberos
§ Dietmar Aust über ORDS
http://www.opal-consulting.de/downloads/presentations
§ Tim Hall über ORDS
https://oracle-base.com/articles/misc/articles-misc#ords
§ ORDS Prehook
https://www.jmjcloud.com/blog/using-the-ords-prehook-function
§ REST APIs der Oracle Datenbank
https://docs.oracle.com/en/database/oracle/oracle-database/19/dbrst/rest-endpoints.html
Kontaktdaten
@nielsdb
nielsdebr.blogspot.com
linkedin.com/in/nielsdebruijn
xing.com/profile/niels_debruijn