Compartilhar 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 retorno

Retorna uma expressão numérica.

Exemplos

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

Obter 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

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