ARRAY_LENGTH – Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A ARRAY_LENGTH função retorna o número de elementos na expressão de matriz especificada.

Sintaxe

ARRAY_LENGTH(<array_expr>)

Arguments

	Description
array_expr	Uma expressão de matriz.

Tipos de retorno

Retorna uma expressão numérica.

Exemplos

Esta seção contém exemplos de como usar este constructo de linguagem de consulta.

Exemplos de comprimento da matriz

Neste exemplo, a ARRAY_LENGTH função é usada para obter o comprimento de várias matrizes.

SELECT VALUE {
  length: ARRAY_LENGTH([70, 86, 92, 99, 85, 90, 82]),
  emptyLength: ARRAY_LENGTH([]),
  nullLength: ARRAY_LENGTH(null)
}

[
  {
    "length": 7,
    "emptyLength": 0
  }
]

Observações

• Essa função não utiliza o índice.