Benutzer- und Referenzhandbuch

db2gse.gse_import_shape

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.

Berechtigung

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.


[ Seitenanfang | Vorherige Seite | Nächste Seite ]