NRQL 을 사용하면 시간에 따라 결과를 그룹화하는 쿼리를 만들 수 있습니다. 예를 들어 지정된 날짜 및 시간 범위를 포함하는 버킷으로 결과를 분리하여 타임스탬프를 기준으로 결과를 그룹화할 수 있습니다.
NRQL 쿼리에서 시간 함수 를 사용할 때 결과는 UTC로 반환됩니다. 결과를 시간대에 맞게 조정하려면 쿼리에 WITH TIMEZONE 절 을 포함합니다.
NRQL 쿼리 시간 범위 패싯
NRQL 쿼리를 생성하려면 타임스탬프 속성과 함께 작동하는 버킷 함수와 함께 FACET 절 을 사용합니다. 표준 FACET 쿼리를 실행하되 속성을 기준으로 패싯을 지정하는 대신 시간을 기준으로 패싯을 지정합니다. 예를 들어:
SELECT count(*) FROM PageView SINCE 1 day ago FACET monthOf(account_created)
동일한 쿼리 내에서 여러 기능을 수행하려면 NRQL의 다면적 기능을 사용하십시오.
SELECT count(*) FROM PageView SINCE 1 day ago FACET dateOf(account_created), monthOf(account_created)
시간 기반 함수
설명
yearOf(attr)
타임스탬프의 연도를 반환합니다.
quarterOf(attr)
해당 연도의 분기를 반환합니다. 반환된 값에는 분기와 연도가 모두 포함됩니다.
예시: Q1 2014
monthOf(attr)
타임스탬프의 월과 연도를 반환합니다.
예시: July 2014
weekOf(attr)
해당 주의 월요일의 월과 요일을 지정하여 타임스탬프가 발생한 주를 반환합니다.
예: Week of January 15 .
weekdayOf(attr)
타임스탬프의 요일을 반환합니다. 반환된 값은 주말에 루프백되므로 시간 경과에 따른 요일별 추세를 볼 수 있습니다.
dateOf(attr)
타임스탬프의 날짜를 반환합니다. 반환된 값에는 월, 일 및 연도가 포함됩니다.
예시: July 15, 2014
dayOfMonthOf(attr)
타임스탬프의 한 달 내 숫자 날짜를 1에서 31 사이의 값으로 반환합니다. 반환된 값에는 월이 포함되지 않습니다.
hourOf(attr)
타임스탬프의 시간을 반환합니다.
반환된 값에는 오전 1시에서 오전 9시 사이에 0이 추가되지 않습니다. 이는 시작 부분에 0이 있는 이러한 시간을 허용하는 SINCE 과 같은 함수 및 절과 다릅니다.
예: 6:00 , 12:00 , 18:00
월을 기준으로 모든 결과를 그룹화하려면 monthOf 함수를 사용합니다. 이 예에서 NRQL 쿼리에는 함수( count(*) ), 데이터 유형( PageView ), 시간 프레임( SINCE 1 day ago ) 및 시간 패싯( monthOf(attribute) )이 포함됩니다.
SELECT count(*) FROM PageView SINCE 1 day ago FACET monthOf(account_created)
쿼리를 실행하면 월별 결과 테이블이 반환됩니다.
NRQL 쿼리를 실행하여 시간뿐만 아니라 다른 방식으로 데이터를 그룹화할 수 있습니다. 추가 예는 NRQL FACET 문서 를 참조하십시오.
TIMESERIES 함수를 추가하고 시계열 차트에서 시간 함수를 사용하기 전까지는 알고 있어야 합니다. UNTIL의 기본값은 NOW이므로 아무 것도 지정하지 않으면 시간 함수의 값이 분리되거나 결합될 수 있습니다. UNTIL today 을 지정하면 같은 날 오전 12시에 끝나는 차트를 만들 수 있습니다.
SELECT count(*) FROM PageView TIMESERIES 1 day WITH TIMEZONE '<localTimeZone>' SINCE 4 week ago UNTIL today
지난 4주가 아닌 last month 의 데이터를 시각화하려는 경우 since last month until this month 을 사용할 수 있습니다.
SELECT count(*) FROM PageView TIMESERIES 1 day WITH TIMEZONE '<localTimeZone>' since last month until this month