Verwenden Sie diese gespeicherte Prozedur zum Importieren einer ESRI-Formdatei in eine Datenbank, die für räumliche Operationen aktiviert wurde. Die gespeicherte Prozedur kann auf eine von zwei verschiedenen Arten arbeiten:
Ein Beispiel für den Code zum Aufrufen dieser gespeicherten Prozedur finden Sie in der C-Funktion gseImportShape im Beispielprogramm. Informationen zu diesem Programm finden Sie in Kapitel 8, Anwendungen für Spatial Extender schreiben.
Wenn Sie eine Gruppe von ESRI-Formdarstellungen importieren, erhalten Sie mindestens zwei Dateien. Alle Dateien haben dasselbe Dateinamenpräfix, weisen jedoch unterschiedliche Dateierweiterungen auf. Die Dateierweiterungen der beiden Dateien, die Sie immer erhalten, lauten .shp und .shx.
Um die Dateien für eine Gruppe von Formdarstellungen zu erhalten, geben Sie in das Feld File name im Fenster Import Spatial Data den gemeinsamen Namen der Dateien ein. Geben Sie keine Dateierweiterung an. Auf diese Weise stellen Sie sicher, dass alle Dateien, die Sie benötigen - die Datei .shp, die Datei .shx sowie alle sonstigen eventuell dazugehörigen Dateien - importiert werden.
Gehen Sie beispielsweise davon aus, dass eine Gruppe von ESRI-Formdar- stellungen in Dateien mit dem Namen Lakes.shp und Lakes.shx gespeichert ist. Beim Importieren dieser Darstellungen würden Sie dem Parameter fileName nur den Namen Lakes zuordnen.
SDE-Transferdateien haben einen Namen, aber keine Dateierweiterung. Daher ordnen Sie dem Parameter fileName beim Importieren einer SDE-Transferdatei den Namen, aber keine Dateierweiterung zu.
Die Benutzer-ID, unter der diese gespeicherte Prozedur aufgerufen wird, muss eine der folgenden Berechtigungen haben:
Eingabeparameter
Tabelle 22. Eingabeparameter für die gespeicherte Prozedur db2gse.gse_import_shape.
Name | Datentyp | Beschreibung |
---|---|---|
layerSchema | VARCHAR(30) | Name des Schemas, zu dem die im Parameter layerTable angegebene Tabelle
oder Sicht gehört.
Dieser Parameter kann Nullwerte enthalten. Kommentar: Wenn Sie keinen Wert für den Parameter layerSchema angeben, wird als Standardwert die Benutzer-ID verwendet, unter der die gespeicherte Prozedur db2gse.gse_import_shape aufgerufen wurde. |
layerTable | VARCHAR(128) | Name der Tabelle, in die die importierte Formdatei geladen werden
sollen.
Dieser Parameter kann keine Nullwerte enthalten. |
layerColumn | VARCHAR(30) | Name der Spalte, die als die Schicht registriert wurde, in die die
Formdaten geladen werden sollen.
Dieser Parameter kann keine Nullwerte enthalten. |
fileName | VARCHAR(128) | Name der zu importierenden Formdatei.
Dieser Parameter kann keine Nullwerte enthalten. |
exceptionFile | VARCHAR(128) | Pfad und Name der Datei, in der die Formen gespeichert werden sollen, die
nicht importiert werden konnten. Diese ist eine neue Datei, die bei der
Ausführung der gespeicherten Prozedur db2gse.gse_import_shape
erstellt wird.
Ordnen Sie dem Parameter exceptionFile einen Dateinamen, aber keine Dateierweiterung zu. Dieser Parameter kann keine Nullwerte enthalten. |
srId | INTEGER | Kennung des für die Schicht zu verwendenden räumlichen Bezugssystems, in
das die Formdaten geladen werden sollen.
Dieser Parameter kann Nullwerte enthalten. Kommentar: Wenn diese Kennung nicht angegeben ist, wird die interne Umwandlung auf die maximal mögliche Auflösung für die Formdatei eingestellt. |
commitScope | INTEGER | Anzahl der Datensätze pro Prüfpunkt.
Dieser Parameter kann Nullwerte enthalten. |
Ausgabeparameter
Tabelle 23. Ausgabeparameter für die gespeicherte Prozedur db2gse.gse_import_shape.
Name | Datentyp | Beschreibung |
---|---|---|
msgCode | INTEGER | Code, der den Nachrichten zugeordnet ist, die der Aufrufer dieser gespeicherten Prozedur zurückgeben kann. |
msgText | VARCHAR(1024) | Vollständige Fehlernachricht, wie auf dem Spatial Extender-Server konstruiert. |