Datenbank Export

Ein Datenbank Export Task exportiert Features aus einer der konfigurierten Datenbanken in eine Datei.

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 Quell-Datenbank für den Export ausgewählt werden.

Datenbank wählen

Wählen Sie die Datenbank aus, aus der die Daten exportiert 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 Export 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 Ausgabedatei und die Export-Optionen.

Ausgabedatei

Wählen Sie einen Namen für das Ausgabe-Archiv (zum Beispiel my-export).

Das Export-Ergebnis wird als .zip Archiv zum Download bereitgestellt.

Wenn der Export Texturbilder enthält, sind sie im Archiv unter appearance enthalten. Wenn der Export Library Objects aus impliziten Geometrien enthält, sind sie unter library-objects enthalten.

Exportformat

Wählen Sie das Ausgabeformat:

  • CityGML (Standard)

  • CityJSON

Version

Wählen Sie die Version des gewählten Exportformats.

Welche Versionen verfügbar sind, hängt von der ausgewählten Datenbank ab (VCDB 4 vs VCDB 5).
Option Beschreibung Standardwert

CityGML Version

  • VCDB 4: Auf 2.0 fixiert.

  • VCDB 5: Versionen 3.0, 2.0 und 1.0 sind auswählbar.

VCDB 4: 2.0; VCDB 5: 3.0

CityJSON Version

  • VCDB 4: Auf 1.0 fixiert.

  • VCDB 5: Versionen 2.0, 1.1 und 1.0 sind auswählbar.

VCDB 4: 1.0; VCDB 5: 2.0
Wenn CityGML-Daten in einer anderen Version exportiert werden als sie importiert wurden, kann es zu Datenverlust kommen, da CityGML-Versionen nicht voll kompatibel sind. Inhalte, die nicht automatisch konvertiert werden können, werden übersprungen. Details finden Sie in der VC Database Dokumentation zu Kompatibilität und Datenmigration.

Export nach CityJSON

Für VCDB 5 Datenbanken werden CityJSON-Exporte für Version 1.1/2.0 als CityJSON Text Sequence (CityJSONSeq) erzeugt. Das unterstützt Streaming grosser Exporte, indem ein CityJSONFeature Objekt pro Zeile geschrieben wird. CityJSON 1.0 unterstützt kein Streaming/CityJSONSeq und wird daher nur für kleinere Datensätze empfohlen.

Für grosse Exporte nutzen Sie die Filteroptionen dieses Tasks, um die Exportmenge zu reduzieren.

Exportoptionen

Diese Einstellungen steürn Performance und Verarbeitungsverhalten.

Option Beschreibung Standardwert VCDB 4 VCDB 5 Ausgabeformat

Appearances exportieren

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

On

Ja

Ja

CityGML, CityJSON

Themes

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

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

Nur relevant, wenn Appearances exportieren aktiv ist.

Klicken Sie auf Appearance Themes aus der Datenbank laden (Aus der Datenbank laden) Icon, um verfügbare Themes aus der Datenbank zu laden.

(leer)

Ja

Ja

CityGML, CityJSON

Anzahl der Threads

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

Der Standardwert in der Publisher UI ist 4. Zu hohe Thread-Zahlen können durch Thrashing zu Performance-Problemen führen. Stellen Sie sicher, dass die Datenbank die benötigte Anzahl gleichzeitiger Verbindungen verarbeiten kann.

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

LoD Filter

Wenn aktiv, werden nur Features mit passenden Levels of Detail (LoD) exportiert.

Verwendung:

  • LoDs: Wählen Sie ein oder mehrere LoDs (z.B. 2 und 3).

  • Modus: Definiert, wie mehrere LoDs behandelt werden (Standard: ODER (OR)):

    • ODER (OR): Exportiert Features, die mindestens einen der ausgewählten LoDs besitzen.

    • UND (AND): Exportiert nur Features, die alle ausgewählten LoDs besitzen.

    • Minimum: Wie ODER (OR), exportiert aber nur den niedrigsten LoD aus der Auswahl, der vorhanden ist.

    • Maximum: Wie ODER (OR), exportiert aber nur den höchsten LoD aus der Auswahl, der vorhanden ist.

  • Suchtiefe: Anzahl der Subfeature-Level, die nach passenden LoDs durchsucht werden. Verwenden Sie 0, um nur das Feature selbst und seine Boundaries zu berücksichtigen (Standard: 0). Höhere Werte können die Laufzeit der Datenbankabfrage deutlich erhöhen.

Off

Ja

Ja

CityGML, CityJSON

Feature Versionsgültigkeit

Wenn aktiv, werden Features anhand ihrer zeitlichen Gültigkeit gefiltert.

Felder in der UI:

  • Gültigkeitsmodus: Exportiert Gültig, Ungültig oder Alle Features.

  • am: Wenn aktiv, Gültigkeitsdatum und Gültigkeitszeit über die Datum-/Uhrzeit-Auswahl setzen. Der Task prüft die Gültigkeit zu diesem Zeitpunkt.

  • Referenz (nur VCDB 5): Legt fest, welche Zeitreferenz für die Gültigkeitsprüfung verwendet wird:

    • Datenbank: Eine Feature-Version gilt als gültig, wenn sie zum ausgewählten Zeitpunkt in der Datenbank existiert (basierend auf den Spalten creation_date und termination_date).

    • Reale Welt: Ein Feature gilt als gültig, wenn es zum ausgewählten Zeitpunkt in der realen Welt gültig ist (basierend auf den Spalten valid_from und valid_to).

  • Nachsichtige Validierung (nur VCDB 5): Gültigkeitsprüfungen sind strikt, sofern Nachsichtige Validierung nicht aktiviert ist. Wenn aktiv, werden unvollständige Gültigkeitsintervalle als gültig behandelt.

Off

Ja

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.
Für den Export historischer Versionen müssen diese Versionen in der Datenbank vorhanden bleiben. Features, die physisch gelöscht wurden, können nicht mehr exportiert werden. Um Historie zu behalten, terminieren Sie Features statt sie zu löschen (siehe Datenbank Löschen, Modus = Terminieren).

Filteroptionen

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

Option Beschreibung Standardwert

Feature-IDs (kommagetrennt)

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

Feature-Typen

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

Beispiele (wie in der UI angezeigt):

  • Building

  • Bridge

  • CityFurniture

  • CityObjectGroup

  • GenericCityObject

Wenn Sie auf Feature-Typen aus der Datenbank laden (Aus der Datenbank laden) Icon klicken, können nur Feature-Typen ausgewählt werden, die in der ausgewählten Datenbank existieren.

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): Exportiert Features, deren Bounding Box die Filter-Bounding-Box schneidet.

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

  • Auf Kachel (On Tile, nur VCDB 5): Exportiert Features, deren Bounding-Box-Zentrum innerhalb der Filter-Bounding-Box liegt (nützlich für tiled Exports).

Schneidet

Feature Limit

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

Verwendung:

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

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

Off

Expertenfilter

Klicken Sie auf (Expertenfilter) das Icon, um den Expertenfilter Editor einzublenden und Filterausdrücke direkt einzugeben.

Für VCDB 4 Datenbanken verwendet der Expertenfilter XML query expressions.

Für VCDB 5 Datenbanken verwendet der Expertenfilter JSON-basierte Filterausdrücke, die eine erweiterte Filterung von Features ermöglichen.

Weitere Informationen finden Sie in der VC Database Dokumentation zu Filterung von Features.

Off
Max. Anzahl zu exportierender Features und Startindex gelten für das gefilterte Result Set und können separat oder gemeinsam verwendet werden. Damit sind Pagination-artige Exporte bei grossen Datensätzen möglich.
Wenn mehrere Filter genutzt werden, müssen alle Bedingungen erfüllt sein, damit ein Feature exportiert wird.

CityGML Upgrade Optionen

Diese Optionen sind nur bei Exporten aus einer VCDB 5 Datenbank verfügbar.

Diese Optionen helfen, Kompatibilitätsprobleme beim Export von Daten zu vermeiden, die ursprünglich aus CityGML 2.0 oder 1.0 stammen.

Option Beschreibung Standardwert

Verwende LoD4 als LoD3

Mappt LoD4 Geometrien auf LoD3 und ersetzt ein vorhandenes LoD3.

Off

LoD0 Dachkante abbilden (nur CityGML)

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

Off

LoD1 Multi-Oberflächen abbilden (nur CityGML)

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

Off
Beim Export nach CityJSON wird nur Verwende LoD4 als LoD3 unterstützt. Die anderen Upgrade-Optionen gelten nur für CityGML Exporte.
Für weitere Informationen zu diesen Optionen siehe die VC Database Dokumentation zu CityGML Upgrade-Optionen.

Schreiboptionen

Option Beschreibung Standardwert

Bei Fehlern sofort abbrechen

Stoppt den Export sofort beim ersten Fehler.

Off

Formatierte Ausgabe (Pretty Print)

Nur bei Exporten aus einer VCDB 5 Datenbank und beim Export nach CityGML oder CityJSON 1.0 verfügbar.

Wenn aktiv, wird die exportierte Ausgabe formatiert (Whitespace/Indentation). Das verbessert die Lesbarkeit, kann aber die Dateigrösse erhöhen.

On

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.