スケジュールされた SQL タスクは、SQL タイムウィンドウを使用して、Simple Log Service (SLS) が分析するログの範囲を制限します。時間式を使用してウィンドウの境界を定義します。
演算子
時間式は、次の演算子をサポートしています。
|
演算子 |
説明 |
|
+ |
プラス記号 |
|
- |
マイナス記号 |
|
@ |
時間値を指定された時間単位に切り捨てます。たとえば、01:40 を時間単位に切り捨てると、01:00 になります。 |
時間式のフォーマットは ±{num}{unit} または @{unit} です。ここで、{num} は正の整数、{unit} は時間単位を表します。
-
演算子がプラス記号 (+) またはマイナス記号 (-) の場合、計算単位は ±{num}{unit} のフォーマットになります。このフォーマットでは、{num} は省略可能で、デフォルト値は 1 です。たとえば、時間式 -h は 1 時間を減算することを意味します。
-
演算子がアットマーク (@) の場合、計算単位のフォーマットは @{unit} になります。
時間単位
時間式は、次の時間単位をサポートしています。
|
時間単位 |
説明 |
|
h |
時間 |
|
m |
分 |
|
s |
秒 |
使用例
以下に、時間式の実際の動作例を示します。
|
時間式 |
説明 |
|
-15m@m |
15 分を減算してから、結果を分単位に切り捨てます。 たとえば、スケジュールされた SQL タスクを作成し、スケジュール間隔の指定 を 毎日 00:00、タスクの延期 を 30 秒、SQL タイムウィンドウ を [-15m@m,-5m@m) に設定した場合、SQL タスクは 00:00:30 に実行され、 |
|
-h@h |
1 時間を減算してから、結果を時間単位に切り捨てます。 たとえば、スケジュールされた SQL タスクを作成し、スケジュール間隔の指定 を 毎日 00:00、タスクの延期 を 30 秒、SQL タイムウィンドウ を [-h@h,-5m@m) に設定した場合、SQL タスクは 00:00:30 に実行され、[23:00, 23:55) の時間範囲のデータを分析します。 |
|
-50m@h |
50 分を減算してから、結果を時間単位に切り捨てます。 たとえば、スケジュールされた SQL タスクを作成し、スケジュール間隔の指定 を 毎日 00:00、タスクの延期 を 30 秒、SQL タイムウィンドウ を [-50m@h,-5m@m) に設定した場合、タスクは 00:00:30 に実行され、[23:00, 23:55) の時間範囲のデータを分析します。 |
|
-12h+5m |
12 時間を減算してから、5 分を加算します。これは、11 時間 55 分を減算することと同等です。 たとえば、スケジュールされた SQL タスクを作成し、スケジュール間隔の指定 を 毎日 00:00、タスクの延期 を 30 秒、SQL タイムウィンドウ を [-12h+5m,-5m) に設定した場合、SQL タスクは 00:00:30 に実行され、 |