SUBSTRING - Querytaal in Cosmos DB (in Azure en Fabric)

De SUBSTRING functie retourneert een deel van een tekenreeksexpressie vanaf de opgegeven positie en van de opgegeven lengte.

Een Systeemfunctie van Azure Cosmos DB die een deel van een tekenreeks retourneert met behulp van een beginpositie en lengte.

Syntaxis

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

Arguments

	Description
string_expr	Een tekenreeksexpressie.
numeric_expr_1	Een numerieke expressie op basis van nul om het beginteken aan te geven. Een waarde van 0 verwijst naar het eerste teken.
numeric_expr_2	Een numerieke expressie om het maximum aantal tekens aan te geven dat string_expr moet worden geretourneerd.

Retourtypen

Retourneert een tekenreeksexpressie.

Voorbeelden

Deze sectie bevat voorbeelden van het gebruik van deze querytaalconstructie.

Subtekenreeksen extraheren uit een tekenreeks

In dit voorbeeld wordt de SUBSTRING functie gebruikt om subtekenreeksen met verschillende lengten en beginposities te retourneren.

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": ""
  }
]

Opmerkingen

• Deze functie maakt gebruik van indexering op basis van nul, wat betekent dat 0 het eerste teken in de tekenreeks verwijst.
• Als numeric_expr_2 (lengte) negatief is, retourneert de functie een lege tekenreeks.
• Als u een subtekenreeks wilt retourneren aan het einde van de tekenreeks, gebruikt u de LENGTH functie om de resterende tekens te berekenen (bijvoorbeeld SUBSTRING(str, start, LENGTH(str) - start)).
• Deze functie profiteert van het gebruik van een bereikindex. Zie bereikindexen voor meer informatie.