본문으로 건너뛰기
최종 수정: 에

ARRAY_RANGE

설명​

숫자 또는 날짜/시간 값으로 이루어진 등차수열 배열을 생성합니다. 결과에는 시작 값이 포함되고 끝 값은 제외됩니다. 인수 중 하나라도 NULL이면 NULL을 반환합니다.

Doris 4.1 계열의 4.1.5부터는 마지막 값과 끝 값 사이의 간격이 지정한 간격보다 짧더라도 날짜/시간 수열에서 끝 값보다 작은 모든 유효한 값을 유지합니다. 이전 버전에서는 수열 끝부분의 이러한 값이 누락될 수 있었습니다.

구문​

ARRAY_RANGE(<end>)
ARRAY_RANGE(<start>, <end> [, <step>])
ARRAY_RANGE(<start_dt>, <end_dt> [, INTERVAL <step> <unit>])

매개변수​

매개변수설명
<start>음이 아닌 INT 시작 값으로, 생략할 수 있습니다. 기본값은 0입니다.
<end>음이 아닌 INT 끝 값으로, 결과에서 제외됩니다.
<step>양의 정수 간격으로, 생략할 수 있습니다. 기본값은 1입니다.
<start_dt>, <end_dt>DATETIME 또는 TIMESTAMP_NS 타입의 시작 값과 끝 값입니다. 두 인수의 타입은 같아야 합니다. 끝 값은 제외됩니다. INTERVAL을 지정하지 않으면 간격은 1 DAY입니다.
<unit>날짜/시간 간격의 단위입니다. YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE 또는 SECOND를 사용할 수 있습니다.

반환 값​

ARRAY를 반환합니다. 숫자 수열에는 INT 요소가 포함되며, 날짜/시간 수열에는 입력 타입인 DATETIME 또는 TIMESTAMP_NS의 요소가 포함됩니다.

  • 인수 중 하나라도 NULL이거나 유효하지 않으면 NULL을 반환합니다. 유효하지 않은 인수의 예로는 음수인 숫자 시작 값이나 끝 값, 양수가 아닌 간격이 있습니다.
  • 시작 값이 끝 값보다 크거나 같으면 빈 배열 []을 반환합니다.
  • 각 후속 값은 이전 값을 기준으로 계산합니다. 월 단위 연산에서는 날짜가 대상 월의 마지막 날로 조정될 수 있습니다.
  • 수열이 배열 크기 제한을 초과하면 오류를 보고합니다. 다음 값이 날짜 타입의 범위를 벗어나면 마지막 유효한 값까지만 생성하고 중단합니다.
  • SEQUENCE는 ARRAY_RANGE의 별칭입니다.

예제​

숫자 수열에는 끝 값이 포함되지 않습니다.

SELECT ARRAY_RANGE(5), ARRAY_RANGE(2, 6, 2), ARRAY_RANGE(3, 2);
[0, 1, 2, 3, 4]    [2, 4]    []

날짜/시간 수열의 기본 간격은 하루입니다. 끝 값까지 남은 시간이 하루보다 짧더라도 마지막 값은 유지됩니다.

SELECT ARRAY_RANGE(
    CAST('2024-01-01 00:00:00.000000' AS DATETIME(6)),
    CAST('2024-01-02 12:00:00.000000' AS DATETIME(6)));
["2024-01-01 00:00:00.000000", "2024-01-02 00:00:00.000000"]

월 단위 간격은 이전에 생성한 날짜를 기준으로 더해집니다.

SELECT ARRAY_RANGE(
    CAST('2020-01-31 00:00:00' AS DATETIME(6)),
    CAST('2020-03-30 00:00:00' AS DATETIME(6)), INTERVAL 1 MONTH);
["2020-01-31 00:00:00.000000", "2020-02-29 00:00:00.000000", "2020-03-29 00:00:00.000000"]

SEQUENCE에도 동일한 규칙이 적용됩니다.

SELECT SEQUENCE(
    CAST('2024-01-01 00:00:00.000000' AS DATETIME(6)),
    CAST('2024-01-01 00:00:01.500000' AS DATETIME(6)), INTERVAL 1 SECOND);
["2024-01-01 00:00:00.000000", "2024-01-01 00:00:01.000000"]

NULL이거나 유효하지 않은 인수:

SELECT ARRAY_RANGE(NULL), ARRAY_RANGE(-1, 3), ARRAY_RANGE(1, 3, 0);
NULL    NULL    NULL

TIMESTAMP_NS 입력은 나노초 정밀도를 유지합니다.

SELECT ARRAY_RANGE(
    CAST('2022-05-15 12:00:00.123456789' AS TIMESTAMP_NS),
    CAST('2022-05-15 12:00:02.123456789' AS TIMESTAMP_NS), INTERVAL 1 SECOND);
["2022-05-15 12:00:00.123456789", "2022-05-15 12:00:01.123456789"]
Report issue