Das GeoJSON-Format ist ein beliebtes Austauschformat, da es von vielen Applikationen unterstützt wird. Zudem ist es durch die JSON-Struktur sowohl für Menschen als auch für Maschinen gut lesbar.

Mithilfe der von Oracle Spatial zur Verfügung gestellten Prozedur „sdo_util.from_geojson“ kann das Format sehr einfach in den von Oracle Spatial verwendeten Datentyp SDO_GEOMETRY umgewandelt werden. Und das sogar direkt beim INSERT von Datensätzen in der VALUES-Klausel, was ich mir schon häufiger zunutze gemacht habe, und Ihnen daher hier vorstellen möchte.

Warum PowerShell? 

Ganz einfach: Weil es da ist. Ganz ohne die Installation von zusätzlichen Komponenten ist PowerShell auf jedem Windows System vorhanden. Das ist gerade bei meinen Kunden wichtig, nicht immer kann ich mir die Installation von zusätzlicher Software wünschen.

Und für die Verarbeitung GeoJSON ganz entscheidend: PowerShell kann nicht nur sehr gut mit JSON umgehen, sondern auch ohne Probleme lange Zeichenketten (also CLOBs) verarbeiten und in die Datenbank übertragen. 

Wie verbinde ich PowerShell mit Oracle? 

Hier verweise ich auf meinen Artikel „PowerShell und Oracle – ein gutes Team“, der die Grundlage für dieses Beispiel bildet und den folgenden ersten Codeblock erläutert. 

Wir brauchen ein paar Daten 

Damit Sie das Ganze auch direkt bei sich nachvollziehen können, verwende ich hier öffentlich zugängliche Daten. Auf der Webseite DataHub (https://datahub.io/core/geo-countries) finden Sie die Geodaten aller Länder der Erde im GeoJSON Format zum Download.

Zum Download nutze ich den PowerShell Befehl „Invoke-RestMethod“, der zwar eigentlich für die Kommunikation mit REST-APIs vorgesehen ist, aber letztendlich auch nur eine Kombination aus „Webseite laden“ und „JSON-Format in PowerShell-Objekte umwandeln“ ist. Und genau das wollen wir machen:

$uri = 'https://datahub.io/core/geo-countries/r/0.geojson'

$geoJSON = Invoke-RestMethod -Method Get -Uri $uri

Wenn die Daten allerdings UFT-8-Zeichen enthalten, funktioniert diese Abkürzung nicht, da der Befehl die Daten leider als „ISO-8859-1“ interpretiert. Daher hier noch die Alternative, falls Sie diese mal benötigen: 

Zudem sehe Sie so auch, wie Sie Daten einlesen können, die Sie bereits als Datei vorliegen haben. 

Wir brauchen eine Tabelle 

Aber werfen wir zunächst einen Blick auf die Daten, um die notwendigen Spalten zu ermitteln.

Mit dem Befehl „$geoJSON | Format-List“ können wir uns die importierten Daten in einer Listenansicht darstellen lassen: 

Wir sehen hier, dass die heruntergeladenen Daten auf der obersten Ebene ein einzelnes Objekt vom GeoJSON-Typ „FeatureCollection“ beinhalten. Da wir in der Oracle Datenbank aber nicht nur eine Zeile, sondern eine Zeile pro Land einfügen wollen, schauen wir uns das Attribut „features“ näher an, dass eine Liste von Elementen enthält. Mit dem PowerShell-Ausdruck „$geoJSON.features.Count“ können wir uns die Anzahl der Elemente anzeigen lassen: Es sind 255 Länder enthalten.

Werfen wir mit „$geoJSON.features[0] | Format-List“ einen Blick auf das erste Land der Liste: 

Neben der Angabe des GeoJSON-Typs „Feature“ finden wir zwei weitere Attribute: „properties“ und „geometry“.

Das Attribut „properties“ enthält wiederum ein Objekt mit zwei Attributen: Das Attribut „ADMIN“ enthält den Namen des Landes in englischer Sprache, das Attribut „ISO_A3“ den 3-buchstabigen Ländercode nach ISO-3166-1. Für diese beiden Attribute wollen wir in der Oracle Tabelle jeweils eine Spalte anlegen.

Das Attribut „geometry“ enthält die eigentlichen Geodaten, die wir in einer Spalte vom Datentyp SDO_GEOMETRY ablegen wollen.

Jetzt haben wir alle Informationen zusammengetragen, um die Tabelle erstellen zu können: 

Jetzt kann der Import beginnen 

In einer Schleife werden wir jetzt alle „features“, also alle Länder durchlaufen und jeweils die für den INSERT notwendigen Daten zusammenstellen. Dabei verwenden wir Bind-Variablen, die bei Oracle auch benannt werden können, was viel übersichtlicher als die Verwendung von „:1“, „:2“, etc. ist. Die Abfrage selbst ist damit immer die gleiche, sodass der Ausführungsplan wiederverwendet werden kann.

Die Werte für den Ländernamen und den ISO-Code holen wir direkt aus den „properties“ des „feature“, die Geometrie-Information aus „geometry“ müssen wir wieder zurück in JSON umwandeln. Da die Struktur unter Umständen bis zu vier Ebenen tief geschachtelt ist, müssen wir „-Depth 4“ verwenden, um korrektes JSON zu bekommen. Da wir auf sämtliche (nur die Lesbarkeit für uns Menschen erhöhenden) Umbrüche und Einrückungen verzichten wollen, wählen wir zudem „-Compress“.

Und so sieht der Code dann aus: 

Nach nur wenigen Sekunden sind alle Länder in der Datenbank vorhanden und können über ein GIS-Tool der Wahl auch angezeigt werden. 

Fazit 

Mit wenigen Zeilen PowerShell Code können Daten im GeoJSON Format in eine Oracle-Tabelle importiert werden.

Eine etwas umfangreichere Version dieses Skriptes inkl. Fehlerbehandlung finden Sie auf GitHub.

Möchten Sie Geodaten aus anderen Formaten importieren oder exportieren? Sprechen Sie uns an, wir helfen gerne. 

Seminarempfehlungen