SUBSTRING - Linguagem de consulta no Cosmos DB (no Azure e no 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 do sistema Azure Cosmos DB para NoSQL que retorna uma parte de uma cadeia de caracteres usando uma posição inicial e comprimento.

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 indicar o caractere inicial.
numeric_expr_2	Uma expressão numérica para indicar o número máximo de caracteres a serem retornados 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.

Extrair substrings de uma cadeia de caracteres

Neste exemplo, a SUBSTRING função é usada para retornar substrings 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

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