SUBSTRING — Język zapytań w usłudze Cosmos DB (na platformie Azure i w sieci szkieletowej)

Funkcja SUBSTRING zwraca część wyrażenia ciągu rozpoczynającą się od określonej pozycji i określonej długości lub na końcu ciągu.

Funkcja systemowa usługi Azure Cosmos DB for NoSQL, która zwraca część ciągu przy użyciu pozycji początkowej i długości.

Składnia

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

Arguments

	Description
string_expr	Wyrażenie ciągu.
numeric_expr_1	Wyrażenie liczbowe oznaczace znak początkowy.
numeric_expr_2	Wyrażenie liczbowe, które określa maksymalną liczbę znaków string_expr do zwrócenia.

Typy zwracane

Zwraca wyrażenie ciągu.

Przykłady

Ta sekcja zawiera przykłady użycia tej konstrukcji języka zapytań.

Wyodrębnianie podciągów z ciągu

W tym przykładzie SUBSTRING funkcja jest używana do zwracania podciągów o różnych długościach i pozycjach początkowych.

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

Uwagi

• Ta funkcja korzysta z użycia indeksu zakresu. Aby uzyskać więcej informacji, zobacz indeksy zakresu.