uip pm ingestions, uip pm transformations

Syntax and options for triggering and inspecting Process Mining data ingestions and dbt transformations with `uip pm ingestions` and `uip pm transformations`.

Part of the uip pm tool. ingestions loads uploaded data files into a process app; transformations manages and runs the dbt SQL models that reshape ingested data into the app's queryable tables. Both support --wait to block until a run finishes — see Concepts on the parent page.

Sinopsis

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>

uip pm ingestions create

Trigger an ingestion of the uploaded data files.

Argumentos

Nombre	Obligatorio	Propósito
<app-id>	Sí	Process app ID.

Opciones

Largo	Valor	Predeterminado	Descripción
--stage <stage>	dev | published	dev	App stage to ingest into.
--file-format <format>	csv | tsv	csv	Data file format.
--field-delimiter <char>	String	,	Field delimiter in the data files.
--quote-character <char>	String	"	Quote character enclosing fields.
--encoding <encoding>	utf-8 | iso-8859-1	utf-8	File encoding.
--wait	Marca	Desactivado	Block until the ingestion reaches a terminal state; exit non-zero on failure.
--timeout <seconds>	Entero	1800	Max seconds to wait when --wait is set.
--poll-interval <seconds>	Entero	5	Seconds between status polls when --wait is set.

Ejemplo

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

Forma de datos (--json de salida)

Sin --wait:

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

Con --wait:

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

On --wait failure, exits non-zero with the ingestion's own error-log lines (via ingestions logs) folded into the failure message.

uip pm ingestions cancel

Cancel an ingestion that is still running.

Argumentos

Nombre	Obligatorio	Propósito
<app-id>	Sí	Process app ID.
<ingestion-id>	Sí	Ingestion ID (uip pm apps get <app-id> shows LastIngestion).

Opciones

Largo	Valor	Predeterminado	Descripción
--stage <stage>	dev | published	dev	App stage the ingestion runs on.

Ejemplo

uip pm ingestions cancel 9c46289e 1d7e1421

Forma de datos (--json de salida)

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

uip pm ingestions logs

Get the logs of an ingestion run.

Argumentos

Nombre	Obligatorio	Propósito
<app-id>	Sí	Process app ID.
<ingestion-id>	Sí	Ingestion ID.

Opciones

Largo	Valor	Predeterminado	Descripción
--stage <stage>	dev | published	dev	App stage the ingestion ran on.
--limit <number>	Entero	100	Max log entries to fetch (page size).
--offset <number>	Entero	0	Number of log entries to skip before the page.

Ejemplo

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

Forma de datos (--json de salida)

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

uip pm transformations list

List the transformation (dbt model) files of a process app.

Name/Option	Obligatorio	Propósito
<app-id>	Sí	Process app ID.
--stage <stage>	No	dev | published, default dev.

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

uip pm transformations get

Get the content of a transformation file, plus its ETag — which update requires as --etag.

Name/Option	Obligatorio	Propósito
<app-id>	Sí	Process app ID.
<path>	Sí	Transformation file path, e.g. models/Cases.sql.
--stage <stage>	No	dev | published, default dev.
--destination <local-file>	No	Write content to this local file instead of the output envelope.

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

uip pm transformations create

Create a new transformation file from a local file. Use update to modify an existing one — this fails if the path already exists.

Opciones

Largo	Valor	Obligatorio	Descripción
--file <local-file>	Ruta	Sí	Local file with the new content.
--stage <stage>	dev | published	No	Default dev.

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

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

uip pm transformations update

Update a transformation file from a local file (ETag-safe).

Opciones

Largo	Valor	Obligatorio	Descripción
--file <local-file>	Ruta	Sí	Local file with the new content.
--etag <etag>	String	Sí	ETag of the file this edit is based on, from transformations get.
--stage <stage>	dev | published	No	Default 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\"" } }

A stale --etag fails with a conflict — re-read via transformations get, redo the edit, and retry.

uip pm transformations run

Run the dbt transformations on the dev stage — builds only changed/dependent models. Use apply to force a full re-run on already-ingested data.

Opciones

Largo	Valor	Predeterminado	Descripción
--stage <stage>	dev	dev	Solo se admite dev.
--model <model-path>	Ruta	—	Run only this model (e.g. models/Cases.sql) and its dependents. Omit to run everything.
--wait	Marca	Desactivado	Block until the build reaches a terminal state; exit non-zero on failure (auto-prints the dbt error).
--timeout <seconds>	Entero	1800	Max seconds to wait.
--poll-interval <seconds>	Entero	5	Seconds between polls.

Ejemplo

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

Forma de datos (--json de salida)

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

uip pm transformations cancel

Cancel the dbt build currently running on dev.

uip pm transformations cancel 9c46289e

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

uip pm transformations apply

Re-run the full data transformation on already-ingested data (unlike run, which builds only changed dev models).

Largo	Valor	Predeterminado	Descripción
--stage <stage>	dev | published	dev	App stage.
--wait	Marca	Desactivado	Block until the transform reaches a terminal state; exit non-zero on failure.
--timeout <seconds>	Entero	1800	Max seconds to wait.
--poll-interval <seconds>	Entero	5	Seconds between polls.

uip pm transformations apply 9c46289e

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

uip pm transformations status

Get the status of the current/last transformation build.

uip pm transformations status 9c46289e

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

uip pm transformations logs

Get the logs of the current/last transformation build.

uip pm transformations logs 9c46289e

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

Relacionado

• uip pm — overview, apps, files.
• apps model — model/field/data-mapping changes that need re-ingestion or re-transformation to take effect.
• conformance, deviations & query — analyze the result.

Ver también

• Opciones globales
• Códigos de salida