Documentation Catenivo

Français

Catenivo
English

Français

Catenivo
English

Appearance

Ligne de commandes ​

Le CLI Catenivo permet d’exécuter un projet .etl sans ouvrir l’interface graphique. Il convient aux scripts, traitements planifiés et intégrations d’exploitation.

Disponibilité ​

Windows : l’installateur desktop contient le lanceur CLI et peut ajouter son dossier au PATH utilisateur.

powershell
catenivo.exe --version
catenivo.exe --lang fr --help

Linux : le paquet Debian et l’AppImage embarquent le runtime nécessaire aux sous-projets, mais n’installent pas le CLI autonome. La commande /usr/bin/catenivo du paquet Debian lance l’application desktop. Le contrat retenu pour Linux est un CLI séparé sous forme de dossier portable dist-cli, afin d’éviter une collision de commande et une duplication du runtime dans les paquets desktop.

Pour une copie CLI Linux construite depuis les sources :

bash
./dist-cli/catenivo --version
./dist-cli/catenivo --lang en --help

Ne remplacez pas le desktop /usr/bin/catenivo par ce binaire portable.

Exécuter un projet ​

powershell
catenivo.exe run "C:\\Traitements\\projet.etl"

Le CLI utilise la version active enregistrée dans le document, sauf sélection explicite avec --project-version.

Paramètres ​

powershell
catenivo.exe run "C:\\Traitements\\projet.etl" `
  --param fichier_source="C:\\Donnees\\entree.csv" `
  --param distance=25

Pour un secret :

powershell
$env:CATENIVO_TOKEN = "..."
catenivo.exe run "C:\\Traitements\\projet.etl" `
  --param-env jeton_api=CATENIVO_TOKEN

Rejets et codes de sortie ​

Par défaut, un traitement peut se terminer avec des rejets. Ajoutez --fail-on-reject si votre ordonnanceur doit distinguer ce cas.

Codes principaux :

  • 0 : traitement terminé ;
  • 1 : erreur d’exécution ;
  • 2 : arguments ou configuration invalides ;
  • 3 : traitement terminé avec rejets et --fail-on-reject ;
  • 70 : runtime embarqué indisponible ;
  • 130 : annulation.

Rapports et JSON ​

--report écrit un rapport final JSON. --json produit des événements NDJSON sur stdout pour une intégration machine.

Caches ​

Le CLI n’utilise pas les caches d’inspection de l’interface et désactive les opérateurs d’inspection pour ses exécutions. Les fichiers de travail techniques restent possibles pour les tris, jointures ou autres traitements qui en ont besoin.

Pour les détails avancés, consultez la documentation développeur du dépôt.