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

De SUBSTRING functie retourneert een deel van een tekenreeksexpressie vanaf de opgegeven positie en de opgegeven lengte, of aan het einde van de tekenreeks.

Een Azure Cosmos DB for NoSQL-systeemfunctie 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 om het beginteken aan te geven.
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 profiteert van het gebruik van een bereikindex. Zie bereikindexen voor meer informatie.