SUBSTRING – Frågespråk i Cosmos DB (i Azure och Fabric)

Funktionen SUBSTRING returnerar en del av ett stränguttryck som börjar vid den angivna positionen och av den angivna längden.

En Azure Cosmos DB-systemfunktion som returnerar en del av en sträng med hjälp av en startposition och längd.

Syntax

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

Arguments

	Description
string_expr	Ett stränguttryck.
numeric_expr_1	Ett nollbaserat numeriskt uttryck som anger starttecknet. 0 Värdet refererar till det första tecknet.
numeric_expr_2	Ett numeriskt uttryck som anger det maximala antalet tecken string_expr som ska returneras.

Returtyper

Returnerar ett stränguttryck.

Examples

Det här avsnittet innehåller exempel på hur du använder den här frågespråkkonstruktionen.

Extrahera delsträngar från en sträng

I det här exemplet SUBSTRING används funktionen för att returnera delsträngar med olika längder och startpositioner.

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

Anmärkningar

• Den här funktionen använder nollbaserad indexering, vilket innebär 0 att refererar till det första tecknet i strängen.
• Om numeric_expr_2 (längden) är negativ returnerar funktionen en tom sträng.
• Om du vill returnera en delsträng till slutet av strängen LENGTH använder du funktionen för att beräkna återstående tecken (till exempel SUBSTRING(str, start, LENGTH(str) - start)).
• Den här funktionen drar nytta av användningen av ett intervallindex. Mer information finns i intervallindex.