For AI agents: the complete documentation index is available at https://docs.dataplatform.ovh.net/ja/llms.txt, the full documentation bundle is available at https://docs.dataplatform.ovh.net/ja/llms-full.txt, and this page is available as Markdown at https://docs.dataplatform.ovh.net/ja/connectors-analyzer-blueprint-rules.md.
  • 🇯🇵 日本語
  • データを自動的にクリーンアップするためのブループリントルール

    デフォルトのブループリントルールは、日付の書式設定などの簡単なクリーンアップロジックを適用し、データの準備を支援します

    目的

    プラットフォームには、簡単なクリーンアップロジック(日付の書式設定、千の区切りなど)からなる「ブループリントルール」のデフォルト設定があり、ユーザーが簡単なデータ準備を実行するのを支援します。プラットフォームストアから利用可能な変換を選択し、適用条件が満たされた場合に適用できます。

    プラットフォームを使用する際にブループリントルールを使用することは必須ではありません。使用した場合、ルールは自動的にData Processing Engine Load actionsに追加され、データをデータセット内に取り込むために定義します。

    ルールの動作方法

    ルールは各行に独立して適用され、いくつかのことが可能です。

    条件が指定されている場合、ルールはconditioncondition_value(s)で表現された特定の条件下でのみ適用されます。

    変換が指定されている場合、各行に対して変換アクションが実行されます。そうでない場合、フィルタリングルール(keep)とみなされます。

    条件が指定されていない場合、デフォルトで設定される条件はALLであり、任意の行が許可されます。

    変換条件も指定されていない場合、デフォルト変換とみなされます。または、変換が指定されていない場合と条件が1つある場合、デフォルトアクションは保持です。アクションは条件で定義されたルールに応答する行のみに適用されます。

    フィールド

    属性名必須コメント
    attribute_nameリスト形式の場合は必須、オブジェクト形式の場合は不要ca_ttc, date
    condition不要(デフォルトはALLEQUAL, IN下記の条件リストを参照してください
    condition_value条件がIN, NOT INまたはALLの場合を除き、必須1, "Categorie1"
    condition_values条件がINまたはNOT INの場合、必須["ca_ttc", 2, 3], ["categorie"]
    action不要keep, concat下記の変換リストを参照してください
    action_valueアクションがdefaultまたはsplitの場合、必須1, "Categorie1"
    action_valuesアクションがdefault, split, action_error, keepまたはskipの場合を除き、必須["ca_ttc", 2, 3], ["categorie"]
    else_value条件が満たされない場合、値をelse_valueに置き換えます"ca2"

    ブループリントルールの設定

    ルールを設定するには、3つのステップが必要です:

    1. 情報: 属性の名前
    2. 変換: 条件が確認された場合、データに適用する変換アクション(プラットフォームストアから選択可能)
    3. 条件: 条件に適用するルール

    属性にルールを追加するには、関連フィールドで次のボタンをクリックします:

    analyzer

    変換

    プラットフォームストアで利用可能な変換は以下の通りです:

    analyzer
    • 置換:値を単一の値に置き換えます

    • 部分文字列:値が切り詰められます

    • 日付形式:日付形式を置き換えます

    • 行を保持:一致する値を保持します

    • 行をスキップ:一致する値をスキップします

    • エラーをスロー:一致する値はエラーを引き起こします

    • 部分文字列を置換:一致する部分文字列を置き換えます

    • 正規表現を適用:一致する値に新しい正規表現が適用されます

    • ワークフローを停止:進行中のワークフローを停止します

    条件

    利用可能な条件は以下の通りです:

    analyzer

    プラットフォームでは、選択した変換に適用できる多様な条件を提供します。リストには以下が含まれます:等しい等しくない間でないより小さい以下より大きい以上REGEXPNOT REGEXP数値である数値ではない日付である日付ではないnullであるnullではない

    Info

    変換と条件が設定されると、ルールは選択した属性に適用されます。 🙌🏻

    analyzer

    リファレンス

    以下の名前は、ルール自体に記載されている値です。したがって、ルールをJSONとして編集する場合、例えばLoad advanced modeまたはAggregate advanced modeで使用するのはこれらの値です。

    Condition list
    条件の名前説明
    ALLすべての行を保持します
    EQUAL有効な行: attribute_namecondition_valueと等しい行
    NOT EQUAL有効な行: attribute_namecondition_valueと等しくない行
    IN有効な行: attribute_nameがリストcondition_valuesに含まれる行
    NOT IN有効な行: attribute_nameがリストcondition_valuesに含まれない行
    LTE有効な行: attribute_namecondition_value以下の行
    LT有効な行: attribute_namecondition_valueより小さい行
    GTE有効な行: attribute_namecondition_value以上の行
    GT有効な行: attribute_namecondition_valueより大きい行
    REGEXP有効な行: attribute_nameが正規表現condition_valueに対応する行。例: ^([0-9]{4})
    NOT REGEXP有効な行: attribute_nameが正規表現condition_valueに対応しない行
    BETWEEN有効な行: attribute_namecondition_values[0]condition_values[1]の間の行
    NOT BETWEEN有効な行: attribute_namecondition_values[0]condition_values[1]の間にない行
    OR有効な行: condition_valuesに含まれる値のいずれかが空でない行(空、null、False、0)
    AND有効な行: condition_valuesに含まれるすべての値が空でない行(空、null、False、0)
    IS NULL有効な行: attribute_nameがnullの行
    IS NOT NULL有効な行: attribute_nameがnullでない行
    IS INT有効な行: attribute_nameが整数の行
    IS NOT INT有効な行: attribute_nameが整数でない行
    IS DATE有効な行: attribute_nameが日付の行
    IS NOT DATE有効な行: attribute_nameが日付でない行
    IS DEC有効な行: attribute_nameが小数の行
    IS NOT DEC有効な行: attribute_nameが小数でない行
    IS NUM有効な行: attribute_nameが数値の行
    IS NOT NUM有効な行: attribute_nameが数値でない行
    Transformation list
    • keep: 行を保持します

    • skip: 行をスキップします

    • default: 値をaction_valueに置き換えます。 日付の場合、以下があります:

      • $today は yyyy-mm-dd を返します
      • $now は yyyy-mm-dd hh:mm:ss を返します
      • $yesterday は yyyy-mm-dd を返します
    • regexp_replace: 正規表現action_values[0]に対応する値をaction_values[1]に置き換えます

    • replace: action_values[0]に対応する値をaction_values[1]に置き換えます

    • substring / substr:

      • action_values[0] >= 0 の場合: action_values[0]番目の文字から開始します

      • action_values[0] < 0 の場合: action_values[0]の最後の文字のみを考慮します

      • action_values[1]が記入されている場合: 2番目の数字は、希望する最大文字数を表します

    • date_replace: 日付形式action_values[0]action_values[1]に置き換えます。 action_valuesの例:

      • ["%d/%m/%Y", "%Y-%m-%d"]
      • 下記の日付形式ディレクティブを参照してください
    • add: 複数のフィールドまたはハード数値を追加し、action_valuesの各値が行に利用可能な属性であるかどうかを自動的に検出します。そうでない場合は数値とみなします。 action_valuesの例:

      • ["ca_ht", "taxes"]
      • ["nb_clics", 1]
    • sub: action_valuesに存在する他のすべてのデータからaction_values[0]を引きます

    • mul: action_values[0]action_values[1]で掛けます

    • div: action_values[0]action_values[1]で割ります

    • mod: action_values[0]action_values[1]で割った余りを求めます

    • concat: ハード文字列と複数のフィールドを連結します。 action_valuesの各要素は、行に利用可能な列の名前であるかどうかを検出します。そうでない場合はハード文字列とみなします。 action_valuesの例:

      • ["site_name", " - ", "country"]
      • ["civilite", " name", "lastname"]
    • ceil: action_valueを切り上げます

    • floor: action_valueを切り捨てます

    • disaggregate / split: フィールドに複数の値が含まれている場合、それらを別々の行に分割するために使用されます。 DPEアクションごとに1つのdisaggregateルールのみ存在でき、このルールは常に最後に適用されます。 フィールドはaction_valueの文字で分割され、分割された各要素から空でない値のみが保持されます。

    • action_error: アクションにエラーを引き起こし、その結果としてすべての行が偽であるとみなします

    • stop_workflow: ワークフローを停止します

    Date format directives
    ディレクティブ意味
    %w週の曜日を10進数として、0が日曜日、6が土曜日です。0, 1, ..., 6
    %d月の日をゼロ埋めの10進数として。01, 02, ..., 31
    %m月をゼロ埋めの10進数として。01, 02, ..., 12
    %y世紀なしの年をゼロ埋めの10進数として。00, 01, ..., 99
    %Y世紀を含む年を10進数として。1970, 1988, 2001, 2013
    %H時(24時間制)をゼロ埋めの10進数として。00, 01, ..., 23
    %I時(12時間制)をゼロ埋めの10進数として。01, 02, ..., 12
    %pロケールのAMまたはPMに相当するもの。AM, PM (en_US); am, pm (de_DE)
    %M分をゼロ埋めの10進数として。00, 01, ..., 59
    %S秒をゼロ埋めの10進数として。00, 01, ..., 59
    %fマイクロ秒を10進数として、左をゼロ埋めします。000000, 000001, ..., 999999
    %zUTCオフセットを+HHMMまたは-HHMMの形式で(オブジェクトがナイーブな場合は空の文字列)。(empty), +0000, -0400, +1030
    %Zタイムゾーン名(オブジェクトがナイーブな場合は空の文字列)。(empty), UTC, EST, CST
    %j年の日をゼロ埋めの10進数として。001, 002, ..., 366
    %U年の週番号(日曜日を週の最初の日として)をゼロ埋めの10進数として。新年の最初の日曜日に先立つすべての日は週0とみなされます。00, 01, ..., 53
    %W年の週番号(月曜日に週の最初の日として)を10進数として。新年の最初の月曜日に先立つすべての日は週0とみなされます。00, 01, ..., 53
    %%リテラルの'%'文字。%
    Rule examples

    日付形式を置き換えます:

    [
        {
            "attribute_name": "date",
            "action": "date_replace",
            "action_values": ["%d/%m/%Y", "%Y-%m-%d"]
        }
    ]

    year属性に1を追加しますが、2015年または2016年の行のみに適用します:

    [
        {
            "attribute_name": "year",
            "condition": "IN",
            "condition_values": ["2015", "2016"],
            "action": "add",
            "action_values": ["year", 1]
        }
    ]

    yearを2015年に設定しますが、2015年より前の行のみに適用します:

    [
        {
            "attribute_name": "year",
            "condition": "LT",
            "condition_value": "2015",
            "action": "default",
            "action_value": "2015"
        }
    ]

    date属性を今日の日付に設定します:

    [
        {
            "action": "default",
            "action_value": "$today",
            "attribute_name": "date"
        }
    ]

    ケルビンから摂氏に温度を変換します:

    [
        {
            "action": "sub",
            "action_values": [
                "temp_min",
                273.15
            ],
            "attribute_name": "temp_min"
        }
    ]

    タイムスタンプを正規化します:

    [
        {
            "action": "date_replace",
            "action_values": [
                "%a %b %d %H:%M:%S +0000 %Y",
                "%Y-%m-%d %H:%M:%S"
            ],
            "attribute_name": "statuses_created_at"
        }
    ]

    さらに進む

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

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

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

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