Datenbank Import

Ein Datenbank Import Task importiert Features in eine der konfigurierten Datenbanken.

Schritt 1 (Task Name)

Option Beschreibung

Task Name

Name des Tasks.

Datenquelle erzeugen o. überschreiben

Wählen Sie, ob eine neue Datenquelle erstellt oder eine bestehende überschrieben wird.

Datenquellen Name

Wenn eine vorhandene Datenquelle überschrieben werden soll, wählen Sie hier die entsprechende Quelle aus.

Klicken Sie auf NÄCHSTER SCHRITT, um fortzufahren.

Schritt 2 (Datenbank)

In diesem Schritt muss die Ziel-Datenbank für den Import ausgewählt werden.

Datenbank wählen

Wählen Sie die Datenbank aus, in die die Daten importiert werden sollen.

Das System listet alle verfügbar konfigurierten Datenbanken. Wählen Sie die passende Datenbank aus der Dropdown-Liste.

Falls die benötigte Datenbank nicht gelistet ist, muss sie zuerst im Admin-Bereich konfiguriert werden.
Siehe Database Management für Details zum Anlegen und Verwalten von Datenbank-Verbindungen.

Verbindung zur Datenbank prüfen

Nach der Auswahl klicken Sie auf Verbindung zur Datenbank prüfen, um zu prüfen, ob die Verbindung funktioniert. Diese Prüfung ist optional, aber empfohlen.

Diese Prüfung stellt sicher:

  • Die Datenbank ist erreichbar

  • Zugangsdaten sind korrekt

  • Der Import kann ohne Verbindungsprobleme gestartet werden

Wenn die Verbindung erfolgreich validiert wurde, klicken Sie auf NÄCHSTER SCHRITT, um fortzufahren.

Schritt 3 (Task Einstellungen)

In diesem Schritt konfigurieren Sie die Eingabedaten und die Import-Optionen.

Datei oder Verzeichnis für Import wählen

Wählen Sie die Eingabequelle für den Import:

Eingabequelle Verhalten Hinweise

Datei

Importiert genau die ausgewählte Datei.

Die Dateiendung ist egal, der Inhalt muss aber zu einer unterstützten CityGML/CityJSON-Version für die ausgewählte Datenbank und (falls vorhanden) das ausgewählte Format passen.

Verzeichnis

Scannt das ausgewählte Verzeichnis rekursiv und importiert alle unterstützten Dateien.

Unterstützte Dateien werden über die Dateiendung erkannt (siehe unten).

ZIP-Archiv

Scannt das Archiv rekursiv wie ein Verzeichnis und importiert alle unterstützten Dateien.

Unterstützte Dateien werden über die Dateiendung erkannt (siehe unten).

Beim Scannen eines Verzeichnisses oder ZIP-Archivs werden Eingabedateien über die Dateiendung erkannt:

Format Dateiendungen (Verzeichnis/ZIP Scan)

CityGML

.gml, .xml, .gz, .gzip, .zip

CityJSON (inkl. CityJSONSeq)

.json, .jsonl, .gz, .gzip, .zip

Format

Datenbank Unterstützte Eingabeformate Standard Verhalten

VCDB 4

CityGML 1.0/2.0, CityJSON 1.0

n/a

  • Es gibt keine Format-Auswahl.

  • Sie können eine unterstützte CityGML- oder CityJSON-Datei angeben.

  • Wenn ein Verzeichnis oder ZIP-Archiv als Input ausgewählt wird, werden CityGML- und CityJSON-Dateien erkannt und verarbeitet (sofern ihre Format-Version unterstützt wird).

VCDB 5

CityGML 1.0/2.0/3.0, CityJSON 1.0/1.1/2.0

CityGML (1.0/2.0/3.0)

  • Die Format-Auswahl ist verfügbar: CityGML (1.0/2.0/3.0) oder CityJSON (1.0/1.1/2.0).

  • Das ausgewählte Format schränkt ein, welche Eingabedateien akzeptiert werden. Wenn Sie CityGML auswählen, aber eine CityJSON-Datei angeben (oder umgekehrt), bricht der Task mit einem Fehler ab.

  • Wenn ein Verzeichnis oder ZIP-Archiv als Input ausgewählt wird, werden nur Dateien passend zum ausgewählten Format berücksichtigt (basierend auf den Dateiendungen oben).
Für VCDB 5 Datenbanken unterstützt der CityJSON 1.1/2.0 Import CityJSON Text Sequences (CityJSONSeq) / *.jsonl.

Import-Modus

Der Import-Modus definiert, wie eingehende Features mit bereits vorhandenen Features in der Datenbank interagieren.

Doppelte Features werden über die Identifier erkannt:

  • CityGML: gml:id

  • CityJSON: der key in der "CityObjects" Collection (CityJSON) oder die "id" von "CityJSONFeature" Objekten (CityJSONSeq)

Terminierte Features werden bei der Duplicate-Prüfung nicht berücksichtigt.

Vier Modi stehen zur Auswahl:

Option Beschreibung Standardwert

Alle importieren (Import All)

  • Importiert alle Features aus den Eingabedateien.

  • Bei doppeltem Identifier wird ein Duplicate-Feature erzeugt (kein Update/Löschen).

  • Verwendung: Initiale Importe und Datenloads, bei denen Duplikate akzeptabel sind.

Standard

Vorhandene überspringen (Skip Existing)

  • Bereits vorhandene Features in der Datenbank haben Priorität.

  • Bei doppeltem Identifier wird das Feature aus der Eingabedatei übersprungen.

  • Verwendung: Erweiterung des Datenbestands ohne Änderung vorhandener Daten.

Vorhandene löschen (Delete Existing)

  • Eingabefeatures haben Priorität.

  • Bei doppeltem Identifier wird das vorhandene Feature in der Datenbank zuerst gelöscht.

  • Anschliessend wird das Feature aus der Eingabedatei importiert.

  • Verwendung: Ersetzen vorhandener Features ohne Historie.

Vorhandene terminieren (Terminate Existing)

  • Ähnlich wie Delete Existing, aber das vorhandene Feature wird terminiert statt physisch gelöscht.

  • Das Feature bleibt in der Datenbank und erhält eine Termination Time (Historie bleibt erhalten).

  • Anschliessend wird das Feature aus der Eingabedatei importiert.

  • Verwendung: Historie erhalten.

Import Optionen

Diese Einstellungen steürn Performance und Verarbeitungsverhalten.

Option Beschreibung Standardwert VCDB 4 VCDB 5 Eingabeformat

Im Vorschau-Modus ausführen

Führt den Import im Preview-Modus aus. Features werden geparst und validiert, aber nicht in die Datenbank geschrieben.

Off

Nein

Ja

CityGML, CityJSON

Indizes deaktivieren und automatisch reaktivieren

Wenn aktiv, werden Indizes vor der Verarbeitung deaktiviert und nach Abschluss des Imports automatisch wieder aktiviert.

Das kann grosse Importe beschleunigen, kann aber bei kleineren inkrementellen Importen zusätzlichen Overhead verursachen.

Off

Ja

Ja

CityGML, CityJSON

Anzahl der Threads

Anzahl paralleler Threads beim Import. Jeder Thread benötigt eine separate Datenbankverbindung.

4

Ja

Ja

CityGML, CityJSON

Log Level

Legt den minimalen Schweregrad der auszugebenden Ereignisse fest. Alle Nachrichten dieses Schweregrads oder höher werden angezeigt.

Siehe Log Level unten.

info

Ja

Ja

CityGML, CityJSON

Bei Fehlern sofort abbrechen

Wenn aktiv, stoppt der Task sofort beim ersten Fehler.

Off

Ja

Ja

CityGML, CityJSON

Ausdehnung berechnen und ersetzen

Wenn aktiv, werden Envelopes (Feature-Extents) aus den Geometrien berechnet und überschreiben Extents, die aus den Eingabedateien gelesen wurden.

On

Nein

Ja

CityGML, CityJSON

Nicht unterstützte Typen auf Generics abbilden

Wenn aktiv, werden City Objects aus nicht unterstützten CityJSON Extensions auf Generic City Objects gemappt. Unbekannte Extension-Attribute werden als Generic Attributes gespeichert.

Off

Nein

Ja

CityJSON

Appearance-Daten einlesen

Wenn aktiv, werden Appearance-Informationen (Textures, Materials) ebenfalls importiert.

On

Ja

Ja

CityGML, CityJSON

Themes

Optionale Liste von Appearance-Themes, die importiert werden sollen (komma-separiert).

Wenn leer, werden alle Appearances importiert. Verwenden Sie none, um Appearances ohne Theme einzuschliessen.

Nur relevant, wenn Appearance-Daten einlesen aktiv ist.

(leer)

Nein

Ja

CityGML, CityJSON

Log Level

Legt den minimalen Schweregrad der auszugebenden Ereignisse fest. Alle Nachrichten dieses Schweregrads oder höher werden angezeigt.

Die verfügbaren Log-Level, sortiert vom höchsten zum niedrigsten Schweregrad, sind:

Level Beschreibung Standardwert

fatal

Kritische Fehler, die zum sofortigen Abbruch führen (geringste Ausgabe).

error

Nicht behebbare Fehler.

warn

Warnungen zu potenziellen Problemen.

info

Allgemeine Betriebsmeldungen.

Standard

debug

Detaillierte Debug-Informationen.

trace

Detaillierteste Logs für die Fehlersuche.
Verwenden Sie debug oder trace zum Debugging oder in Support-Fällen.

Metadaten

Optionale Metadatenfelder zur Dokumentation des Importprozesses:

Option Beschreibung Standardwert

Datenabstammung oder Ursprung der Features

Lineage der importierten Daten (Origin-Informationen werden mit den Features gespeichert).

Aktualisierende Person

Name der verantwortlichen Person für den Import.

Datenbankbenutzer

Grund für die Aktualisierung

Begründung, warum dieser Import durchgeführt wird.

Für VCDB 5 Datenbanken unterstützt das Lineage-Feld die folgenden Platzhalter, die während des Imports automatisch ersetzt werden:

Platzhalter Beschreibung

@file_path@

Absoluter Pfad zur Import-Datei.

@file_name@

Name der Import-Datei.

@content_path@

Vollständiger logischer Pfad zum importierten Inhalt, einschliesslich ZIP-Einträgen (falls vorhanden).

@content_name@

Name des importierten Inhalts, z. B. der Dateiname oder der Name des ZIP-Eintrags.

Die Platzhalter file_* und content_* liefern bei normalen Dateien identische Ergebnisse. Bei ZIP-Archiven hingegen beziehen sich die file_* Platzhalter auf die ZIP-Datei selbst, während sich die content_* Platzhalter auf die jeweilige Datei im Archiv beziehen.

Filteroptionen

Diese Optionen erlauben es, den Import auf eine Teilmenge von Features einzuschränken.

Option Beschreibung Standardwert

Feature-IDs (kommagetrennt)

Komma-separierte Liste von Feature-Identifiern, die importiert werden sollen.

Feature-Typen

Ein oder mehrere Feature-Typen, die importiert werden sollen.

Beispiele (wie in der UI angezeigt):

  • Building

  • Bridge

  • CityFurniture

  • CityObjectGroup

  • GenericCityObject

Bounding Box

Räumlicher Filter als x_min,y_min,x_max,y_max in EPSG:4326 Koordinaten (WGS84). Die Publisher UI unterstützt aktüll nur EPSG:4326.

Mit Bounding Box aus der Datenbank abrufen (Aus der Datenbank laden) Icon können Sie die Bounding Box automatisch mit der räumlichen Ausdehnung der Daten aus der ausgewählten Datenbank füllen.
Klicken Sie auf Ausdehnung bearbeiten (Ausdehnung bearbeiten) Icon, um die Ausdehnung in der Karte zu zeichnen oder anzupassen.

Off

Bounding Box Modus

Definiert, wie der Bounding-Box-Filter angewendet wird:

  • Schneidet (Intersects): Importiert Features, deren Bounding Box die Filter-Bounding-Box schneidet.

  • Beinhaltet (Contains): Importiert nur Features, die vollständig innerhalb der Filter-Bounding-Box liegen.

  • Auf Kachel (On Tile, nur VCDB 5): Importiert Features, deren Bounding-Box-Zentrum innerhalb der Filter-Bounding-Box liegt.

Schneidet

Feature Limit

Begrenzt die Anzahl der verarbeiteten Features und kann optional am Anfang des Result Sets Features überspringen.

Verwendung:

  • Max. Anzahl …​: Maximale Anzahl der zu importierenden Features (Standard: 1000).

  • Startindex: 0-basierter Index des ersten Features im Result Set (Standard: 0).

Off
Max. Anzahl zu importierender Features und Startindex gelten über alle Input-Files hinweg und können separat oder gemeinsam verwendet werden. Damit sind Pagination-artige Importe bei grossen Datensätzen möglich.
Wenn mehrere Filter genutzt werden, müssen alle Bedingungen erfüllt sein, damit ein Feature importiert wird.
Filter werden nur auf Top-Level Features in den Eingabedateien angewendet. Matching Features werden zusammen mit ihren enthaltenen Subfeatures (CityGML) bzw. 2nd-level City Objects (CityJSON) importiert. Ein Filtern von Subfeatures / 2nd-level City Objects wird nicht unterstützt.

CityGML Upgrade Optionen

Diese Optionen stehen nur für CityGML Importe in eine VCDB 5 Datenbank zur Verfügung und helfen, Kompatibilitätsprobleme beim Import von CityGML 2.0 oder 1.0 zu beheben.

Option Beschreibung Standardwert

Verwende LoD4 als LoD3

Mappt LoD4 Geometrien auf LoD3 und ersetzt ein vorhandenes LoD3.

Off

LoD0 Dachkante abbilden

Mappt LoD0 Dachkanten-Geometrien auf Dachflächen (Roof Surfaces).

Off

LoD1 Multi-Oberflächen abbilden

Mappt LoD1 Multi-Oberflächen auf generische thematische Oberflächen.

Off

City Object Relationen erzeugen

Wenn aktiv, werden Relationen zwischen importierten City Objects während des Imports erzeugt.

On

Cross-LoD Referenzen auflösen

Wenn aktiv, werden Referenzen zwischen unterschiedlichen Levels of Detail (LoD) während des Imports aufgelöst.

On
Für weitere Informationen zu diesen Optionen siehe die VC Database Dokumentation zu CityGML Upgrade-Optionen.

Klicken Sie auf NÄCHSTER SCHRITT, um fortzufahren.

Schritt 4 (Task Zeitplan)

Option Beschreibung

Job schnellstmöglich starten

Job sofort starten.

Job zur angegebenen Zeit starten

Job für die Zukunft planen.

Job wiederholen

Der Job kann automatisch periodisch durchlaufen.

Ergebnis veröffentlichen

Nach erfolgreicher Konvertierung wird die Datenquelle direkt automatisch veröffentlicht.