Mit dem Skriptmodul können Objekte aus einer POstGreSQL/PostGIS-Datenbank via ODBC gelesen werden. Der Modul unterstützt speziell die PostGreSQL Option PostGIS für räumliche Daten.
PGRESIN unterstützt sämtliche Geometry-Typen von PostGIS nach der OGC Simple Feature Specification.
Der Modul wird mit:
|INCL \script\pgresin.mod
in einer ICS RUN1-Konfiguration verfügbar gemacht.
Der Modul PGRESIN ist eine Erweiterung des Moduls DBIN. Alle im Modul DBIN beschriebenen Anteile gelten auch für das Modul PGRESIN. Ziehen Sie deshalb auch die Dokumentation des Modules DBIN bei.
Folgende Parameter können in der Map DB_PARAM für den Modul gesetzt werden:
| Parameter | req/opt | Beschreibung |
SOURCE | o | ODBC-Source der Datenbank. Muss gesetzt werden, falls die ODBC-Source nicht interaktiv abgefragt wird. |
USER | o | Datenbank User für die Verbindung mit der ODBC-Source. Muss gesetzt werden, falls die ODBC-Source nicht interaktiv abgefragt wird. |
PASSWORD | o | Datenbank Password für die Verbindung mit der ODBC-Source. Muss gesetzt werden, falls die ODBC-Source nicht interaktiv abgefragt wird. |
TRACE | o | ON oder OFF, Default = OFF. Für jedes gelesene Objekt eine Zeile ausgeben. |
Folgende Parameter können in der Map DBIN_PARAM für den Modul gesetzt werden:
| Parameter | req/opt | Beschreibung |
STATISTICS | o | ON oder OFF, Default = OFF. Statistik anzeigen. |
SELECT_PARSE | o | ON oder OFF,
Default = ON. Definiert, ob ein
eventuelles SQL-select Statement geparst werden soll. Als
Argument für für das Modul kann ein SQL-select Statement
definiert werden. Als Default wird dieses select-Statement
von geparst , um spezielle Attribute zu erkennen, die vom
ODBC-Treiber nicht unterstützt werden und speziell gelesen
werden müssen. Manchmal können select-Statements (komplexe
Joins) nicht erfolgreich geparst werden. In solchen Fällen
ist dieser Parameter auf OFF zu schalten.
Sie müssen besorgt sein, dass das select-Statement von ODBC
verarbeitet werden kann. |
Folgende Parameter können in der Map PGRESIN_PARAM für den Modul gesetzt werden:
| Parameter | req/opt | Beschreibung |
SPATIAL_PROCESS | o | ON oder OFF, Default = OFF. Definiert ob Spatial Geometrien gelesen werden sollen. Mit OFF werden die Geometrien nicht gelesen. Mit ON werden die Geometrien gelesen. |
Für die Anwendung der PostGreSQL Option PostGIS ist die enstprechende Dokumentation von PostGIS zu beachten.
Der Modul liefert pro IN-Objekt folgende Systemkomponenten:
| Komponente | req/opt | Beschreibung |
IN.TABLE(s) | r | Tablename des IN Objekts. |
IN.<Geometry>(g) | o | Ein Geometrie-Attribut wird mit demselben Namen wie in der Datenbank geliefert. Der enthaltene Wert entspricht einer ICS-Geometrie vom Typ point, line oder area oder Listen von Geometrien. |
IN.<Geometry>_OGCWKT_GEOMETRY(s) | o | Zusätzlich zu einem Geometrie-Attribut wird in einem Attribut mit dem Suffix _OGCWKT_GEOMETRY die PostGIS Geometrie als OCS-WKT-String geliefert (WKT: Well Known Text nach OGC Simple Feature Specification). |
Alle weiteren Komponenten sind abhängig von der Tabellen-Definition in der Datenbank.
Der Modul beinhaltet alle Prozeduren und Methoden wie der Modul DBIN. Ziehen Sie deshalb die Dokumentation des Modules DBIN bei. Zusätzlich stellt der Modul PGRESIN folgende Prozeduren und Methoden zur Verfügung.
| Prozedur | PGRESIN_OPEN [s input][] |
| Beschreibung | Öffnet eine Datenbank definiert
mit DB_PARAM.SOURCE und liest Objekte von
der Datenbank in Abhängigkeit von
<input>. Für
<input> können folgende Werte
verwendet werden. *Liest alle Tabellen der
Datenbank.<tablename>Liest die Records der definierten
Tabelle.<tablename>,<sql-select-statement>Liest
die Records der definierten Tabelle entsprechend dem
SQL-select-Statement. Beinhaltet das SQL-select-Statement
Hochkommas für Strings so sind die Hochkommas ' durch
Anführungszeichen " zu ersetzen.Die Prozedur wird von RUN1
automatisch aufgerufen. |
| Beispiel | |
|
| Prozedur | PGRESIN_READ_OBJECT [][b state] |
| Beschreibung | Liest das nächste IN-Objekt aus der geöffneten Datenbank-Tabelle. Die Prozedur wird von RUN1 automatisch aufgerufen. |
| Beispiel | |
| Prozedur | PGRESIN_CLOSE [][] |
| Beschreibung | Schliesst den Modul und gibt die durch den Modul belegten Resourcen wieder frei. Die Prozedur wird von RUN1 automatisch aufgerufen. |
| Beispiel | |
| Methode | OGC.WKT2GEOM [s ogc-wkt-geometry][g|li ics-geometry] |
| Beschreibung | Übersetzt eine OGC-WKT-Geometrie als String in eine ICS-Geometrie.Folgende Typen werden zurückgegeben: POINT,LINESTRING,POLYGION,MULTIPOINT,MULTILINESTRING,MULTIPOLYGON,GEOMETRYCOLLECTION. (WKT: Well Known Text nach OGC Simple Feature Specification). |
| Beispiel | |
Folgende Konversionen werden durchgeführt:
|
! Diese ICS Konfiguration zeigt alle von pgresin.mod ! gelesenen Objekte in der .log Datei an. |LICENSE \license\iltools.lic MAP USER_INPUT1 DIALOG => ODBC OPT => input END_MAP MAP DB_PARAM SOURCE => '' ! ODBC-Source USER => '' ! ODBC-User PASSWD => '' ! ODBC-Password TRACE => OFF END_MAP MAP DBIN_PARAM STATISTICS => ON END_MAP MAP PGRESIN_PARAM SPATIAL_PROCESS => ON END_MAP MAP INPUT_SOURCES I1 => PGRESIN,* END_MAP MAP INOUT I1 => DISPLAY_IN0 END_MAP |INCL \script\pgresin.mod |INCL \script\db2il\dbdisplay.out |INCL \script\run1.prg