跳到主要内容
版本：Latest-3.2

array_slice

功能​

返回数组的一个数组片段。根据 offset 指定的位置，从 input 中截取长度为 length 的数组片段。

语法​

array_slice(input, offset, length)

参数说明​

  • input：输入数组，类型为 ARRAY。数组元素可以是以下数据类型：BOOLEAN、TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE、DECIMALV2、VARCHAR、DATETIME、DATE、JSON。从 2.5 版本开始，该函数支持 JSON 类型的数组元素。
  • offset: 结果数组片段的起始偏移 (从 1 开始)。支持的数据类型为 BIGINT。
  • length: 结果数组片段的长度，即元素个数。支持的数据类型为 BIGINT。

返回值说明​

返回值的数据类型为 ARRAY (元素类型与输入 input 保持一致)。

注意事项​

  • 偏移量从 1 开始。
  • 如果指定的截取长度大于实际能截取的长度，则返回全部符合条件的元素，见示例四。

示例​

示例一

mysql> select array_slice([1,2,4,5,6], 3, 2) as res;
+-------+
| res   |
+-------+
| [4,5] |
+-------+

示例二

mysql> select array_slice(["sql","storage","query","execute"], 1, 2) as res;
+-------------------+
| res               |
+-------------------+
| ["sql","storage"] |
+-------------------+

示例三

mysql> select array_slice([57.73,97.32,128.55,null,324.2], 3, 3) as res;
+---------------------+
| res                 |
+---------------------+
| [128.55,null,324.2] |
+---------------------+

示例四

mysql> select array_slice([57.73,97.32,128.55,null,324.2], 3, 5) as res;
+---------------------+
| res                 |
+---------------------+
| [128.55,null,324.2] |
+---------------------+

以上示例中，指定的长度为 5， 但是只有 3 个元素符合条件，返回全部 3 个元素。