ingestiones de uip pm, transformaciones de uip pm

Sintaxis y opciones para desencadenar e inspeccionar ingestiones de datos de Process Mining y transformaciones dbt con `ingestiones de uip pm` y `transformaciones de uip pm`.

Parte de la herramienta uip pm . ingestions carga los archivos de datos cargados en una aplicación de proceso; transformations gestiona y ejecuta los modelos SQL dbt que transforman los datos ingeridos en las tablas consultables de la aplicación. Ambos admiten --wait para bloquear hasta que finalice una ejecución — consulta Conceptos en la página principal.

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>

creación de ingestiones de uip pm

Desencadena una ingestión de los archivos de datos cargados.

Argumentos

Nombre	Obligatorio	Propósito
<app-id>	Sí	ID de la aplicación de proceso.

Opciones

Largo	Valor	Predeterminado	Descripción
--stage <stage>	dev | published	dev	Etapa de la aplicación en la que ingerir.
--file-format <format>	csv | tsv	csv	Formato de archivo de datos.
--field-delimiter <char>	String	,	Delimitador de campo en los archivos de datos.
--quote-character <char>	String	"	Comillas que encierran campos.
--encoding <encoding>	utf-8 | iso-8859-1	utf-8	Codificación de archivos.
--wait	Marca	Desactivado	Bloquear hasta que la ingestión alcance un estado terminal; salir distinto de cero en caso de fallo.
--timeout <seconds>	Entero	1800	Máximo de segundos de espera cuando se establece --wait.
--poll-interval <seconds>	Entero	5	Segundos entre sondeos de estado cuando se establece --wait.

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" } }

En caso de error --wait, sale distinto de cero con las propias líneas de registro de errores de la ingestión (a través de ingestions logs) plegadas en el mensaje de error.

cancelación de ingestiones de uip pm

Cancelar una ingestión que aún se esté ejecutando.

Argumentos

Nombre	Obligatorio	Propósito
<app-id>	Sí	ID de la aplicación de proceso.
<ingestion-id>	Sí	ID de ingestión (uip pm apps get <app-id> muestra LastIngestion).

Opciones

Largo	Valor	Predeterminado	Descripción
--stage <stage>	dev | published	dev	Etapa de la aplicación en la que se ejecuta la ingestión.

Ejemplo

uip pm ingestions cancel 9c46289e 1d7e1421

Forma de datos (--json de salida)

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

registros de ingestión de uip pm

Obtener los registros de una ejecución de ingestión.

Argumentos

Nombre	Obligatorio	Propósito
<app-id>	Sí	ID de la aplicación de proceso.
<ingestion-id>	Sí	ID de ingestión.

Opciones

Largo	Valor	Predeterminado	Descripción
--stage <stage>	dev | published	dev	Etapa de la aplicación en la que se ejecutó la ingestión.
--limit <number>	Entero	100	Máximo de entradas de registro para recuperar (tamaño de página).
--offset <number>	Entero	0	Número de entradas de registro que se omitirán antes de la página.

Ejemplo

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

Forma de datos (--json de salida)

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

lista de transformaciones de uip pm

Enumera los archivos de transformación (modelo dbt) de una aplicación de proceso.

Nombre/Opción	Obligatorio	Propósito
<app-id>	Sí	ID de la aplicación de proceso.
--stage <stage>	No	dev | published, predeterminado dev.

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

uip pm transformaciones get

Obtenga el contenido de un archivo de transformación, más su ETag, que update requiere como --etag.

Nombre/Opción	Obligatorio	Propósito
<app-id>	Sí	ID de la aplicación de proceso.
<path>	Sí	Ruta del archivo de transformación, por ejemplo models/Cases.sql.
--stage <stage>	No	dev | published, predeterminado dev.
--destination <local-file>	No	Escribir contenido en este archivo local en lugar de en el sobre de salida.

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

uip pm transformaciones create

Crea un nuevo archivo de transformación a partir de un archivo local. Utiliza update para modificar uno existente: esto falla si la ruta ya existe.

Opciones

Largo	Valor	Obligatorio	Descripción
--file <local-file>	Ruta	Sí	Archivo local con el nuevo contenido.
--stage <stage>	dev | published	No	Predeterminado dev.

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

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

actualización de transformaciones de uip pm

Actualizar un archivo de transformación desde un archivo local (ETag-safe).

Opciones

Largo	Valor	Obligatorio	Descripción
--file <local-file>	Ruta	Sí	Archivo local con el nuevo contenido.
--etag <etag>	String	Sí	ETag del archivo en el que se basa esta edición, de transformations get.
--stage <stage>	dev | published	No	Predeterminado 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\"" } }

Un --etag obsoleto falla con un conflicto: vuelve a leer a través de transformations get, rehace la edición y vuelve a intentarlo.

Ejecución de transformaciones de uip pm

Ejecuta las transformaciones dbt en la etapa dev: crea solo modelos cambiados/dependientes. Utiliza apply para forzar una nueva ejecución completa en los datos ya incorporados.

Opciones

Largo	Valor	Predeterminado	Descripción
--stage <stage>	dev	dev	Solo se admite dev.
--model <model-path>	Ruta	—	Ejecutar solo este modelo (por ejemplo models/Cases.sql) y sus dependientes. Omitir para ejecutar todo.
--wait	Marca	Desactivado	Bloquear hasta que la compilación alcance un estado terminal; salida distinta de cero en caso de fallo (imprime automáticamente el error dbt).
--timeout <seconds>	Entero	1800	Máximo de segundos de espera.
--poll-interval <seconds>	Entero	5	Segundos entre sondeos.

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'." } }

Cancelar transformaciones de uip pm

Cancela la compilación de dbt que se está ejecutando actualmente en dev.

uip pm transformations cancel 9c46289e

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

se aplican las transformaciones de uip pm

Vuelve a ejecutar la transformación de datos completa en los datos ya incorporados (a diferencia de run, que solo crea modelos de desarrollo modificados).

Largo	Valor	Predeterminado	Descripción
--stage <stage>	dev | published	dev	Etapa de la aplicación.
--wait	Marca	Desactivado	Bloquear hasta que la transformación alcance un estado terminal; salir distinto de cero en caso de fallo.
--timeout <seconds>	Entero	1800	Máximo de segundos de espera.
--poll-interval <seconds>	Entero	5	Segundos entre sondeos.

uip pm transformations apply 9c46289e

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

estado de las transformaciones de uip pm

Obtener el estado de la compilación de transformación actual/última.

uip pm transformations status 9c46289e

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

registros de transformaciones de uip pm

Obtenga los registros de la compilación de transformación actual/última.

uip pm transformations logs 9c46289e

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

Relacionado

• uip pm : descripción general, apps, files.
• apps model : cambios en el modelo/campo/asignación de datos que necesitan volver a ingerirse o transformarse para que surtan efecto.
• conformance, deviations y query : analiza el resultado.

Ver también

• Opciones globales
• Códigos de salida