ARRAY_SLICE (Azure Cosmos DB)

适用于: SQL API

返回部分数组表达式。

语法

ARRAY_SLICE (<arr_expr>, <num_expr> [, <num_expr>])  

参数

arr_expr
是任何数组表达式。

num_expr
用于开始数组的从零开始的数字索引。 负值可用于指定相对于数组最后一个元素的起始索引,即 -1 引用数组中最后一个元素。

num_expr 可选数值表达式,用于设置生成的数组中的最大元素数。

返回类型

返回一个数组表达式。

示例

以下示例演示了如何使用 ARRAY_SLICE 获取数组的不同切片。

SELECT
   ARRAY_SLICE(["apples", "strawberries", "bananas"], 1) AS s1,  
   ARRAY_SLICE(["apples", "strawberries", "bananas"], 1, 1) AS s2,
   ARRAY_SLICE(["apples", "strawberries", "bananas"], -2, 1) AS s3,
   ARRAY_SLICE(["apples", "strawberries", "bananas"], -2, 2) AS s4,
   ARRAY_SLICE(["apples", "strawberries", "bananas"], 1, 0) AS s5,
   ARRAY_SLICE(["apples", "strawberries", "bananas"], 1, 1000) AS s6,
   ARRAY_SLICE(["apples", "strawberries", "bananas"], 1, -100) AS s7      

下面是结果集。

[{  
           "s1": ["strawberries", "bananas"],   
           "s2": ["strawberries"],
           "s3": ["strawberries"],  
           "s4": ["strawberries", "bananas"], 
           "s5": [],
           "s6": ["strawberries", "bananas"],
           "s7": [] 
}]  

备注

此系统函数不会使用索引。

后续步骤