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 beginnt.

Eine Azure Cosmos DB-Systemfunktion, die einen Teil einer Zeichenfolge mithilfe einer Anfangsposition 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 nullbasierter numerischer Ausdruck, um das Startzeichen zu kennzeichnen. Ein Wert von 0 bezieht sich auf das erste Zeichen.
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 verwendet nullbasierte Indizierung, d 0 . h. verweist auf das erste Zeichen in der Zeichenfolge.
• Wenn numeric_expr_2 (Länge) negativ ist, gibt die Funktion eine leere Zeichenfolge zurück.
• Um eine Teilzeichenfolge an das Ende der Zeichenfolge zurückzugeben, verwenden Sie die LENGTH Funktion, um die verbleibenden Zeichen zu berechnen (z. B SUBSTRING(str, start, LENGTH(str) - start). ).
• Diese Funktion profitiert von der Verwendung eines Bereichsindex. Weitere Informationen finden Sie unter Bereichsindizes.