# バッチ処理

1カ月指定した期間開始日時をトリガー実行したタスク名実行テキスト通知通知を選択したこのメニューでは、管理画面で必要となる定時実行の処理を設定できます。

管理画面のように合わせて、実行間隔と処理内容を細かく設定することができます。

## メニュー

### タスク利用状態

登録されているタスクの件数を示しています。利用プランによって、登録できる件数が異なります。

### トリガー利用状態

登録されているトリガー（定時実行のパターン）の件数を示しています。利用プランによって、登録できる件数が異なります。

### 集計管理

集計タスクの設定と、タスクの実行履歴を確認できます。

詳細は[集計管理](#ji-ji-guan-li-1) の項目を参照してください。

### トリガー

トリガーの設定を確認できます。

詳細は[トリガー](#torig-2) の項目を参照してください。

## 集計管理

集計管理メニューでは、データを定期的に集計するためのタスクを設定できます。毎月のサービス利用状況や売上額などを、データベースに自動で追加することができます。

### 集計タスク

集計タスクメニューは、登録されている集計タスクの一覧を表示します。集計タスクの新規追加も、ここから行います。

#### 集計タスクの絞り込み設定

1. キーワードでの絞り込み

集計タスクのフィルター入力欄にキーワードを入力すると、タスク名で絞り込み表示できます。

（例）`user` と入力すると、`aggregate_user_payments` や `aggregate_active_users` などの該当するタスクが絞り込み表示されます。

2. 実行回数と実行時間の間隔での絞り込み

集計タスクに設定されているトリガーの実行条件で絞り込みできます。

全部、1回のみ、固定間隔、毎時、毎日、毎週、毎月、毎年　から選択できます。

選択した条件に一致する集計タスクが絞り込み表示されます。

3. 集計タスクの有効状態で絞り込み

集計タスクの自動実行の有効状態で絞り込みできます。

全部、有効、無効から選択できます。

選択した条件に一致する集計タスクが絞り込み表示されます。

#### 集計タスクの一覧

集計タスクの一覧には、以下の項目が表示されます。

<table><thead><tr><th width="159">項目名</th><th>内容</th><th data-hidden></th></tr></thead><tbody><tr><td>Active</td><td>集計タスクの定時実行が有効になっているかどうかを示します。トグルスイッチをONにすると、設定したトリガーにあわせて集計タスクが実行されます。集計タスクの定時実行を有効にするには、トリガーを設定する必要があります。</td><td></td></tr><tr><td>環境</td><td>集計タスクが処理の対象とする環境を表します。StagingまたはProductionが表示されます。</td><td></td></tr><tr><td>トリガー</td><td>集計タスクの定時実行に利用するトリガーが表示されます。</td><td></td></tr><tr><td>インプット</td><td>集計タスクがデータの取得を行うデータソースを示します。</td><td></td></tr><tr><td>アウトプット</td><td>集計タスクがデータの書き込みを行うデータソースを示します。</td><td></td></tr></tbody></table>

### 集計タスクの追加

集計タスク管理の画面の上部にある「新規追加」ボタンをクリックすると、集計タスクの新規作成画面が表示されます。

### 集計タスクの操作

操作したい集計タスクの一覧にマウスカーソルを載せると、操作アイコンが表示されます。このアイコンをクリックして、各種操作を行うことができます。

#### 集計タスクの編集

<img src="https://3498714457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIESKBveovlGvQ1BqYEP%2Fuploads%2Fgit-blob-db283126902b679fdfc2c29357628bc6766c6910%2F%E7%B7%A8%E9%9B%86%E3%82%A2%E3%82%A4%E3%82%B3%E3%83%B3.png?alt=media" alt="" data-size="line">をクリックすると、集計タスクの設定画面が開きます。

#### 集計タスクの複製

<img src="https://3498714457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIESKBveovlGvQ1BqYEP%2Fuploads%2Fgit-blob-7e7956b0db1e6bdee817da7c013564a0a280bcf9%2F%E8%A4%87%E8%A3%BD%E3%82%A2%E3%82%A4%E3%82%B3%E3%83%B3.png?alt=media" alt="" data-size="line">をクリックすると、メニュータイトルを複製できます。

#### 集計タスクの削除

<img src="https://3498714457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIESKBveovlGvQ1BqYEP%2Fuploads%2Fgit-blob-05e52fb06159e55851377572c2e9608b570ee11b%2F%E5%89%8A%E9%99%A4%E3%82%A2%E3%82%A4%E3%82%B3%E3%83%B3.png?alt=media" alt="" data-size="line">をクリックすると、集計タスクが削除されます。

## 集計タスクの設定

集計タスク管理画面の「新規追加」ボタンをクリックするか、集計タスク一覧の<img src="https://3498714457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIESKBveovlGvQ1BqYEP%2Fuploads%2Fgit-blob-db283126902b679fdfc2c29357628bc6766c6910%2F%E7%B7%A8%E9%9B%86%E3%82%A2%E3%82%A4%E3%82%B3%E3%83%B3.png?alt=media" alt="" data-size="line">をクリックすると、集計タスクの編集画面が開きます。

集計タスクの設定画面には、以下の設定項目があります。

### 環境選択

集計タスクが処理の対象とする環境を選択します。StagingまたはProductionから選択します。

### タスク名

集計タスクの名称を入力します。

### トリガー

集計タスクの定時実行に利用するトリガーが表示されます。トリガー管理で作成したトリガーから選択します。

### 削除

「削除」ボタンをクリックすると、確認モーダルが表示されます。

集計タスク名を入力して、モーダル内の「削除」ボタンをクリックすると、削除が実行されます。

### 保存

「保存」ボタンをクリックすると、集計タスクの設定の変更が保存されます。

{% hint style="info" %}
集計タスクの変更内容を保存すると、自動的に集計タスクが無効状態になります。編集後の内容で自動実行を行うには、集計タスク一覧からActiveのトグルスイッチをONにする必要があります。
{% endhint %}

### インプット処理

集計データを作成するための素になるデータの取得方法を設定します。

設定項目は以下です。

<table><thead><tr><th width="180">項目名</th><th>設定内容</th><th data-hidden></th></tr></thead><tbody><tr><td>データソース種別</td><td>データを取得するデータソースの種別を選択します。DB Query, API, Cloud Storage から選択します。</td><td></td></tr><tr><td>データソース</td><td>選択したデータソース種別から、データソースを選択します。ここで選択したデータソースに対して、クエリが送信・実行されます。</td><td></td></tr><tr><td>クエリ入力欄</td><td>データを取得するSQLクエリを入力します。</td><td></td></tr></tbody></table>

#### 結果の取得

インプット処理設定の「実行」ボタンをクリックすると、設定したクエリが送信・実行され、画面下部に取得結果が表示されます。

表示された取得結果のカラムが、次のアウトプット設定で利用できます。

### アウトプット処理

集計データとして保存する処理を設定します。

設定項目は以下です。

<table><thead><tr><th width="241">項目名</th><th>設定内容</th><th data-hidden></th></tr></thead><tbody><tr><td>Destination Data Source</td><td>集計データを送信するデータソースを選択します。</td><td></td></tr><tr><td>Destination Table</td><td>選択したデータソースから、集計データを保存するテーブルを選択します。</td><td></td></tr><tr><td>Data field mapping</td><td>インプット処理で取得したデータのカラムと、選択したテーブルのカラムをマッピングします。</td><td></td></tr></tbody></table>

#### 実行

アウトプット処理設定の「実行」ボタンをクリックすると、インプット処理で取得した内容を使って集計データが作成され、その内容が保存されます。

実行が成功すると、画面下部に「Success」のメッセージが表示されます。

### 通知

集計タスクの実行時の通知を設定します。

成功時の通知と失敗時の通知を、それぞれ設定できます。

トグルスイッチをONにすると、通知が有効になり、設定項目が表示されます。

設定項目は以下です。

<table><thead><tr><th width="241">項目名</th><th>設定内容</th><th data-hidden></th></tr></thead><tbody><tr><td>通知先</td><td>通知を送信するユーザーを選択します。</td><td></td></tr><tr><td>タイトル</td><td>通知のタイトルを入力します。</td><td></td></tr><tr><td>テキスト</td><td>通知のメッセージを入力します。</td><td></td></tr></tbody></table>

## 集計タスクの実行履歴

実行履歴メニューでは、集計タスクの実行履歴を一覧で確認できます。

### 実行履歴の絞り込み

実行履歴画面の上部にある検索条件から、実行履歴を絞り込み表示できます。

#### 期間

集英タスクが実行された期間を指定できます。

#### キーワード

集計タスクの名称で絞り込みできます。

#### 実行結果

集計タスクの実行結果で絞り込みできます。全部、成功、失敗から選択します。

#### 条件をクリア

「条件をクリア」ボタンをクリックすると、設定した検索条件を空欄に戻します。

#### 検索の実行

「検索」ボタンをクリックすると、指定した条件で集計タスクの実行履歴を検索します。

### 実行履歴の一覧

実行履歴の一覧には、以下の項目が表示されます。

<table><thead><tr><th width="159">項目名</th><th>内容</th><th data-hidden></th></tr></thead><tbody><tr><td>実行時間</td><td>集計タスクが実行された時間を表示します。</td><td></td></tr><tr><td>結果</td><td>集計タスクの実行結果を表示します。成功、失敗のアイコンが表示されます。</td><td></td></tr><tr><td>タスク名</td><td>実行した集計タスクの名称が表示されます。</td><td></td></tr><tr><td>トリガー</td><td>実行の条件に利用したトリガーの名称が表示されます。</td><td></td></tr><tr><td>インプット</td><td>集計タスクがデータの取得を行ったデータソースを示します。</td><td></td></tr><tr><td>アウトプット</td><td>集計タスクがデータの書き込みを行ったデータソースを示します。</td><td></td></tr></tbody></table>

## トリガー

トリガーのメニューでは、タスクを実行する条件を設定できます。1日ごとの集計や、月間の集計など、実行間隔の異なるタスクの実行間隔を設定します。

### トリガー管理

トリガー管理メニューは、登録されているトリガーの一覧を表示します。トリガーの新規追加も、ここから行います。

#### トリガーの絞り込み設定

1. キーワードでの絞り込み

トリガーの一覧のキーワード入力欄にキーワードを入力すると、タスク名で絞り込み表示できます。

2. 実行回数と実行時間の間隔での絞り込み

トリガーの実行条件で絞り込みできます。

全部、1回のみ、固定間隔、毎時、毎日、毎週、毎月、毎年　から選択できます。

選択した条件に一致するトリガーが絞り込み表示されます。

#### トリガーの一覧

トリガーの一覧には、以下の項目が表示されます。

<table><thead><tr><th width="159">項目名</th><th>内容</th><th data-hidden></th></tr></thead><tbody><tr><td>トリガー名</td><td>トリガーの名称が表示されます。</td><td></td></tr><tr><td>タスク数</td><td>実行条件としてそのトリガーを設定しているタスクの数を表します。</td><td></td></tr></tbody></table>

一覧に表示されたトリガーをクリックすると、そのトリガーを利用しているタスクが表示されます。

### トリガーの操作

操作したいトリガーの一覧にマウスカーソルを載せると、操作アイコンが表示されます。このアイコンをクリックして、各種操作を行うことができます。

#### トリガーの編集

<img src="https://3498714457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIESKBveovlGvQ1BqYEP%2Fuploads%2Fgit-blob-db283126902b679fdfc2c29357628bc6766c6910%2F%E7%B7%A8%E9%9B%86%E3%82%A2%E3%82%A4%E3%82%B3%E3%83%B3.png?alt=media" alt="" data-size="line">をクリックすると、トリガーの設定画面が開きます。

#### トリガーの複製

<img src="https://3498714457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIESKBveovlGvQ1BqYEP%2Fuploads%2Fgit-blob-7e7956b0db1e6bdee817da7c013564a0a280bcf9%2F%E8%A4%87%E8%A3%BD%E3%82%A2%E3%82%A4%E3%82%B3%E3%83%B3.png?alt=media" alt="" data-size="line">をクリックすると、トリガーを複製できます。

#### トリガーの削除

<img src="https://3498714457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIESKBveovlGvQ1BqYEP%2Fuploads%2Fgit-blob-05e52fb06159e55851377572c2e9608b570ee11b%2F%E5%89%8A%E9%99%A4%E3%82%A2%E3%82%A4%E3%82%B3%E3%83%B3.png?alt=media" alt="" data-size="line">をクリックすると、トリガーが削除されます。

## トリガーの設定

トリガー管理画面の「新規追加」ボタンをクリックするか、トリガー一覧の<img src="https://3498714457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIESKBveovlGvQ1BqYEP%2Fuploads%2Fgit-blob-db283126902b679fdfc2c29357628bc6766c6910%2F%E7%B7%A8%E9%9B%86%E3%82%A2%E3%82%A4%E3%82%B3%E3%83%B3.png?alt=media" alt="" data-size="line">をクリックすると、トリガーの設定画面が開きます。

トリガーの設定画面には、以下の設定項目があります。

### トリガー名

トリガーの名称を入力します。

### 実行回数

トリガーを実行する回数を選択します。以下から選択します。

<table><thead><tr><th width="159">項目名</th><th>内容</th><th data-hidden></th></tr></thead><tbody><tr><td>繰り返し</td><td>以下に続く設定で、トリガーの実行条件を指定します。</td><td></td></tr><tr><td>1回のみ</td><td>繰り返し条件を設定せず、1回だけ実行されるように設定します。</td><td></td></tr></tbody></table>

### 開始日時

トリガーの実行条件を満たす開始日時を指定します。

<table><thead><tr><th width="159">項目名</th><th>内容</th><th data-hidden></th></tr></thead><tbody><tr><td>無制限</td><td>開始日時を指定しません。そのほかの条件を満たせば、トリガーが実行されます。</td><td></td></tr><tr><td>指定日時</td><td>指定した日時以降、トリガーを実行します。</td><td></td></tr></tbody></table>

### 有効期間

トリガーが実行される期間を指定します。

<table><thead><tr><th width="159">項目名</th><th>内容</th><th data-hidden></th></tr></thead><tbody><tr><td>無制限</td><td>有効期間を指定しません。そのほかの条件を満たせば、トリガーが実行されます。</td><td></td></tr><tr><td>期間限定</td><td>指定した期間のみ、トリガーを実行します。期間の開始日付と終了日付を設定します。</td><td></td></tr></tbody></table>

### 時間間隔

トリガーが実行される日時の間隔を指定します。「固定間隔」以外の条件を選択した場合、複数の条件を登録できます。

<table><thead><tr><th width="159">項目名</th><th>内容</th><th data-hidden></th></tr></thead><tbody><tr><td>固定間隔</td><td>実行間隔を数値で設定します。単位は、日、時、分から選択できます。</td><td></td></tr><tr><td>毎時</td><td>1時間ごとに実行します。実行する分を指定できます。</td><td></td></tr><tr><td>毎日</td><td>1日ごとに実行します。実行する時分を指定できます。</td><td></td></tr><tr><td>毎週</td><td>1週間ごとに実行します。実行する曜日と、時分を指定できます。</td><td></td></tr><tr><td>毎月</td><td>1カ月ごとに実行します。実行する日付の条件を、指定日、指定週、最終日から　の3つから選択できます。実行する時分も指定できます。</td><td></td></tr><tr><td>毎年</td><td>1年ごとに実行します。実行する日付の条件を、指定日、指定週、最終日から　の3つから選択できます。実行する時分も指定できます。</td><td></td></tr></tbody></table>

### 保存

トリガー編集画面の右上にある「保存」ボタンをクリックすると、トリガーの変更を保存できます。

### 削除

トリガー編集画面の「削除」ボタンをクリックすると、確認モーダルが表示されます。

トリガー名を入力してモーダル内の「削除」ボタンをクリックすると、削除が実行されます。
