array_slice

array_slice

description

Syntax

ARRAY<T> array_slice(ARRAY<T> arr, BIGINT off, BIGINT len)

Returns a slice of the array.

  1. A positive off indicates an indent on the left
  2. A negative off indicates an indent on the right.
  3. An empty array is returned when the off is not within the actual range of the array.
  4. A negative len will be treated as 0.

example

  1. mysql> select k2, k2[2:2] from array_type_table_nullable;
  2. +-----------------+-------------------------+
  3. | k2              | array_slice(`k2`, 2, 2) |
  4. +-----------------+-------------------------+
  5. | [1, 2, 3]       | [2, 3]                  |
  6. | [1, NULL, 3]    | [NULL, 3]               |
  7. | [2, 3]          | [3]                     |
  8. | NULL            | NULL                    |
  9. +-----------------+-------------------------+
  11. mysql> select k2, array_slice(k2, 2, 2) from array_type_table_nullable;
  12. +-----------------+-------------------------+
  13. | k2              | array_slice(`k2`, 2, 2) |
  14. +-----------------+-------------------------+
  15. | [1, 2, 3]       | [2, 3]                  |
  16. | [1, NULL, 3]    | [NULL, 3]               |
  17. | [2, 3]          | [3]                     |
  18. | NULL            | NULL                    |
  19. +-----------------+-------------------------+
  21. mysql> select k2, k2[2:2] from array_type_table_nullable_varchar;
  22. +----------------------------+-------------------------+
  23. | k2                         | array_slice(`k2`, 2, 2) |
  24. +----------------------------+-------------------------+
  25. | ['hello', 'world', 'c++']  | ['world', 'c++']        |
  26. | ['a1', 'equals', 'b1']     | ['equals', 'b1']        |
  27. | ['hasnull', NULL, 'value'] | [NULL, 'value']         |
  28. | ['hasnull', NULL, 'value'] | [NULL, 'value']         |
  29. +----------------------------+-------------------------+
  31. mysql> select k2, array_slice(k2, 2, 2) from array_type_table_nullable_varchar;
  32. +----------------------------+-------------------------+
  33. | k2                         | array_slice(`k2`, 2, 2) |
  34. +----------------------------+-------------------------+
  35. | ['hello', 'world', 'c++']  | ['world', 'c++']        |
  36. | ['a1', 'equals', 'b1']     | ['equals', 'b1']        |
  37. | ['hasnull', NULL, 'value'] | [NULL, 'value']         |
  38. | ['hasnull', NULL, 'value'] | [NULL, 'value']         |
  39. +----------------------------+-------------------------+

Negative off:

  1. mysql> select k2, k2[-2:1] from array_type_table_nullable;
  2. +-----------+--------------------------+
  3. | k2        | array_slice(`k2`, -2, 1) |
  4. +-----------+--------------------------+
  5. | [1, 2, 3] | [2]                      |
  6. | [1, 2, 3] | [2]                      |
  7. | [2, 3]    | [2]                      |
  8. | [2, 3]    | [2]                      |
  9. +-----------+--------------------------+
  11. mysql> select k2, array_slice(k2, -2, 1) from array_type_table_nullable;
  12. +-----------+--------------------------+
  13. | k2        | array_slice(`k2`, -2, 1) |
  14. +-----------+--------------------------+
  15. | [1, 2, 3] | [2]                      |
  16. | [1, 2, 3] | [2]                      |
  17. | [2, 3]    | [2]                      |
  18. | [2, 3]    | [2]                      |
  19. +-----------+--------------------------+
  21. mysql> select k2, k2[-2:2] from array_type_table_nullable_varchar;
  22. +----------------------------+--------------------------+
  23. | k2                         | array_slice(`k2`, -2, 2) |
  24. +----------------------------+--------------------------+
  25. | ['hello', 'world', 'c++']  | ['world', 'c++']         |
  26. | ['a1', 'equals', 'b1']     | ['equals', 'b1']         |
  27. | ['hasnull', NULL, 'value'] | [NULL, 'value']          |
  28. | ['hasnull', NULL, 'value'] | [NULL, 'value']          |
  29. +----------------------------+--------------------------+
  31. mysql> select k2, array_slice(k2, -2, 2) from array_type_table_nullable_varchar;
  32. +----------------------------+--------------------------+
  33. | k2                         | array_slice(`k2`, -2, 2) |
  34. +----------------------------+--------------------------+
  35. | ['hello', 'world', 'c++']  | ['world', 'c++']         |
  36. | ['a1', 'equals', 'b1']     | ['equals', 'b1']         |
  37. | ['hasnull', NULL, 'value'] | [NULL, 'value']          |
  38. | ['hasnull', NULL, 'value'] | [NULL, 'value']          |
  39. +----------------------------+--------------------------+
  1. mysql> select k2, array_slice(k2, 0) from array_type_table;
  2. +-----------+-------------------------+
  3. | k2        | array_slice(`k2`, 0) |
  4. +-----------+-------------------------+
  5. | [1, 2, 3] | []                      |
  6. +-----------+-------------------------+
  8. mysql> select k2, array_slice(k2, -5) from array_type_table;
  9. +-----------+----------------------+
  10. | k2        | array_slice(`k2`, -5) |
  11. +-----------+----------------------+
  12. | [1, 2, 3] | []                   |
  13. +-----------+----------------------+

keywords

ARRAY,SLICE,ARRAY_SLICE