数组类型（公测中）

UPSERT

您可以通过以下两种方式写入Array类型的数据。

• 使用方括号（[]）或大括号（{}）表示数组，以字符串格式写入。例如：'[element1, element2, ...]' 或 '{element1, element2, ...}'。

  说明

  若element的类型是字符串，则需要使用半角双引号（""）引起来，例如'["a", "b", "c"]'。

  示例如下：

  UPSERT INTO t1(id, intArr, integerArr, bigintArr, smallintArr, tinyintArr, floatArr, doubleArr, varcharArr, booleanArr) VALUES (1, '[1, 2]', '[1, 2]', '[1, 2]', '[1, 2]', '[1, 2]', '[1.1, 2.2]', '[1.1, 2.2]', '["a", "b"]', '[true, false]');
  
  UPSERT INTO t2(id, intArr, integerArr, bigintArr, smallintArr, tinyintArr, floatArr, doubleArr, varcharArr, booleanArr) VALUES (1, '{1, 2}', '{1, 2}', '{1, 2}', '{1, 2}', '{1, 2}', '{1.1, 2.2}', '{1.1, 2.2}', '{"a", "b"}', '{true, false}');

• 使用Array构造器表示数组，即ARRAY[element1, element2, ...]。

  说明

  若element的类型是字符串，则需要使用半角单引号（''）引起来，例如ARRAY['a', 'b', 'c']。

  示例如下：

  UPSERT INTO t2(id, intArr, integerArr, bigintArr, smallintArr, tinyintArr, floatArr, doubleArr, varcharArr, booleanArr) VALUES (2, ARRAY[3, 4], ARRAY[3, 4], ARRAY[3, 4], ARRAY[3, 4], ARRAY[3, 4], ARRAY[3.3, 4.4], ARRAY[3.3, 4.4], ARRAY['c', 'd'], ARRAY[true, false]);

UPDATE

您可以通过array_append在数组的尾部添加元素，每次最多可以插入4个元素。

• 示例一：使用array_append在数组尾部添加一个元素。

  UPDATE t1 SET intArr = ARRAY_APPEND(intArr, 3), integerArr = ARRAY_APPEND(integerArr, 3), bigintArr = ARRAY_APPEND(bigintArr, 3), smallintArr = ARRAY_APPEND(smallintArr, 3), tinyintArr = ARRAY_APPEND(tinyintArr, 3), floatArr = ARRAY_APPEND(floatArr, 3.3), doubleArr = ARRAY_APPEND(doubleArr, 3.3), varcharArr = ARRAY_APPEND(varcharArr, 'c'), booleanArr = ARRAY_APPEND(booleanArr, true) WHERE id = 1;

• 示例二：使用array_append在数组尾部添加四个元素。

  UPDATE t1 SET intArr = ARRAY_APPEND(intArr, 4, 5, 6, 7), integerArr = ARRAY_APPEND(integerArr, 4, 5, 6, 7), bigintArr = ARRAY_APPEND(bigintArr, 4, 5, 6, 7), smallintArr = ARRAY_APPEND(smallintArr, 4, 5, 6, 7), tinyintArr = ARRAY_APPEND(tinyintArr, 4, 5, 6, 7), floatArr = ARRAY_APPEND(floatArr, 4.4, 5.5, 6.6, 7.7), doubleArr = ARRAY_APPEND(doubleArr, 4.4, 5.5, 6.6, 7.7), varcharArr = ARRAY_APPEND(varcharArr, 'd', 'e', 'f', 'g'), booleanArr = ARRAY_APPEND(booleanArr, false, false, false, false) WHERE id = 1;

SELECT

函数概览

针对数组类型的数据，Lindorm提供了以下函数，以满足更复杂的查询需求。

包含关系判断（数组包含元素）

包含关系判断（数组包含数组）

使用ARRAY_CONTAINS(arr, array_literal)函数，判断数组列arr是否包含数组array_literal里的每一个元素。

• 示例一：判断类型为INT的数组列intArr是否包含ARRAY[1,2]中的每一个元素。

  SELECT id, intArr FROM t1 WHERE id >= 0 AND id <= 10 AND ARRAY_CONTAINS(intArr, ARRAY[1,2]);

  返回结果：

  +------+-----------------+
  | id   | intArr          |
  +------+-----------------+
  |    1 | [1,2,3,4,5,6,7] |
  +------+-----------------+

• 示例二：判断类型为DOUBLE的数组列doubleArr是否包含ARRAY[1.1,1.1]中的每一个元素。

  SELECT id, doubleArr FROM t1 WHERE id >= 0 AND id <= 10 AND ARRAY_CONTAINS(doubleArr, ARRAY[1.1, 1.1]);

  返回结果：

  +------+-------------------------------+
  | id   | doubleArr                     |
  +------+-------------------------------+
  |    1 | [1.1,2.2,3.3,4.4,5.5,6.6,7.7] |
  +------+-------------------------------+

• 示例三：判断类型为VARCHAR的数组列varcharArr是否包含ARRAY['c', 'b', 'a']中的每一个元素。

  SELECT id, varcharArr FROM t1 WHERE id >= 0 AND id <= 10 AND ARRAY_CONTAINS(varcharArr, ARRAY['c', 'b', 'a']);

  返回结果：

  +------+-------------------------------+
  | id   | varcharArr                    |
  +------+-------------------------------+
  |    1 | ["a","b","c","d","e","f","g"] |
  +------+-------------------------------+

• 示例四：判断类型为BOOLEAN的数组列booleanArr是否包含ARRAY[true, true, true]中的每一个元素。

  SELECT id, booleanArr FROM t1 WHERE id >= 0 AND id <= 10 AND ARRAY_CONTAINS(booleanArr, ARRAY[true, true, true]);

  返回结果：

  +------+-------------------------------------------+
  | id   | booleanArr                                |
  +------+-------------------------------------------+
  |    1 | [true,false,true,false,false,false,false] |
  +------+-------------------------------------------+

数组相交判断

使用ARRAYS_OVERLAP(arr, array_literal)函数，判断数组列arr与数组array_literal是否存在公共元素。若任一参数为null，返回null；若无公共元素或者公共元素为null，返回false。

• 示例一：判断类型为INT的数组列intArr与数组ARRAY[1, 10, 100]是否存在公共元素，不存在返回null。

  SELECT id, intArr FROM t1 WHERE id >= 0 AND id <= 10 AND ARRAYS_OVERLAP(intArr, ARRAY[1, 10, 100]);

  返回结果：

  +------+-----------------+
  | id   | intArr          |
  +------+-----------------+
  |    1 | [1,2,3,4,5,6,7] |
  +------+-----------------+

• 示例二：判断类型为DOUBLE的数组列doubleArr与数组ARRAY[1.1, 1.1]是否存在公共元素，不存在返回null。

  SELECT id, doubleArr FROM t2 WHERE id >= 0 AND id <= 10 AND ARRAYS_OVERLAP(doubleArr, ARRAY[1.1, 1.1]);

  返回结果：

  +------+-----------+
  | id   | doubleArr |
  +------+-----------+
  |    1 | [1.1,2.2] |
  +------+-----------+

• 示例三：判断类型为VARCHAR的数组列varcharArr与数组ARRAY['a', 'c']是否存在公共元素，不存在返回null。

  SELECT id, varcharArr FROM t2 WHERE id >= 0 AND id <= 10 AND ARRAYS_OVERLAP(varcharArr, ARRAY['a', 'c']);

  返回结果：

  +------+------------+
  | id   | varcharArr |
  +------+------------+
  |    1 | ["a","b"]  |
  |    2 | ["c","d"]  |
  +------+------------+

• 示例四：判断类型为BOOLEAN的数组列booleanArr与数组ARRAY[true]是否存在公共元素，不存在返回空。

  SELECT id, booleanArr FROM t2 WHERE id >= 0 AND id <= 10 AND ARRAYS_OVERLAP(booleanArr, ARRAY[true]);

  返回结果：

  +------+--------------+
  | id   | booleanArr   |
  +------+--------------+
  |    1 | [true,false] |
  |    2 | [true,false] |
  +------+--------------+

统计数组元素数目

SELECT id, ARRAY_SIZE(varcharArr) AS varcharArraySize FROM t1;

+------+------------------+
| id   | varcharArraySize |
+------+------------------+
|    1 |                7 |
+------+------------------+