Parallele Ausführung
Letzte Aktualisierung: 14.10.2026QV2QS konvertiert mehrere Projekte gleichzeitig mithilfe eines konfigurierbaren Prozesspools.
Worker-Konfiguration
Standardmäßig erkennt QV2QS automatisch die optimale Worker-Anzahl basierend auf der Anzahl der logischen CPU-Kerne auf dem Rechner. Die Standardeinstellung (--batchWorkers 0) verwendet einen Worker weniger als die Anzahl der Kerne, sodass ein Kern für den Orchestrator-Prozess und das Betriebssystem frei bleibt.
Um mit einer expliziten Anzahl zu überschreiben, übergeben Sie --batchWorkers N:
QV2QS.exe --batchDir "C:\Projects" --outputDir C:\Output --batchWorkers 4 --unbuildOnly
Wenn die angegebene Worker-Anzahl die Anzahl der verfügbaren CPU-Kerne überschreitet, gibt QV2QS eine Warnung aus. Jeder zusätzliche Worker über die Anzahl der Kerne hinaus verursacht einen Speicher-Overhead von etwa 80 MB bei minimaler Verbesserung der Wall-Clock-Zeit.
Die lokale Konvertierungsphase verwendet einen Prozesspool. Jeder Worker wird in einem separaten Prozess ausgeführt, was echte CPU-Parallelität für das XML-Parsing, das Traversieren des Objektgraphen und die JSON-Generierung ermöglicht, aus denen die Konvertierung besteht. Wenn ein Projekt fehlschlägt, laufen die verbleibenden Projekte weiter. Jeder Worker-Prozess schreibt eine separate Protokolldatei in den Projektunterordner logs/.
Die Cloud-Bereitstellung verwendet einen Thread-Pool mit derselben Worker-Anzahl. Nachdem alle lokalen Konvertierungen abgeschlossen sind, stellt QV2QS die konvertierten Apps parallel in Qlik Cloud bereit. Die Konsolenausgabe wird während der parallelen Cloud-Bereitstellung vereinfacht — animierte Spinner werden durch statische Fortschrittszeilen ersetzt, um eine unleserliche Ausgabe zu vermeiden.
Fehlerbearbeitung
Der Batch-Modus wird trotz Fehlern fortgesetzt. Wenn ein Projekt während der Konvertierung fehlschlägt, protokolliert QV2QS den Fehler und fährt mit den verbleibenden Projekten fort. Das fehlgeschlagene Projekt wird in der Batch-Zusammenfassung mit einer Fehlerbeschreibung angezeigt. Der Batch-Exit-Code lautet 0, wenn alle Projekte erfolgreich sind, und 1, wenn ein Projekt fehlschlägt.
Die Fehlerisolierung gilt auch für die Berichterstellung. Wenn ein Projekt erfolgreich konvertiert wird, aber der Excel-Bericht nicht generiert werden kann, wird das Projekt dennoch als erfolgreich gewertet. Der Berichtsfehler wird separat protokolliert.
Fehler bei der Cloud-Bereitstellung werden auf dieselbe Weise isoliert. Wenn die Bereitstellung eines Projekts fehlschlägt, werden die verbleibenden Projekte weiterhin bereitgestellt.