ingestions uip pm, transformations uip pm

Syntaxe et options pour le déclenchement et l'inspection des ingestions de données Process Mining et des transformations dbt avec `uip pm ingestions` et `uip pm transformations`.

Une partie de l'outil uip pm . ingestions charge les fichiers de données chargés dans une application de processus; transformations gère et exécute les modèles SQL dbt qui reforment les données ingérées dans les tables interrogeables de l'application. Les deux prennent en charge --wait pour bloquer jusqu'à ce qu'une exécution se termine — voir Concepts sur la page parente.

Synthèse

uip pm ingestions create <app-id> [--stage dev|published] [--file-format csv|tsv] [--field-delimiter <char>] [--quote-character <char>] [--encoding utf-8|iso-8859-1] [--wait] [--timeout <s>] [--poll-interval <s>]
uip pm ingestions cancel <app-id> <ingestion-id> [--stage dev|published]
uip pm ingestions logs <app-id> <ingestion-id> [--stage dev|published] [--limit <n>] [--offset <n>]

uip pm transformations list <app-id> [--stage dev|published]
uip pm transformations get <app-id> <path> [--stage dev|published] [--destination <file>]
uip pm transformations create <app-id> <path> --file <local-file> [--stage dev|published]
uip pm transformations update <app-id> <path> --file <local-file> --etag <etag> [--stage dev|published]
uip pm transformations run <app-id> [--model <path>] [--wait] [--timeout <s>] [--poll-interval <s>]
uip pm transformations apply <app-id> [--stage dev|published] [--wait] [--timeout <s>] [--poll-interval <s>]
uip pm transformations cancel <app-id>
uip pm transformations status <app-id>
uip pm transformations logs <app-id>

ingestions uip pm

Déclenchez l’ingestion des fichiers de données téléchargés.

Arguments

Nom	Requis	Objectif
<app-id>	oui	ID de l'application de processus.

Options

Long	Valeur (Value)	Default	Description
--stage <stage>	dev | published	dev	Étape d’application dans laquelle ingérer.
--file-format <format>	csv | tsv	csv	Format de fichier de données.
--field-delimiter <char>	string	,	Délimiteur de champ dans les fichiers de données.
--quote-character <char>	string	"	Champs englobants entre guillemets.
--encoding <encoding>	utf-8 | iso-8859-1	utf-8	Encodage de fichier.
--wait	Drapeau	désactivé	Bloquez jusqu’à ce que l’ingestion atteigne un état terminal; quitter non-zéro en cas d’échec.
--timeout <seconds>	Integer	1800	Nombre maximal de secondes à attendre lorsque l’option --wait est définie.
--poll-interval <seconds>	Integer	5	Secondes entre les interrogations de statut lorsque --wait est défini.

Exemple

uip pm ingestions create 9c46289e --file-format csv --encoding iso-8859-1

Format des données (--sortie json)

Sans --wait:

{ "Code": "PmIngestionsCreate", "Data": { "Status": "Accepted", "Message": "Ingestion started. Poll 'uip pm apps list' (LastIngestion) for progress." } }

Avec --wait:

{ "Code": "PmIngestionsCreate", "Data": { "Status": "SUCCESS", "IngestionId": "1d7e1421" } }

En cas --wait d'échec, se termine non-zéro avec les propres lignes du journal des erreurs de l'ingestion ingestions logs intégrées dans le message d'échec.

ingestions uip pm - annuler

Annulez une ingestion qui est toujours en cours d’exécution.

Arguments

Nom	Requis	Objectif
<app-id>	oui	ID de l'application de processus.
<ingestion-id>	oui	ID d’ingestion (uip pm apps get <app-id> affiche LastIngestion).

Options

Long	Valeur (Value)	Default	Description
--stage <stage>	dev | published	dev	Étape de l'application sur laquelle l'ingestion s'exécute.

Exemple

uip pm ingestions cancel 9c46289e 1d7e1421

Format des données (--sortie json)

{ "Code": "PmIngestionsCancel", "Data": { "AppId": "9c46289e", "IngestionId": "1d7e1421", "Status": "Cancelling" } }

journaux d'ingestions uip pm

Récupérez les journaux d'une exécution d'ingestion.

Arguments

Nom	Requis	Objectif
<app-id>	oui	ID de l'application de processus.
<ingestion-id>	oui	ID d’ingestion.

Options

Long	Valeur (Value)	Default	Description
--stage <stage>	dev | published	dev	Étape de l'application sur laquelle l'ingestion a été exécutée.
--limit <number>	Integer	100	Nombre maximal d’entrées de journal à extraire (taille de la page).
--offset <number>	Integer	0	Nombre d'entrées de journal à ignorer avant la page.

Exemple

uip pm ingestions logs 9c46289e 1d7e1421 --limit 50 --offset 50

Format des données (--sortie json)

{ "Code": "PmIngestionsLogs", "Data": [{ "Message": "Data run started" }] }

liste des transformations uip pm

Répertoriez les fichiers de transformation (modèle dbt) d'une application de processus.

Nom/Option	Requis	Objectif
<app-id>	oui	ID de l'application de processus.
--stage <stage>	non	dev | published, par défaut dev.

{ "Code": "PmTransformationsList", "Data": {} }

uip pm transformations - Obtenir

Obtenez le contenu d'un fichier de transformation, plus son ETag, qui update requiert la valeur --etag.

Nom/Option	Requis	Objectif
<app-id>	oui	ID de l'application de processus.
<path>	oui	Chemin du fichier de transformation, par exemple models/Cases.sql.
--stage <stage>	non	dev | published, par défaut dev.
--destination <local-file>	non	Écrivez du contenu dans ce fichier local au lieu de l'enveloppe de sortie.

{ "Code": "PmTransformationsGet", "Data": { "Path": "models/Cases.sql", "ETag": "W/\"...\"", "Content": "select ..." } }

création de transformations uip pm

Créez un nouveau fichier de transformation à partir d'un fichier local. Utilisez update pour modifier un chemin existant — cela échouera si le chemin existe déjà.

Options

Long	Valeur (Value)	Requis	Description
--file <local-file>	Chemin d'accès	oui	Fichier local avec le nouveau contenu.
--stage <stage>	dev | published	non	Par défaut dev.

uip pm transformations create 9c46289e models/Workload.sql --file ./Workload.sql

{ "Code": "PmTransformationsCreate", "Data": { "Path": "models/Workload.sql", "ETag": "W/\"...\"" } }

mise à jour des transformations uip pm

Mettez à jour un fichier de transformation à partir d'un fichier local (protégé par ETag).

Options

Long	Valeur (Value)	Requis	Description
--file <local-file>	Chemin d'accès	oui	Fichier local avec le nouveau contenu.
--etag <etag>	string	oui	ETag du fichier sur lequel cette modification est basée, à partir de transformations get.
--stage <stage>	dev | published	non	Par défaut dev.

uip pm transformations update 9c46289e models/Cases.sql --file ./Cases.sql --etag 'W/"639204059477096903"'

{ "Code": "PmTransformationsUpdate", "Data": { "Path": "models/Cases.sql", "ETag": "W/\"639209312397638135\"" } }

Une version --etag obsolète échoue avec un conflit — relecture via transformations get, refaire la modification et réessayer.

exécution des transformations uip pm

Exécutez les transformations dbt sur l’étape de développement pour créer uniquement des modèles modifiés/dépendants. Utilisez apply pour forcer une réexécution complète sur les données déjà ingérées.

Options

Long	Valeur (Value)	Default	Description
--stage <stage>	dev	dev	Seul dev est pris en charge.
--model <model-path>	Chemin d'accès	—	Exécutez uniquement ce modèle (par exemple models/Cases.sql) et ses dépendances. Omettez pour tout exécuter.
--wait	Drapeau	désactivé	Bloquer jusqu'à ce que le développement atteigne un état terminal; quitter non-zéro en cas d'échec (imprime automatiquement l'erreur dbt).
--timeout <seconds>	Integer	1800	Nombre maximal de secondes à attendre.
--poll-interval <seconds>	Integer	5	Secondes entre les interrogations.

Exemple

uip pm transformations run 9c46289e --model models/Cases.sql

Format des données (--sortie json)

{ "Code": "PmTransformationsRun", "Data": { "Status": "Accepted", "Message": "Build started. Re-run with --wait to block until it finishes, or poll 'uip pm transformations status 9c46289e'." } }

annulation des transformations uip pm

Annuler la construction dbt actuellement en cours d'exécution au niveau du développement.

uip pm transformations cancel 9c46289e

{ "Code": "PmTransformationsCancel", "Data": { "AppId": "9c46289e", "Status": "Cancelling" } }

les transformations uip pm s'appliquent

Réexécutez la transformation de données complète sur les données déjà ingérées (contrairement à run, qui génère uniquement des modèles de développement modifiés).

Long	Valeur (Value)	Default	Description
--stage <stage>	dev | published	dev	Étape de l’application.
--wait	Drapeau	désactivé	Bloquez jusqu’à ce que la transformation atteigne un état terminal; quitter non-zéro en cas d’échec.
--timeout <seconds>	Integer	1800	Nombre maximal de secondes à attendre.
--poll-interval <seconds>	Integer	5	Secondes entre les interrogations.

uip pm transformations apply 9c46289e

{ "Code": "PmTransformationsApply", "Data": { "Status": "Accepted", "Message": "Transform started. Poll 'uip pm apps list' (LastIngestion) for progress." } }

statut des transformations uip pm

Obtenez le statut de la version de transformation actuelle/dernière version.

uip pm transformations status 9c46289e

{ "Code": "PmTransformationsStatus", "Data": {} }

journaux des transformations uip

Obtenez les journaux de la version de transformation actuelle/dernière version.

uip pm transformations logs 9c46289e

{ "Code": "PmTransformationsLogs", "Data": {} }

Associé

• uip pm — vue d'ensemble, apps, files
• apps model — modifications de mappage de modèle/champ/données qui nécessitent une réingestion ou une reformation pour prendre effet.
• conformance, deviations et query — analyse le résultat.

Voir également

• Options globales
• Codes de sortie