# クエリのスケジュール設定

Sigma で定期的に実行されるクエリをスケジュール設定する方法をご紹介します。

Sigma のクエリは、日次、週次、または月次で実行するようにスケジュールすることで自動化できます。スケジュール済みの各クエリの結果は、[メール](https://docs.stripe.com/data/schedule-queries.md#subscribers)で指定されたチームメンバーに送信されるか、[Webhook イベント](https://docs.stripe.com/data/schedule-queries.md#receiving-results-as-webhooks)として送信されます。

## クエリのスケジュールを設定する

エディターにクエリを読み込んだ状態で、**スケジュール**をクリックします。混乱を避けるため、スケジュール済みの各クエリには一意の名前を付けます。クエリにまだ名前がない場合や名前を変更したい場合は、スケジュール設定プロセス中に更新できます。
![](https://b.stripecdn.com/docs-statics-srv/assets/scheduled-query-sample.1725f09555d262a2bfe0be7385118d71.png)

### 日時を設定

スケジュールされた各クエリは、日次、週次、または月次で実行できます。クエリは、その期間のデータが利用可能になるとすぐに実行されます。

| 日時を設定 | 説明 |
| --- | --- |
| 日次 | クエリは、各日 (12:00am UTC まで) のデータが処理されるとすぐに実行されます。通常、前日のクエリ結果は 2pm UTC までに利用可能になります。 |
| 週次 | クエリは毎週、前週 (日曜日の 12:00am UTC に終わる) のデータが処理されるとすぐに実行されます。通常、前週のクエリ結果は翌月曜日の 2pm UTC までに利用可能になります。 |
| 月次 | クエリは毎月、前月 (12:00am UTC まで) のデータが処理されるとすぐに実行されます。通常、前月のクエリ結果は毎月 1 日の 2pm UTC までに利用可能になります。 |

## 登録者

スケジュール済みのクエリの作成者は、デフォルトで、メール通知が送信される登録者として追加されます。他の[チームメンバー](https://docs.stripe.com/get-started/account/teams.md)にも通知するには、メンバーのメールアドレスを入力します。メールで送信される結果には、スケジュール設定されたクエリの名前と日付、および結果を CSV 形式でダウンロードするためのリンクが含まれます。メールのデザインをプレビューするには、**メールをプレビュー**をクリックします。

お客様またはチームメンバーは、メールの**登録を解除**リンクをクリックして、いつでも通知の受信を停止できます。ダッシュボードでスケジュールされたクエリを編集し、サブスクリプション登録者を追加または削除することもできます。

### タイムライン

選択したスケジュールに基づいて、タイムラインには次回のクエリが実行される日付と、クエリが使用するデータの処理日が表示されます (アカウントデータをクエリで使用できるようにするには、追加の時間が必要です)。

### スケジュール済みのクエリを管理する

次回のスケジュール済みのクエリは、 **クエリ** タブの **スケジュール済み** の下に表示されます。スケジュールは、作成者 (本人またはチームメンバー) に基づいてグループ化されます。

スケジュール済みのクエリを編集するには、クエリを選択して**スケジュールを編集**をクリックします。削除するには、**—** をクリックし、**削除**を選択します。

### Webhook で結果を受信する

[Webhook](https://docs.stripe.com/webhooks.md) を使用すると、スケジュール済みのクエリの通知を Webhook イベントとして受け取ることができます。たとえば、Stripe はスケジュール済みのクエリが実行されるたびに、`sigma.scheduled_query_run.created` イベントを送信します。サンプルイベントについては、以下をご覧ください。

Webhook ペイロードの `data.object.file.url` サブフィールドには、 **本番シークレット API キーを使用し** 結果ファイルにアクセスできる URL が含まれています。たとえば、サーバーが以下の Webhook を受信した場合、次の `curl` コマンドを使用して結果をダウンロードできます。

```bash
curl https://files.stripe.com/v1/files/{{ FILE ID }}/contents -u sk_live_XXXXXXX:
```

Webhook の組み込み方法の詳細は、[Webhook ドキュメント](https://docs.stripe.com/webhooks.md)をご覧ください。

`sigma.scheduled_query_run.created` Webhook のサンプルペイロード。

```json
{
  "object": "event",
  "pending_webhooks": 2,
  "created": 1504794194,
  "type": "sigma.scheduled_query_run.created",
  "livemode": true,
  "request": null,
  "data": {
    "object": {
      "id": "sqr_orWziM4j7CiRL8J4vQmX",
      "object": "scheduled_query_run",
      "status": "completed",
      "data_load_time": 1504656000,
      "file": {
        "id": "{{ FILE ID }}",
        "object": "file",
        "url": "https://files.stripe.com/v1/files/{{ FILE ID }}/contents",
        "created": 1507841188,
        "purpose": "sigma_scheduled_query",
        "size": 53075,
        "type": "csv"
      },
      "title": "Scheduled Query Example",
      "sql": "SELECT count(*) FROM charges WHERE created >= date('2017-01-01')",
      "created": 1504794194,
      "result_available_until": 1505398933,
      "error": null,
      "livemode": true
    }
  }
}
```