スケジュールされたクエリのスケジュール式 - Amazon Timestream

Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、こちらを参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

スケジュールされたクエリのスケジュール式

cron 式または rate 式を使用する Amazon Timestream for LiveAnalytics のスケジュールされたクエリを使用することで、スケジュールされたクエリを自動化されたスケジュールで作成できます。スケジュールされたクエリで使用されるタイムゾーンはすべて UTC で、スケジュールの最小精度は 1 分です。

スケジュール式は、cron と rate の 2 つの方法で指定できます。cron 式はよりきめ細かくスケジュールを制御できる一方、rate 式はシンプルですがきめ細かな制御はできません。

例えば、cron 式を使用した場合、毎週または毎月、特定の日の指定された時刻にトリガーされるスケジュールされたクエリや、月曜日から金曜日までのみ、決まった時間 (分) に 1 時間おきでトリガーされるスケジュールされたクエリを定義できます。一方、rate 式は、スケジュールされたクエリを作成時刻から一定間隔 (1 分、1 時間、1 日おきなど) で開始します。

Cron 式

  • 構文

    cron(fields)

    cron 式には 6 つの必須フィールドがあり、それらは空白で区切られます。

    フィールド 値 ワイルドカード

    分

    0-59

    , - * /

    時間

    0-23

    , - * /

    日

    1-31

    , - * ? / L W

    月

    1-12 または JAN-DEC

    , - * /

    曜日

    1-7 または SUN-SAT

    , - * ? L #

    年

    1970-2199

    , - * /
    ワイルドカード文字

    • ワイルドカード *,* (カンマ) には追加の値が含まれます。月フィールドの、「JAN,FEB,MAR」は、1 月、2 月、3 月を含みます。

    • ワイルドカード *-* (ダッシュ) は範囲を指定します。日フィールドの、「1-15」は、指定した月の 1 日から 15 日を含みます。

    • ワイルドカード *** (アスタリスク) にはフィールドのすべての値が含まれます。時フィールドの *** にはすべての時間が含まれます。*** を日および曜日フィールドの両方に使用することはできません。一方に使用する場合は、もう一方に *?* を使用する必要があります。

    • ワイルドカード */* (スラッシュ) は増分を意味します。分フィールドで、「1/10」と入力して、その時の最初の分から始めて、10 分おきを指定できます (11 分、21 分、31 分など)。

    • *?* (疑問符) ワイルドカードは任意を意味します。日フィールドに *7* と入力し、7 日が何曜日であってもかまわない場合、曜日フィールドに *?* を入力できます。

    • 日フィールドまたは曜日フィールドの、*L* ワイルドカードは、月または週の最終日を意味します。

    • 日フィールドのワイルドカード W は、平日を意味します。日フィールドで、3W は月の 3 日目に最も近い平日を意味します。

    • 曜日フィールドのワイルドカード *#* は、月の指定された曜日の特定のインスタンスを意味します。例えば、3#2 は、月の第 2 火曜日を示します。3 は週の 3 番目の日 (火曜日) を示し、2 は月のそのタイプの 2 番目の日を示します。

    注記

    「#」文字を使用する場合、曜日フィールドには 1 つの式しか定義できません。例えば、「3#1,6#3」は 2 つの式として解釈されるため、無効です。

    制限

    • cron 式の日フィールドと曜日フィールドを同時に指定することはできません。一方のフィールドに値 (または *) を指定する場合、もう一方のフィールドで *?* (疑問符) を使用する必要があります。

    • 1 分より短い間隔を導き出す cron 式はサポートされていません。

    例

    分 時間 日 月 曜日 年 意味
    0 10 * * ? * 毎日午前 10:00 (UTC) に実行。
    15 12 * * ? * 毎日午後 12:15 (UTC) に実行。
    0 18 ? * MON-FRI * 毎週月曜日～金曜日の午後 6:00 (UTC) に実行。
    0 8 1 * ? * 毎月 1 日の午前 8:00 (UTC) に実行。
    0/15 * * * ? * 15 分ごとに実行。
    0/10 * * * MON-FRI * 月曜日～金曜日に 10 分ごとに実行。
    0/5 8-17 ? * MON-FRI * 毎週月曜日～金曜日の午前 8:00～午後 5:55 (UTC) に 5 分ごとに実行。
rate 式

  • rate 式は、予定されたイベントルールを作成すると開始され、その定義済されたスケジュールに基づいて実行されます。rate 式は 2 つの必須フィールドがあります。フィールドは空白で区切ります。

    構文

    rate(value unit)

    • value: 正数。

    • unit: 時刻の単位。1 の値 (minute など) と 1 より大きい値 (minutes など) には、異なる単位が必要です。有効な値: minute | minutes | hour | hours | day | days