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

A SUBSTRING função devolve parte de uma expressão de cadeia a partir da posição e do comprimento especificados.

Uma função do sistema de base de dados Azure Cosmos que devolve uma porção de uma cadeia usando uma posição inicial e um 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 baseada em zero para indicar o carácter inicial. Um valor de 0 refere-se ao primeiro caractere.
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 utiliza indexação baseada em zeros, ou seja 0 , refere-se ao primeiro carácter da cadeia.
• Se numeric_expr_2 (comprimento) for negativo, a função devolve uma cadeia vazia.
• Para devolver uma subcadeia ao fim da cadeia, use a LENGTH função para calcular os caracteres restantes (por exemplo, SUBSTRING(str, start, LENGTH(str) - start)).
• Esta função beneficia da utilização de um índice de intervalo. Para obter mais informações, consulte Índices de intervalo.