Contents x
    [ベータ版]データマート定義更新
      • Print
      • PDF
      Contents

      [ベータ版]データマート定義更新

        • Print
        • PDF
        Article summary

        Patch
        /api/datamart_definitions/{datamart_definition_id}

        [注意]ベータ版のAPIエンドポイントであるため、リクエスト・レスポンスデータが変更される可能性があります。
        データマート定義更新します。
        データウェアハウス(DWH)タイプ自体の変更はできません。
        また、現在更新可能なデータウェアハウスタイプはBigQueryのみです。

        Security
        API Key
        Header parameter nameAuthorization

        認証キーとなるAPI KEYをAuthorization: Token {{API KEY}}の形式でヘッダーにセットします。
        API KEYがabc123の場合は、Authorization: Token abc123とします。
        API KEYの作成方法は、trocco APIについてを参照ください。

        Path parameters
        datamart_definition_id
        integer (int64) Required

        データマート定義IDを指定します。

        Body parameters
        Expand All
        object
        name
        string

        データマート定義名を指定します。

        Exampletest
        description
        string | null

        メモを指定します。

        Exampledesc
        is_runnable_concurrently
        boolean

        ジョブの並列実行可否を指定します。

        ExampleTrue
        resource_group_id
        integer (int64) | null

        リソースグループのIDを指定します。

        custom_variable_settings
        Array of object

        カスタム変数の設定を指定します。
        nullまたは空の配列が指定された場合にはすべてのカスタム変数が削除されます。

        object
        name
        string Required

        カスタム変数の変数名を指定します。
        変数名を$で囲ってください。

        Example$start_time$
        type
        string Required

        カスタム変数タイプです。
        string: 文字列
        timestamp: 時刻・日付（キューイング時）
        timestamp_runtime: 時刻・日付（実行時）

        Valid values[ "string", "timestamp", "timestamp_runtime" ]
        Exampletimestamp_runtime
        value
        string

        カスタム変数名を展開する値を指定します。
        カスタム変数タイプがstringのときのみ有効です。

        Examplejobs
        quantity
        integer (int64)

        unit 時間の数を指定します。
        カスタム変数タイプがtimestampかtimestamp_runtime のときのみ有効です。

        Example1
        unit
        string

        時間の単位を指定します。
        タイプがtimestampかtimestamp_runtime のときのみ有効です。

        Valid values[ "hour", "date", "month" ]
        Examplehour
        direction
        string

        時間軸の方向です。
        ago: 前
        later: 後
        タイプがtimestampかtimestamp_runtime のときのみ有効です。

        Valid values[ "ago", "later" ]
        Exampleago
        format
        string

        日付フォーマットです。
        タイプがtimestampかtimestamp_runtime のときのみ有効です。

        Example%Y-%m-%d %H:%M:%S
        time_zone
        string

        日付フォーマットの日時を解釈するタイムゾーンです。
        タイプがtimestampかtimestamp_runtime のときのみ有効です。

        ExampleEtc/UTC
        datamart_bigquery_option
        object

        BigQueryの設定を指定します。
        データウェアハウスタイプがBigQuery以外の時は指定できません。

        bigquery_connection_id
        integer (int64)

        BigQueryの接続IDを指定します。

        Example1
        query_mode
        string

        クエリ実行モードを指定します。
        insert: データ転送モード
        query: 自由記述モード

        Valid values[ "insert", "query" ]
        query
        string

        実行クエリを指定します。

        Exampleselect * from tests
        destination_dataset
        string

        出力先データセットを指定します。
        query_modeがinsertの場合のみ有効です。

        Exampletest_dataset
        destination_table
        string

        出力先テーブルを指定します。
        query_modeがinsertの場合のみ有効です。

        Exampletest_table
        write_disposition
        string

        書き込みモードを指定します。
        query_modeがinsertの場合のみ有効です。
        append: 追記
        truncate: 全件洗い替え

        Valid values[ "append", "truncate" ]
        Exampletruncate
        before_load
        string | null

        転送前に実行するクエリを指定します。
        query_modeがinsertの場合のみ有効です。

        ExampleDELETE FROM tests
        partitioning
        string | null

        パーティションタイプを指定します。
        query_modeがinsertの場合のみ有効です。
        詳細はパーティショニング・クラスタリングの設定を参照ください。
        ingestion_time: 取り込み時間により分割
        time_unit_column: フィールドにより分割

        Valid values[ "ingestion_time", "time_unit_column" ]
        Exampletime_unit_column
        partitioning_time
        string | null

        分割する期間の単位を指定します。
        query_modeがinsertの場合のみ有効です。
        詳細はパーティショニング・クラスタリングの設定を参照ください。

        Valid values[ "DAY", "HOUR", "MONTH", "YEAR" ]
        ExampleDAY
        partitioning_field
        string | null

        分割するフィールド名を指定します。
        query_modeがinsertの場合のみ有効です。
        詳細はパーティショニング・クラスタリングの設定を参照ください。

        Exampletest_field
        clustering_fields
        Array of string

        クラスタ化列を指定します。
        詳細はパーティショニング・クラスタリングの設定を参照ください。

        ExampleUS
        string
        location
        string

        データ処理ローケーションを指定します。
        query_modeがqueryの場合のみ有効。

        schedules
        Array of object

        スケジュール設定を指定します。
        既存のスケジュール設定はすべて指定された値で洗い替えされます。
        空の配列を指定するとすべて削除されます。

        object
        frequency
        string Required

        データマートジョブ実行スケジュールの頻度です。
        hourly: 毎時
        daily: 毎日
        weekly: 毎週
        monthly: 毎月

        Valid values[ "hourly", "daily", "weekly", "monthly" ]
        minute
        integer (int64)

        分の値を示します。

        hour
        integer (int64)

        時間の値を示します。

        day
        integer (int64)

        日にちの値を示します。

        day_of_week
        integer (int64)

        曜日の値を示します。

        time_zone
        string Required

        日時のタイムゾーンです。

        ExampleEtc/UTC
        labels
        Array of string

        ラベル設定を指定します。
        既存のラベルはすべて指定された値で洗い替えされます。
        空の配列を指定するとすべて削除されます。

        string

        ラベル名を指定します。

        notifications
        Array of object

        通知設定を指定します。
        既存の通知設定はすべて指定された値で洗い替えされます。
        空の配列を指定するとすべて削除されます。

        object
        destination_type
        string Required

        通知先です。

        Valid values[ "slack", "email" ]
        slack_channel_id
        integer (int64)

        slack channel IDです。
        destination_typeがslackのとき必須です。

        email_id
        integer (int64)

        Email IDです。
        destination_typeがemailのとき必須です。

        notification_type
        string Required

        通知タイプです。
        job: ジョブ実行(終了/エラー)通知
        recor: レコード条件(超過/過不足)通知

        Valid values[ "job", "record" ]
        notify_when
        string

        通知条件です。
        jobタイプのとき必須です。

        message
        string

        通知内容です。

        record_count
        integer (int64)

        閾値のレコード数
        recordタイプのとき必須です。

        record_operator
        string

        レコード数の比較演算子です
        recordタイプのとき必須
        above: 以上
        below: 以下

        Valid values[ "above", "below" ]
        Responses
        204

        No Content.

        400

        Bad request.
        不正なリクエストです。

        401

        Not authenticated.
        認証エラーです。API KEYをご確認ください。

        Was this article helpful?
        What's Next