SUBSTRING – Dotazovací jazyk ve službě Cosmos DB (v Azure a prostředcích infrastruktury)

Funkce SUBSTRING vrátí část řetězcového výrazu začínající na zadané pozici a zadané délce.

Systémová funkce Azure Cosmos DB, která vrací část řetězce pomocí počáteční pozice a délky.

Syntaxe

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

Arguments

	Description
string_expr	Řetězcový výraz.
numeric_expr_1	Číselný výraz založený na nule, který označuje počáteční znak. Hodnota 0 odkazuje na první znak.
numeric_expr_2	Číselný výraz, který označuje maximální počet znaků, které string_expr mají být vráceny.

Návratové typy

Vrátí řetězcový výraz.

Examples

Tato část obsahuje příklady použití tohoto konstruktoru dotazovacího jazyka.

Extrahování podřetězců z řetězce

V tomto příkladu SUBSTRING se funkce používá k vrácení podřetězců s různými délkami a počátečními pozicemi.

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

Poznámky

• Tato funkce používá indexování založené na nule, což znamená 0 , že odkazuje na první znak v řetězci.
• Pokud numeric_expr_2 je hodnota (délka) záporná, vrátí funkce prázdný řetězec.
• Pokud chcete vrátit podřetězce na konec řetězce, použijte LENGTH funkci k výpočtu zbývajících znaků (například SUBSTRING(str, start, LENGTH(str) - start)).
• Tato funkce přináší výhody použití indexu rozsahu. Další informace najdete v tématu indexy rozsahu.