NRQL では、時間をまたいで結果をグループ化するクエリを作成することができます。例えば、指定した日時の範囲をカバーするバケットに結果を分けることで、タイムスタンプに基づいて結果をグループ化することができます。
NRQL クエリで以下の表の時間関数を使用すると、結果は UTC で返されます。結果をタイムゾーンに合わせて調整するには、クエリにWITH TIMEZONE句を含めます。
Time-based function | Description | String format | Numeric format |
|---|---|---|---|
| タイムスタンプの年を返します。 |
|
|
| 年の四半期を返します。戻り値には、文字列としてフォーマットされている場合、四半期と年の両方が含まれます。 |
|
|
| 文字列としてフォーマットされた場合はタイムスタンプの月と年を返し、数値としてフォーマットされた場合は数値の月を返します。 |
|
|
| タイムスタンプが発生した週を、その週の月曜日の月と日を指定して返します。 |
| 該当なし |
| 取得したタイムスタンプの曜日を返します。返された値は週の終わりにループバックするので、曜日ごとの傾向を時系列で見ることができます。 |
|
|
| 取得したタイムスタンプの日付を返します。返される値には、月、日、年が含まれます。 |
| 該当なし |
| RETURN関数は、タイムスタンプの1ヶ月以内の日付を、1～31の数値で返します。返される値は月を含みません。 |
|
|
| タイムスタンプの月の日数を返します。 |
|
|
| タイムスタンプの時間を返します。 戻り値には、午前 1 時から午前 9 時までの時間の前に付加された 0 は含まれません。これは、 |
|
|
| タイムスタンプの分を返します。 戻り値には、1 から 9 までの分の前に追加された 0 は含まれません。これは、先頭が 0 の分を受け入れる |
|
|
あなたのNRQLクエリの時間範囲のファセット
ヒント
これらの例では、 createdAtという PageView イベントとともに送信されるカスタム タイムスタンプ属性を使用します。PageView イベントの取り込み時までにファセットするには、代わりにtimestamp属性を使用できます。
NRQL クエリを作成するには、タイムスタンプ属性で機能するバケット関数でFACET句を使用します。標準のFACETクエリを実行しますが、属性によるファセットではなく、時間によるファセットを行います。例えば：
SELECT count(*) FROM K8sDaemonsetSample FACET monthOf(createdAt)
同じクエリで複数の機能を実行するには、NRQL のマルチファセット機能を使用します。
SELECT count(*) FROM K8sDaemonsetSample FACET dateOf(createdAt), monthOf(createdAt)
多くの時間ベースの関数は、結果値の形式を制御する string (デフォルト) または numericのオプションの 2 番目の引数を受け入れます。
SELECT count(*) FROM K8sDaemonsetSample FACET monthOf(createdAt, numeric)