Compartilhar via


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

A LEFT função retorna a parte esquerda de uma cadeia de caracteres até o número especificado de caracteres.

Uma função do sistema do Azure Cosmos DB para NoSQL que retorna uma subcadeia de caracteres do lado esquerdo de uma cadeia de caracteres.

Sintaxe

LEFT(<string_expr>, <numeric_expr>)

Arguments

Description
string_expr Uma expressão de cadeia de caracteres.
numeric_expr Uma expressão numérica que especifica o número de caracteres a serem extraídos.string_expr

Tipos de retorno

Retorna uma expressão de cadeia de caracteres.

Exemplos

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

Obter parte esquerda da cadeia de caracteres

Neste exemplo, a LEFT função é usada para retornar a parte esquerda da cadeia de caracteres AdventureWorks para vários valores de comprimento.

SELECT VALUE {
  firstZero: LEFT("AdventureWorks", 0),
  firstOne: LEFT("AdventureWorks", 1),
  firstFive: LEFT("AdventureWorks", 5),
  fullLength: LEFT("AdventureWorks", LENGTH("AdventureWorks")),
  beyondMaxLength: LEFT("AdventureWorks", 100)
}
[
  {
    "firstZero": "",
    "firstOne": "A",
    "firstFive": "Adven",
    "fullLength": "AdventureWorks",
    "beyondMaxLength": "AdventureWorks"
  }
]

Observações

  • Essa função se beneficia do uso de um índice de intervalo. Para obter mais informações, consulte índices de intervalo.