Hologres支援的集合返回函數 - Hologres

Hologres相容PostgreSQL，支援使用標準的PostgreSQL文法進行開發。

Hologres已支援的集合返回函數列表如下。當前Hologres版本支援的函數是PostgreSQL的一個子集，函數的使用方法請參見集合返回函數。

函數	功能
GENERATE_SERIES	從起始值到結束值產生一個固定步長的數值或日期序列。
GENERATE_SUBSCRIPTS	為給定數組的指定維度產生有效下標集。

GENERATE_SERIES

GENERATE_SERIES(start, stop [,step])
- 描述：從start到stop產生一個固定步長的數值序列。
```
GENERATE_SERIES(start, stop[, step])
```
- 參數說明
  start：必填，起始值，資料類型為INT、BIGINT或NUMERIC。
  stop：必填，結束值，資料類型為INT、BIGINT或NUMERIC。
  step：可選，步長值，資料類型為INT、BIGINT或NUMERIC。不填則預設步長為1。
- 傳回值說明
  返回與入參類型一致的一組序列。
- 樣本
  - 樣本1：
```
SELECT GENERATE_SERIES(2, 4);
```
    傳回值結果如下。
```
 generate_series
-----------------
               2
               3
               4
```
  - 樣本2：
```
SELECT GENERATE_SERIES(5, 1, -2);
```
    返回結果如下。
```
 generate_series
-----------------
               5
               3
               1
```
GENERATE_SERIES(start, stop, step INTERVAL)
- 描述：從start到stop產生一個步長為step的日期序列。
```
GENERATE_SERIES(start, stop, step INTERVAL)
```
- 參數說明
  start：必填，起始值，資料類型為TIMESTAMP和TIMESTAMP WITH TIME ZONE。
  stop：必填，結束值，資料類型為TIMESTAMP和TIMESTAMP WITH TIME ZONE。
  step：必填，步長值（即時間間隔），資料類型為INTERVAL。
- 傳回值說明
  返回與入參類型一致的一組日期序列。
- 樣本
```
SELECT GENERATE_SERIES('2024-10-01 00:00'::timestamp, '2024-10-01 12:00', '10 hours');
```
  返回結果如下。
```
   generate_series
---------------------
 2024-10-01 00:00:00
 2024-10-01 10:00:00
```

GENERATE_SUBSCRIPTS

描述：為給定數組的指定維度產生有效下標集。
```
GENERATE_SUBSCRIPTS(anyarray, dim)
```
參數說明
anyarray：必填，任何類型的多維陣列。
dim：必填，多維陣列的維度，INT類型。
傳回值說明
返回整型的集合。

樣本

SELECT GENERATE_SUBSCRIPTS('{NULL,1,NULL,2}'::int[], 1);

返回結果如下。

 generate_subscripts
---------------------
                   1
                   2
                   3
                   4