comparison backend/doc/documentation/de/importer-geodaesie.tex @ 6750:012f79123d48 double-precision

Importer Doc: completion and corrections to overview of geo-importer.
author Tom Gottfried <tom.gottfried@intevation.de>
date Mon, 05 Aug 2013 11:39:59 +0200
parents 46c6ff16c422
children b5b54e8da1cf
comparison
equal deleted inserted replaced
6749:46c6ff16c422 6750:012f79123d48
1 \section{Geodatenimport} 1 \section{Geodatenimport}
2 2
3 Der Geodaten Importer ist ein in der Programmiersprache Python 3 Der Geodaten Importer ist ein in der Programmiersprache Python
4 geschriebenes Kommandozeilen Werkzeug zum Import von Shapefiles in 4 geschriebenes Kommandozeilen Werkzeug zum Import von Shapefiles in
5 eine Datenbank. 5 eine Datenbank.
6 Zum Lesen der Shapefiles und zum schreiben der Geodaten 6 Zum Lesen der Shapefiles und zum Schreiben der Geodaten
7 in die Datenbank wird die GDAL Bibliothek verwendet. 7 in die Datenbank wird die GDAL-Bibliothek verwendet.
8 Um Daten in eine Oracle Datenbank zu importieren ist es nötig, dass 8 Um Daten in eine Oracle Datenbank zu importieren ist es nötig, dass
9 GDAL und GDAL Python Bindungs mit Oracle Unterstützung installiert 9 GDAL und GDAL-Python-Bindings mit Oracle-Unterstützung installiert
10 sind. Bei der Verwendung von PostgreSQL entfällt dieser Schritt. 10 sind. Bei der Verwendung von PostgreSQL entfällt dieser Schritt.
11 Weitere Details hierzu befinden sich im 11 Weitere Details hierzu befinden sich im
12 Kapitel \ref{Systemanforderungen} und \ref{Installationsanleitung}. 12 Kapitel \ref{Systemanforderungen} und \ref{Installationsanleitung}.
13 Für die Reprojektion der Daten verwendet GDAL wiederum die PROJ4-Bibliothek. 13 Für die Transformation der Daten verwendet GDAL wiederum die PROJ4-Bibliothek.
14 Die Daten werden vor dem Schreiben in die Datenbank alle 14 Die Daten werden vor dem Schreiben in die Datenbank alle
15 in die Gauß-Krüger-Projektion Zone 3 (EPSG-Code 31467) überführt. 15 in die Gauß-Krüger-Projektion Zone 3 (EPSG-Code 31467) transformiert.
16 Ist für die zu importierenden Daten keine Projektion ersichtlich 16 Ist für die zu importierenden Daten keine Projektion ersichtlich
17 (fehlende \textit{*.prf}-Datei), so findet keine Reprojektion statt. 17 (fehlende \textit{*.prj}-Datei), so findet keine Transformation statt.
18 Dies führt nur zu Problemen mit dem Fachdienst FLYS, falls die Daten nicht
19 bereits in der genannten Projektion vorlagen.
18 20
19 Der Importer kann mit einem Shellscript von der Kommandozeile gestartet werden 21 Der Importer kann mit einem Shellscript von der Kommandozeile gestartet werden
20 (siehe Kapitel \ref{Starten des Geodaten Importers}). Nach dem Start wird anhand der 22 (siehe Kapitel \ref{Starten des Geodaten Importers}). Nach dem Start wird anhand der
21 Konfiguration festgestellt, welche Klassen von Shapefiles aus dem Dateisystem 23 Konfiguration festgestellt, welche Klassen von Shapefiles aus dem Dateisystem
22 importiert werden sollen. Für jede Klasse gibt es einen speziellen 24 importiert werden sollen. Für jede Klasse gibt es einen speziellen
23 Parser, der die speziellen Attribute eines Shapefiles liest und in die entsprechende 25 Parser, der die speziellen Attribute eines Shapefiles liest und in die entsprechende
24 Relation der Datenbank schreibt. Die Parser sind speziell auf das 26 Relation der Datenbank schreibt. Die Parser sind speziell auf das
25 Dateisystem der BfG ausgerichtet. So wird beispielsweise erwartet, dass die Shapefiles der 27 Dateisystem der BfG ausgerichtet. So wird beispielsweise erwartet, dass die Shapefiles der
26 Gewässerachse im Ordner $Geodaesie/Flussachse+km$ liegen. Weitere Informationen zu 28 Gewässerachse im Ordner $Geodaesie/Flussachse+km$ liegen. Weitere Informationen zu
27 den einzelnen Parsern sind dem nächsten Kapitel \ref{Beschreibung der Parser} zu 29 den einzelnen Parsern sind Kapitel \ref{Beschreibung der Parser} zu
28 entnehmen. Der Erfolg oder Misserfolg eines Shape-Imports wird je nach 30 entnehmen. Der Erfolg oder Misserfolg eines Shape-Imports wird
29 Konfiguration im Logfile vermerkt. Folgende Einträge können dem Logfile 31 im Logfile vermerkt. Folgende Einträge können dem Logfile
30 entnommen werden: 32 entnommen werden:
31 33
32 \textbf{INFO: Inserted 4 features} 34 \textbf{INFO: Inserted \# features}
33 \\Gibt die Anzahl der erfolgreich importierten Features an.\\ 35 \\Gibt die Anzahl der erfolgreich importierten Features an.
34 36
35 \textbf{INFO: Failed to create 2 features} 37 \textbf{INFO: Failed to create \# features}
36 \\Gibt die Anzahl der Features an, die nicht importiert werden konnten.\\ 38 \\Gibt die Anzahl der Features an, die nicht importiert werden konnten.
37 39
38 \textbf{INFO: Found 3 unsupported features of type: wbkMultiLineString} 40 \textbf{INFO: Found 3 unsupported features of type: '...'}
39 \\Gibt die Anzahl der Features an, die aufgrund ihres Datentyps nicht importiert 41 \\Gibt die Anzahl der Features an, die aufgrund ihres Datentyps nicht importiert
40 werden konnten. Wenn etwa Punkte erwartet wurden aber sich im Shapefile 42 werden konnten. Wenn etwa Punkte erwartet wurden aber sich im Shapefile
41 Polygone befanden.\\ 43 Polygone befanden.
42 44
43 \textbf{INFO: Did not import values from fields: TYP ID GRUENDUNG BHW} 45 \textbf{INFO: Did not import values from fields: '...' ...}
44 \\Manche Importer versuchen neben der Geographischen Information weitere 46 \\Der Importer schreibt neben der geographischen Information weitere
45 Felder in die Datenbank einzulesen. Um festzustellen ob ein Feld aufgrund 47 Attribut-Daten in die Datenbank.
46 von Tippfehlern oder unterschiedlicher Schreibweise nicht importiert wurde, 48 Attribut-Spalten die nicht importiert wurden (z.B. auf Grund
47 gibt diese Information Auskunft darüber welche Felder aus der Shape Datei 49 von Tippfehlern oder unterschiedlicher Schreibweise),
48 nicht verwendet wurden.\\ 50 werden wie angegeben im Logfile aufgeführt.
49 51
50 \textbf{ERROR: No source SRS given! No transformation possible!} 52 \textbf{ERROR: No source SRS given! No transformation possible!}
51 \\Das Shapefile enthält keine Information, in welcher Projektion die Geometrien 53 \\Das Shapefile enthält keine Information, in welcher Projektion die Geometrien
52 vorliegen. Es findet keine Transformation in die Zielprojektion statt. Bitte 54 vorliegen. Es findet keine Transformation in die Zielprojektion statt. Bitte
53 beachten Sie, dass FLYS diese Geometrien später ggf nicht korrekt darstellen 55 beachten Sie, dass FLYS diese Geometrien später ggf.\ nicht korrekt darstellen
54 kann. 56 kann.
55 57
56 \textbf{ERROR: Unable to insert feature: DETAIL} 58 \textbf{ERROR: Unable to insert feature: DETAIL}
57 \\Beim Lesen der Attribute eines Features ist ein Fehler aufgetreten. 59 \\Beim Lesen eines Features ist ein Fehler aufgetreten.
58 Das Feature konnte nicht in die Datenbank geschrieben werden.\\ 60 Das Feature konnte nicht in die Datenbank geschrieben werden.
59 61
60 \textbf{ERROR: Exception while committing transaction} 62 \textbf{ERROR: Exception while committing transaction}
61 \\Beim Abschluss des Schreib-Vorgangs in die Datenbank ist ein unerwarteter 63 \\Beim Abschluss des Schreib-Vorgangs in die Datenbank ist ein unerwarteter
62 Fehler aufgetreten. Die Features des Shapes sind nicht importiert worden.\\ 64 Fehler aufgetreten. Die Features des Shapes sind nicht importiert worden.
63 65
64 \textbf{ERROR 1: ORA-01017: invalid username/password; logon denied} 66 \textbf{ERROR 1: ORA-01017: invalid username/password; logon denied}
65 \\Es konnte keine Verbindung zur Oracle Datenbank hergestellt werden. Prüfen Sie 67 \\Es konnte keine Verbindung zur Oracle Datenbank hergestellt werden. Prüfen Sie
66 die Verbindungseinstellungen. 68 die Verbindungseinstellungen.
69
70 Weitere Fehler, die von der Oracle-Datenbank kommen, können ebenfalls im
71 Logfile angezeigt werden.
67 72
68 Damit die Geodaten eines Shapes später eindeutig in der Datenbank identifiziert 73 Damit die Geodaten eines Shapes später eindeutig in der Datenbank identifiziert
69 werden können, wird für jede Geometrie der Pfad des Shapes im Dateisystem in 74 werden können, wird für jede Geometrie der Pfad des Shapes im Dateisystem in
70 einer Spalte der Datenbank gespeichert. Anwendungen, die auf der Datenbank 75 einer Spalte der Datenbank gespeichert. Anwendungen, die auf der Datenbank
71 aufbauen, können die Geodaten eines Shapefiles später anhand dieses Merkmals 76 aufbauen, können die Geodaten eines Shapefiles später anhand dieses Merkmals

http://dive4elements.wald.intevation.org