SUBSTRING - Lekérdezési nyelv a Cosmos DB-ben (az Azure-ban és a Fabricben)

A SUBSTRING függvény egy sztringkifejezés egy részét adja vissza a megadott pozíciótól és a megadott hossztól kezdve.

Egy Azure Cosmos DB rendszerfüggvény, amely egy sztring egy részét adja vissza kiindulási pozíció és hossz használatával.

Szemantika

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

Arguments

	Description
string_expr	Sztringkifejezés.
numeric_expr_1	Nulla alapú numerikus kifejezés, amely a kezdő karaktert jelöli. Az első karakter értéke 0 .
numeric_expr_2	Numerikus kifejezés, amely a visszaadandó karakterek string_expr maximális számát jelöli.

Visszatérési típusok

Sztringkifejezést ad vissza.

Példák

Ez a szakasz példákat tartalmaz a lekérdezési nyelv szerkezetének használatára.

Részsztringek kinyerése sztringből

Ebben a példában a függvény különböző SUBSTRING hosszúságú és kezdőpozíciójú részszúrások visszaadására szolgál.

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

Megjegyzések

• Ez a függvény nulla alapú indexelést használ, ami azt jelenti 0 , hogy a sztring első karakterére utal.
• Ha numeric_expr_2 a (hossz) negatív, a függvény üres sztringet ad vissza.
• A sztring végéhez tartozó részsztring visszaadásához használja a függvényt LENGTH a fennmaradó karakterek kiszámításához (például SUBSTRING(str, start, LENGTH(str) - start)).
• Ez a függvény egy tartományindex használatát használja. További információ: tartományindexek.