Partilhar via


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 devolução

Retorna uma expressão numérica.

Examples

Esta seção contém exemplos de como usar essa construção de linguagem de consulta.

Exemplos de comprimento de 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

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