専門家モードでワークフローを設定する

ワークフローはJSON設定を直接使用して設定することもできます。新しいワークフローのJSON設定にアクセスするには

目的

ワークフローはJSON設定を直接使用して設定することもできます。新しいワークフローまたはワークフローの編集ウィンドウの専門家タブをクリックすると、JSON設定にアクセスできます。

JSON設定を確認する

ユーザーはJSONエディタに直接入力してワークフローを設定できます。JSON設定にはGUIで利用可能なものより多くのオプションが含まれています。

ワークフローのパラメータリファレンス

アルファベット順に、パラメータは以下の通りです。

パラメータ	タイプ	説明
display_name	文字列	ワークフローの名前を設定できます
description	文字列	ワークフローの説明を設定できます
workflow	テーブル	ステージとその関連アクションのリスト
logLevel	文字列	ログレベル値はこのワークフローの最小ログレベルを定義します。これはdebug、info、notice、warning、errorまたはcriticalのいずれかの値を取ることができます
auto_flushall	ブール値	ワークフローの最後にフラッシュオールルーチンを追加するかどうかの条件です。これはデータフロー（QB、API、APP）のすべてのキャッシュを更新するメンテナンスルーチンです
dateMin	文字列	日付範囲の絶対的な下限
dateMax	文字列	日付範囲の絶対的な上限
days	JSONオブジェクト	範囲値の相対的な日付の最小値と最大値

JSON設定の例

以下は、典型的なワークフローのJSON設定です。「ステージ1」には2つのアクション、「ステージ2」には2つのアクションがあります。

{
  "params": {
     "log_level": "info"
  },
  "auto_flushall": true,
  "display_name": "flushall",
  "description": "routine maintenance workflow",
  "stages": [
    {
      "stageName": "Stage 1",
      "actions": [
        {"action_conf": "5c9bba68555fb219eb000020"},
        {"action_conf": "5c9bba68555fb2190000ll99"}

      ]
    },
    {
      "stageName": "Stage 2",
      "actions": [
        {"action_conf": "5c9bba68555hghjgjhgjhgjh"}
      ]
    }
  ]
}

日付範囲のパラメータ

日付範囲を定義するには、絶対的な日付制限（例：設定された時間）または相対的な日付制限（例：現在の日付から計算されたもの）を使用します。

絶対的な日付範囲を定義するには、dateMin & dateMaxパラメータを使用し、YYYY-MM-DD形式の文字列として日付を入力します。例えば、これは過去の特定の日付の間でワークフローを再計算することを可能にします。

{
  ...
  "dateMin": "2019-04-25",
  "dateMax": "2019-04-25"
}

相対的な日付範囲を定義するには、daysパラメータを使用し、下限と上限の現在の日付からの日数を入力します。例えば、これは「一昨日」と「今日」のデータのみに影響を与える必要がある日次ワークフローで使用されます。数字は、今日の日付から引く日数に対応します。

{
  ...
  "days": {
    "min": "2",
    "max": "0"
  }
}

ステージのパラメータ

ステージのパラメータは、ユーザーインターフェースから直接変更できます。

パラメータ	タイプ	説明
stageName	文字列	各ステージに名前を付けることができます
disable (ステージ)	ブール値	ワークフロー内の特定のステージを有効/無効にすることができます
action_conf	文字列	個々のアクションの情報にアクセスするときに見つけることができるアクションのユニークIDに対応します。
disable (アクション)	ブール値	ステージ内の特定のアクションを有効/無効にすることができます

{
  "display_name": "flushall",
  …
  "workflow": [
    {
      "disable": false,
      "stageName": "update_metas_lite",
      "actions": [
        {
          "action_conf": "update_metas_lite",
          "disable": false
        }
      ]
    …
  ]
}

設定のオーバーライド

アクションの設定

アクションの設定をオーバーライドすることで、同じアクションを異なる実行パラメータで複数のワークフローで再利用できます。例えば、アクションの範囲を特定の値のセットで設定したと仮定しましょう："perimeterValues":["1","2"]

同じワークフロー内で異なる範囲値を使用して同じアクションを再利用できます：

{
  "logLevel": "info",
  "auto_flushall": true,
  "display_name": "flushall",
  "workflow": [
    {
      "stageName": "Stage 1",
      "actions": [
        {"action_conf": "5c9bba68555fb219eb000020", "perimeterValues": ["1","2"]},
        {"action_conf": "5c9bba68555fb219eb000020", "perimeterValues": ["8"]}
      ]
    }
  ]
}

Info

この特定の例は意味がないですが、単一のワークフロー内で同じアクションに対して異なる設定を簡単に定義できる方法を示しています。

設定の優先順位

設定はワークフロー、ステージ、またはアクションの3つのレベルでオーバーライドできます。最も細かいレベルの設定はすべてのサブオブジェクトに適用されます。例えば、ステージレベルで設定された設定はアクションレベルで設定された設定によってオーバーライドされます。以下の例を使用して優先順位の順序を説明します。

{
  "logLevel": "info",
  "perimeterValues": ["0"],
  "auto_flushall": true,
  "display_name": "flushall",
  "workflow": [
    {
      "stageName": "Stage 1",
      "perimeterValues": ["1"],
      "actions": [
        {"action_conf": "abc", "perimeterValues": ["2"]},
        {"action_conf": "efg"}

      ]
    },
    {
      "stageName": "Stage 2",
      "actions": [
        {"action_conf": "hij"}
      ]
    }
  ]
}

上記のJSON設定に従うと、ワークフロー内で実行される異なるアクションの範囲値は以下の通りです。

アクションID	perimeterValue	説明
abc	2	アクションabcにはアクションレベルで設定されたperimeterValuesがあり、他のperimeterValuesをすべてオーバーライドします。
efg	1	アクションefgにはアクションレベルで設定されたperimeterValuesがなく、これはそのステージ内で設定されたperimeterValuesを使用することを意味します。この場合はステージ1です。
hij	0	アクションhijとステージ2の両方にperimeterValuesが設定されていないため、適用されるperimeterValuesはワークフローのものです。

ワークフローのタイムアウト

ワークフロー内のアクションが予想よりも時間がかかる場合、ワークフローが中断されるようにタイムアウトオプションを設定できます。workflow_timeoutパラメータの値として"worfklow_timeout":"1h 10m"のような人間が読める形式でタイムアウト期間を設定できます。

値は1つの時間単位から別の時間単位に累積されます。サポートされている時間単位には以下が含まれます。

時間単位	説明
w	週
d	日
h	時間
m	分
s	秒

ワークフロータイムアウトオプションを使用したJSON設定の例：

{
  "logLevel": "info",
  "auto_flushall": true,
  "worfklow_timeout":"59m 50s",
  "display_name": "flushall",
  "workflow": [
    {
      "stageName": "Stage 1",
      "actions": [
        {"action_conf": "5c9bba68555fb219eb000020"},
        {"action_conf": "5c9bba68555fb2190000ll99"}

      ]
    }
  ]
}

さらに詳しく

当社のソリューションのトレーニングや技術的なサポートが必要な場合は、営業担当者にお問い合わせください、またはプロフェッショナルサービスページを訪れて見積もりを依頼し、専門家チームにプロジェクトを分析してもらってください。

Data Platformを構築しているチームと直接質問し、フィードバックを共有し、交流するには、専用のDiscordチャネルにアクセスしてください。

OVHcloudサービスについてサポートが必要な場合は、ヘルプセンターでリクエストを作成してください。

ユーザーコミュニティに参加してください。

専門家モードでワークフローを設定する#

#目的

#JSON設定を確認する

#ワークフローのパラメータリファレンス

#JSON設定の例

#日付範囲のパラメータ

#ステージのパラメータ

#設定のオーバーライド

#アクションの設定

#設定の優先順位

#ワークフローのタイムアウト

#さらに詳しく