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 Azure Cosmos DB para NoSQL que retorna uma substring 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 do string_expr.

Tipos de devolução

Retorna uma expressão de cadeia de caracteres.

Examples

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

Obter a 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

• Esta função beneficia da utilização de um índice de intervalo. Para obter mais informações, consulte Índices de intervalo.