Partilhar via


LENGTH - Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A LENGTH função retorna o número de caracteres na expressão de cadeia de caracteres especificada.

Uma função de sistema do Azure Cosmos DB para NoSQL que retorna o comprimento numérico de uma expressão de cadeia de caracteres.

Sintaxe

LENGTH(<string_expr>)

Arguments

Description
string_expr Uma expressão de cadeia de caracteres.

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.

Obter o comprimento da cadeia de caracteres

Neste exemplo, a LENGTH função é usada para retornar o comprimento de uma cadeia de caracteres estática.

SELECT VALUE {
  stringValue: LENGTH("AdventureWorks"),
  emptyString: LENGTH("")
}
[
  {
    "stringValue": 14,
    "emptyString": 0
  }
]

Observações

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