NRQL 을 사용하면 시간에 따라 결과를 그룹화하는 쿼리를 만들 수 있습니다. 예를 들어 지정된 날짜 및 시간 범위를 포함하는 버킷으로 결과를 분리하여 타임스탬프를 기준으로 결과를 그룹화할 수 있습니다.
NRQL 쿼리에서 아래 표의 시간 함수를 사용하면 결과가 UTC로 반환됩니다. 결과를 시간대에 맞게 조정하려면 쿼리에 WITH TIMEZONE 절을 포함하세요.
Time-based function | Description | String format | Numeric format |
|---|---|---|---|
| 타임스탬프의 연도를 반환합니다. |
|
|
| 해당 연도의 분기를 반환합니다. 반환된 값에는 문자열 형식의 분기와 연도가 모두 포함됩니다. |
|
|
| 문자열 형식일 때 타임스탬프의 월과 연도를 반환하거나 숫자 형식일 때 숫자 월을 반환합니다. |
|
|
| 해당 주의 월요일의 월과 요일을 지정하여 타임스탬프가 발생한 주를 반환합니다. |
| 해당 없음 |
| 타임스탬프의 요일을 반환합니다. 반환된 값은 주말에 루프백되므로 시간 경과에 따른 요일별 추세를 볼 수 있습니다. |
|
|
| 타임스탬프의 날짜를 반환합니다. 반환된 값에는 월, 일 및 연도가 포함됩니다. |
| 해당 없음 |
| 타임스탬프의 한 달 내 숫자 날짜를 1에서 31 사이의 값으로 반환합니다. 반환된 값에는 월이 포함되지 않습니다. |
|
|
| 타임스탬프가 있는 월의 일 수를 반환합니다. |
|
|
| 타임스탬프의 시간을 반환합니다. 반환된 값에는 오전 1시에서 오전 9시 사이에 0이 추가되지 않습니다. 이는 시작 부분에 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의 선택적 두 번째 인수를 허용합니다.
SELECT count(*) FROM K8sDaemonsetSample FACET monthOf(createdAt, numeric)