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

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

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

Синтаксис

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

Arguments

	Description
string_expr	Строковое выражение.
numeric_expr_1	Числовое выражение от нуля для обозначения начального символа. Значение 0 относится к первому символу.
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": ""
  }
]

Замечания

• Эта функция использует отсчитывание от нуля, то есть 0 ссылается на первый символ в строке.
• Если numeric_expr_2 (длина) отрицательная, функция возвращает пустую строку.
• Чтобы вернуть подстроку в конец строки, используйте LENGTH функцию для вычисления оставшихся символов (например, SUBSTRING(str, start, LENGTH(str) - start)).
• Эта функция использует индекс диапазона. Дополнительные сведения см. в разделе индексов диапазона.