Compartilhar via

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

  • Aplica-se a: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

A SUBSTRING função retorna parte de uma expressão de cadeia de caracteres começando na posição especificada e do comprimento especificado ou até o final da cadeia de caracteres.

Uma função de sistema do Azure Cosmos DB para NoSQL que retorna uma parte de uma cadeia de caracteres usando uma posição e comprimento iniciais.

Sintaxe

SUBSTRING(<string_expr>, <numeric_expr_1>, <numeric_expr_2>)

Arguments

Description
string_expr Uma expressão de cadeia de caracteres.
numeric_expr_1 Uma expressão numérica para denotar o caractere inicial.
numeric_expr_2 Uma expressão numérica para indicar o número máximo de caracteres a string_expr serem retornados.

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.

Extrair subcadeias de caracteres de uma cadeia de caracteres

Neste exemplo, a SUBSTRING função é usada para retornar subcadeias de caracteres com vários comprimentos e posições iniciais.

SELECT VALUE {
  substringPrefix: SUBSTRING("AdventureWorks", 0, 9),
  substringSuffix: SUBSTRING("AdventureWorks", 9, 5),
  substringTotalLength: SUBSTRING("AdventureWorks", 0, LENGTH("AdventureWorks")),
  substringEmptyString: SUBSTRING("AdventureWorks", 0, -1)
}

[
  {
    "substringPrefix": "Adventure",
    "substringSuffix": "Works",
    "substringTotalLength": "AdventureWorks",
    "substringEmptyString": ""
  }
]

Observações

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