Der Browser in eurer Datenbank: HTTPURITYPE

The simple browser in your database: HTTPURITYPE

Wenn es darum geht, HTTP-Zugriffe aus der Datenbank heraus zu machen, ist das Paket UTL_HTTP natürlich das Mittel der Wahl - damit kann ein Browser komplett imitiert werden; vom Setzen der HTTP Header Felder oder von Cookies bis hin zu den HTTP Methoden GET und POST ist alles drin, was man braucht.

When it's about doing HTTP requests with PL/SQL - there's only one answer: UTL_HTTP. UTL_HTTP allows you to mimick a web browser completely in the database - one can set cookies, HTTP headers, do GET and POST requests and much more.

In vielen Fällen braucht man das alles aber nicht - es muss einfach nur etwas per HTTP abgerufen werden. Und für genau diese Fälle gibt es die ganz einfache Variante: HTTPURITYPE - das kann man nutzen wie eine SQL-Funktion und es macht die ganze Arbeit auf einmal.

But in most cases these cool stuff is just not needed - all we want to do is a simple, plain HTTP request - no cookies, no special HTTP headers; nothing. And yes: There is a simple variant: HTTPURITYPE can be used like a SQL function and it does the whole work in one shot.

select httpuritype('http://sql-plsql-de.blogspot.com/feeds/posts/default') from dual / HTTPURITYPE('HTTP://SQL-PLSQL-DE.BLOGSPOT.COM/FEEDS/POSTS/DEFAULT')(URL) -------------------------------------------------------------------------------- HTTPURITYPE('sql-plsql-de.blogspot.com/feeds/posts/default') 1 row selected.

Da passiert erstmal noch nix ... Los geht's, wenn Ihr den Content selbst mit GETBLOB(), GETCLOB() oder GETXML() abruft.

Not much at the first glance. To have the database actually do the HTTP request you need to add one of the methods GETXML(), GETBLOB() or GETCLOB() ...

select httpuritype('http://sql-plsql-de.blogspot.com/feeds/posts/default').getxml() from dual / ERROR: ORA-29273: HTTP-Anforderung nicht erfolgreich ORA-06512: in "SYS.UTL_HTTP", Zeile 1819 ORA-12543: TNS: Ziel-Host ist nicht erreichbar ORA-06512: in "SYS.HTTPURITYPE", Zeile 34

Alles klar, dann setzen wir noch den Proxy ...

Ok, ok ... go ahead and set the proxy server ...

begin utl_http.set_proxy('{proxy-host}:{proxy-port}'); end; / select httpuritype('http://sql-plsql-de.blogspot.com/feeds/posts/default').getxml() from dual / HTTPURITYPE('HTTP://SQL-PLSQL-DE.BLOGSPOT.COM/FEEDS/POSTS/DEFAULT').GETXML() -------------------------------------------------------------------------------- <?xml version="1.0" encoding="CP850"?> <?xml-stylesheet type="text/xsl" media="screen" href="/~d/styles/rss2full.xsl"?> <?xml-stylesheet type="text/css" media="screen" href="http://feeds.feedburner.co m/~d/styles/itemcontent.css"?> <rss xmlns:atom="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/ spec/opensearch/1.1/" xmlns:georss="http://www.georss.org/georss" xmlns:thr="htt </

Voilá. HTTPURITYPE kann den Code wirklich ganz massiv vereinfachen - und wenn eine einfache Lösung ausreicht, dann soll man diese ja auch nutzen. Und als kleinen Exkurs kann man das Beispiel ja noch fortsetzen, indem man das XML auch direkt zerlegt ...

And that's it - HTTPURITYPE is a great code simplification when it's about HTTP and PL/SQL. And we could continue this example and start to shred the XML we got back ...

with xml as ( select httpuritype('http://sql-plsql-de.blogspot.com/feeds/posts/default').getxml() as doc from dual ) select t.titel, t.pubdate, t.link from xml, xmltable( 'for $i in //item return $i' passing xml.doc columns titel varchar2(100) path '/item/title/text()', pubdate varchar2(35) path '/item/pubDate/text()', link varchar2(500) path '/item/link/text()' ) t / TITEL PUBDATE LINK ------------------------------ ----------------------------------- ------------------------------ DELETE löscht ... und das ist Mon, 18 Jul 2011 09:00:00 +0000 http://sql-plsql-de.blogspot.c es, oder ...? om/2011/07/delete-loscht-und-d as-ist-es-oder.html Schon gewusst ...? Multi Table Mon, 04 Jul 2011 11:46:00 +0000 http://sql-plsql-de.blogspot.c Insert om/2011/07/schon-gewusst-multi -table-insert.html Kleine Statistikvorlesung: Mit Fri, 10 Jun 2011 09:11:00 +0000 http://sql-plsql-de.blogspot.c der Datenbank om/2011/06/kleine-statistikvor

Einen RSS-Feed abholen und direkt zerlegen - mit nur einer SQL-Abfrage. Einfacher geht es nun wirklich nicht.

Fetching an RSS feed and parsing it into a database table with just one SQL query - there is no simpler way ...

Ach ja ... fast hätte ich das vergessen. Ab Oracle11g braucht Ihr noch zusätzliche Netzwerk-Privilegien, damit Ihr aus der Datenbank überhaupt herauskommt: Mit dem PL/SQL-Paket DBMS_NETWORK_ACL_ADMIN müsst Ihr uerem Datenbankuser für die einzelnen Netzwerkziele freischalten. Wie das geht, ist in diesem Blog-Posting beschrieben.

And (last but not lease) one important point: On Oracle11g (or higher) you need special networking privileges - EXECUTE on UTL_HTTP is not sufficient. Using the package DBMS_NETWORK_ACL_ADMIN the DBA needs to enable the individual network "targets" for a specific database user. The blog posting describes the process.