Esecuzione parallela
Ultimo aggiornamento: 14/10/2026QV2QS converte più progetti contemporaneamente utilizzando un pool di processi configurabile.
Configurazione del worker
Per impostazione predefinita, QV2QS rileva automaticamente il numero ottimale di worker in base al numero di core logici della CPU presenti sulla macchina. L'impostazione predefinita (--batchWorkers 0) utilizza un worker in meno rispetto al numero di core, lasciando un core libero per il processo dell'orchestratore e il sistema operativo.
Per eseguire l'override con un conteggio esplicito, passare --batchWorkers N:
QV2QS.exe --batchDir "C:\Projects" --outputDir C:\Output --batchWorkers 4 --unbuildOnly
Se il numero di worker specificato supera il numero di core CPU disponibili, QV2QS stampa un avviso. Ogni worker aggiuntivo oltre il numero di core comporta un overhead di memoria di circa 80 MB, a fronte di un miglioramento minimo del tempo di esecuzione effettivo.
La fase di conversione locale utilizza un pool di processi. Ciascun worker viene eseguito in un processo separato, consentendo un vero parallelismo della CPU per il parsing XML, l'attraversamento del grafo degli oggetti e la generazione JSON che costituiscono la conversione. Se un progetto fallisce, i progetti rimanenti continuano. Ciascun processo worker scrive un file di log separato nella sottocartella logs/ del progetto.
La distribuzione cloud utilizza un pool di thread con lo stesso numero di worker. Una volta completate tutte le conversioni locali, QV2QS distribuisce le app convertite su Qlik Cloud in parallelo. L'output della console viene semplificato durante la distribuzione cloud parallela — gli spinner animati vengono sostituiti da righe di avanzamento statiche per evitare un output illeggibile.
Gestione errori
La modalità batch prosegue anche in caso di errori. Se un progetto fallisce durante la conversione, QV2QS registra l'errore e prosegue con i progetti rimanenti. Il progetto non riuscito viene visualizzato nel riepilogo del batch con una descrizione dell'errore. Il codice di uscita del batch è 0 quando tutti i progetti hanno esito positivo e 1 quando un qualsiasi progetto ha esito negativo.
L'isolamento degli errori si applica anche alla generazione dei report. Se un progetto viene convertito con successo ma la generazione del report Excel non riesce, il progetto viene comunque conteggiato come riuscito. L'errore del report viene registrato separatamente.
Gli errori di distribuzione cloud vengono isolati allo stesso modo. Se un progetto non riesce a essere distribuito, i progetti rimanenti continuano a essere distribuiti.