Поделиться через


SUBSTRING — язык запросов в Cosmos DB (в Azure и Fabric)

Функция SUBSTRING возвращает часть строкового выражения, начиная с указанной позиции и указанной длины, или в конец строки.

Системная функция Azure Cosmos DB для NoSQL, которая возвращает часть строки с помощью начальной позиции и длины.

Синтаксис

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

Arguments

Description
string_expr Строковое выражение.
numeric_expr_1 Числовое выражение для обозначения начального символа.
numeric_expr_2 Числовое выражение, обозначаемое максимальное число возвращаемых символов string_expr .

Типы возвращаемых данных

Возвращает строковое выражение.

Примеры

В этом разделе содержатся примеры использования этой конструкции языка запросов.

Извлечение подстроек из строки

В этом примере SUBSTRING функция используется для возврата подстроок с различными длинами и начальными позициями.

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

Замечания