SUBSTRING - Abfragesprache in Cosmos DB (in Azure und Fabric)

Die SUBSTRING Funktion gibt einen Teil eines Zeichenfolgenausdrucks zurück, der an der angegebenen Position und der angegebenen Länge oder am Ende der Zeichenfolge beginnt.

Eine Azure Cosmos DB für NoSQL-Systemfunktion, die einen Teil einer Zeichenfolge mithilfe einer Startposition und Länge zurückgibt.

Syntax

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

Arguments

	Description
string_expr	Ein Zeichenfolgenausdruck.
numeric_expr_1	Ein numerischer Ausdruck, um das Startzeichen zu kennzeichnen.
numeric_expr_2	Ein numerischer Ausdruck, der die maximale Anzahl von Zeichen angibt, die string_expr zurückgegeben werden sollen.

Rückgabetypen

Gibt einen Zeichenfolgenausdruck zurück.

Examples

Dieser Abschnitt enthält Beispiele für die Verwendung dieses Abfragesprachenkonstrukts.

Extrahieren von Teilzeichenfolgen aus einer Zeichenfolge

In diesem Beispiel wird die SUBSTRING Funktion verwendet, um Teilzeichenfolgen mit verschiedenen Längen und Anfangspositionen zurückzugeben.

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

Bemerkungen

• Diese Funktion profitiert von der Verwendung eines Bereichsindex. Weitere Informationen finden Sie unter Bereichsindizes.