メインコンテンツまでスキップ
に最終更新

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 型の開始値と終了値。終了値は含まれません。INTERVAL を指定しない場合、ステップは 1 DAY です。
<unit>日時ステップの単位:YEAR、QUARTER、MONTH、WEEK、DAY、HOUR、MINUTE、SECOND。

戻り値​

ARRAY を返します。数値シーケンスの要素は INT、日時シーケンスの要素は DATETIME です。

  • いずれかの引数が 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