UIP PM の取り込み、UIP PM の変換

「uip pm ingestions」および「uip pm transformations」を使用した、Process Mining のデータ取り込みと dbt 変換をトリガーおよび検査するための構文とオプション。

uip pmツールの一部です。ingestions は、アップロードされたデータ ファイルをプロセス アプリに読み込みます。 transformations は、取り込まれたデータをアプリのクエリ可能なテーブルに再形成する dbt SQL モデルを管理および実行します。どちらも、実行が完了するまでブロックする --wait をサポートしています。詳しくは、親ページの 「概念 」をご覧ください。

概要

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 の取り込み 作成

アップロードしたデータ ファイルの取り込みをトリガーします。

引数

名前	Required	目的
<app-id>	○	プロセス アプリ ID です。

オプション

長押し	値 (Value)	既定 (Default)	説明
--stage <stage>	dev | published	dev	取り込むアプリのステージです。
--file-format <format>	csv | tsv	csv	データ ファイル形式。
--field-delimiter <char>	string	,	データ ファイルのフィールド区切り文字。
--quote-character <char>	string	"	フィールドを引用符で囲む文字を使用します。
--encoding <encoding>	utf-8 | iso-8859-1	utf-8	ファイルのエンコード。
--wait	フラグ	無効	取り込みが終了ステートに達するまでブロックします。失敗時にゼロ以外で終了します。
--timeout <seconds>	integer	1800	[ --wait ] の設定時に待機する最大秒数です。
--poll-interval <seconds>	integer	5	[ --wait ] が設定されている場合のステータス ポーリングの間隔 (秒)。

例

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

データシェイプ(--output json)

--waitなし:

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

--wait:

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

--wait失敗すると、取り込み独自のエラー ログ行 ( ingestions logsを介して) が失敗メッセージに折りたたまれた状態で、ゼロ以外で終了します。

UIP PM の取り込みのキャンセル

まだ実行中の取り込みをキャンセルします。

引数

名前	Required	目的
<app-id>	○	プロセス アプリ ID です。
<ingestion-id>	○	取り込み ID (uip pm apps get <app-id> に LastIngestionが表示されます。

オプション

長押し	値 (Value)	既定 (Default)	説明
--stage <stage>	dev | published	dev	取り込みが実行されるアプリ ステージ。

例

uip pm ingestions cancel 9c46289e 1d7e1421

データシェイプ(--output json)

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

UIP PM の取り込みログ

取り込みの実行のログを取得します。

引数

名前	Required	目的
<app-id>	○	プロセス アプリ ID です。
<ingestion-id>	○	取り込み ID

オプション

長押し	値 (Value)	既定 (Default)	説明
--stage <stage>	dev | published	dev	取り込みが実行されたアプリのステージです。
--limit <number>	integer	100	取得するログ エントリの最大数 (ページ サイズ)。
--offset <number>	integer	0	ページの前にスキップするログ エントリの数です。

例

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

データシェイプ(--output json)

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

UIP PM 変換のリスト

プロセス アプリの変換 (dbt モデル) ファイルの一覧を表示します。

名前/オプション	Required	目的
<app-id>	○	プロセス アプリ ID です。
--stage <stage>	×	dev | published、既定値は devです。

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

UIP PM 変換 Get

変換ファイルの内容と ETag を取得します。ETag update は --etagとして必要です。

名前/オプション	Required	目的
<app-id>	○	プロセス アプリ ID です。
<path>	○	変換ファイルのパス (例:models/Cases.sqlです。
--stage <stage>	×	dev | published、既定値は devです。
--destination <local-file>	×	出力エンベロープではなくこのローカル ファイルにコンテンツを書き込みます。

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

UIP PM 変換により作成される

ローカル ファイルから新しい変換ファイルを作成します。update を使用して既存の変数を変更します。パスが既に存在する場合、これは失敗します。

オプション

長押し	値 (Value)	Required	説明
--file <local-file>	パス	○	新しいコンテンツを含むローカル ファイル。
--stage <stage>	dev | published	×	既定 devです。

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

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

UIP PM 変換の更新

ローカル ファイルから変換ファイルを更新します (ETag セーフ)。

オプション

長押し	値 (Value)	Required	説明
--file <local-file>	パス	○	新しいコンテンツを含むローカル ファイル。
--etag <etag>	string	○	この編集の基になっているファイルの transformations getの ETag です。
--stage <stage>	dev | published	×	既定 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\"" } }

古い --etag は競合で失敗します。 transformations getで再読み込み、編集をやり直し、リトライしてください。

UIP PM 変換の実行

開発段階で dbt 変換を実行します — 変更されたモデル/依存モデルのみを構築します。apply は、すでに取り込まれているデータに対して完全な再実行を強制する場合に使用します。

オプション

長押し	値 (Value)	既定 (Default)	説明
--stage <stage>	dev	dev	devのみがサポートされています。
--model <model-path>	パス	—	このモデルのみを実行します (例:models/Cases.sql) とその依存関係。すべてを実行することを省略します。
--wait	フラグ	無効	ビルドが最終ステートに達するまでブロックします。失敗時に 0 以外で終了します (dbt エラーを自動出力します)。
--timeout <seconds>	integer	1800	待機する最大秒数です。
--poll-interval <seconds>	integer	5	投票間隔の秒

例

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

データシェイプ(--output 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'." } }

UIP PM 変換のキャンセル

現在 dev で実行されている dbt ビルドをキャンセルします。

uip pm transformations cancel 9c46289e

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

UIP PM 変換の適用

すでに取り込まれたデータに対して完全なデータ変換を再実行します (変更された開発モデルのみを構築する runとは異なります)。

長押し	値 (Value)	既定 (Default)	説明
--stage <stage>	dev | published	dev	アプリのステージ。
--wait	フラグ	無効	変換が終了状態に達するまでブロックします。失敗時にゼロ以外で終了します。
--timeout <seconds>	integer	1800	待機する最大秒数です。
--poll-interval <seconds>	integer	5	投票間隔の秒

uip pm transformations apply 9c46289e

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

UIP PM 変換のステータス

現在/最後の変換ビルドのステータスを取得します。

uip pm transformations status 9c46289e

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

UIP PM 変換ログ

現在/最後の変換ビルドのログを取得します。

uip pm transformations logs 9c46289e

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

関連

• uip pm — 概要、apps、files
• apps model — 再取り込みまたは再変換を反映させる必要がある、モデル/フィールド/データ マッピングの変更です。
• conformance、deviations、query — 結果を分析します。

参照

• グローバル オプション
• 終了コード