Релизы
Помощь

YMatrix

Начало работы

Развёртывание

Использование данных

Управление кластерами

Безопасность

Лучшие практики

Технические принципы

Расширенные функции

Графовая база данных

Руководство

SQL-команда

Часто задаваемые вопросы

Строковые функции

replace()

Функция replace() возвращает строку, в которой все вхождения указанной подстроки в исходной строке заменены другой (указанной) подстрокой.

Синтаксис: replace(original, search, replace)

Возвращаемое значение:

Строка типа agtype.

Параметры:

Имя Описание
original Выражение, вычисляющееся в строку.
search Выражение, вычисляющееся в подстроку, которую требуется найти и заменить в original.
replace Выражение, вычисляющееся в подстроку-замену.

Примечания:

  • Возвращает null, если любой из аргументов равен null.
  • Если search не найдена в original, возвращается original без изменений.

Запрос:

SELECT *
FROM cypher('graph_name', $$
        RETURN replace('hello', 'l', 'w')
$$) as (str_array agtype);

Результат:

new_str
"hewwo"
1 строка

split()

Функция split() возвращает список строк, полученный разбиением исходной строки по каждому вхождению заданного разделителя.

Синтаксис: split(original, split_delimiter)

Возвращаемое значение:

Список строк типа agtype.

Параметры:

Имя Описание
original Выражение, вычисляющееся в строку.
split_delimiter Строка, используемая для разбиения original.

Примечания:

  • split(null, split_delimiter) и split(original, null) оба возвращают null.

Запрос:

SELECT *
FROM cypher('graph_name', $$
    RETURN split('one,two', ',')
$$) as (split_list agtype);

Результат:

split_list
["one","two"]
1 строка

left()

Функция left() возвращает строку, содержащую n левых символов исходной строки.

Синтаксис: left(original, n)

Возвращаемое значение:

Строка типа agtype.

Параметры:

Имя Описание
original Выражение, вычисляющееся в строку.
n Выражение, вычисляющееся в положительное целое число.

Примечания:

  • left(null, n) и left(null, null) возвращают null.
  • left(original, null) вызывает ошибку.
  • Вызывает ошибку, если n не является положительным целым числом.
  • Если n превышает длину original, возвращается original без изменений.

Запрос:

SELECT *
FROM cypher('graph_name', $$
        RETURN left('Hello', 3)
$$) as (new_str agtype);

Результат:

new_str
"Hel"
1 строка

right()

Функция right() возвращает строку, содержащую n правых символов исходной строки.

Синтаксис: right(original, n)

Возвращаемое значение:

Строка типа agtype.

Параметры:

Имя Описание
original Выражение, вычисляющееся в строку.
n Выражение, вычисляющееся в положительное целое число.

Примечания:

  • right(null, n) и right(null, null) возвращают null.
  • right(original, null) вызывает ошибку.
  • Вызывает ошибку, если n не является положительным целым числом.
  • Если n превышает длину original, возвращается original без изменений.

Запрос:

SELECT *
FROM cypher('graph_name', $$
    RETURN right('hello', 3)
$$) as (new_str agtype);

Результат:

new_str
"llo"
1 строка

substring()

Функция substring() возвращает подстроку исходной строки, начиная с индекса start (отсчёт с нуля) и длиной length.

Синтаксис: substring(original, start [, length])

Возвращаемое значение:

Строка типа agtype.

Параметры:

Имя Описание
original Выражение, вычисляющееся в строку.
start Выражение, вычисляющееся в нулевой индекс начала подстроки.
length Необязательно. Выражение, вычисляющееся в положительное целое число — количество возвращаемых символов.

Примечания:

  • Индексация start начинается с нуля.
  • Если length опущено, функция возвращает подстроку от start до конца original.
  • Возвращает null, если original равен null.
  • Вызывает ошибку, если start или length равны null или отрицательны.
  • Если start равен 0, подстрока начинается с начала original.
  • Если length равен 0, возвращается пустая строка.

Запрос:

SELECT *
FROM cypher('graph_name', $$
    RETURN substring('hello', 1, 3), substring('hello', 2)
$$) as (sub_str1 agtype, sub_str2 agtype);

Результат:

sub_str1 sub_str2
"ell" "llo"
1 строка

rTrim()

Функция rTrim() возвращает исходную строку с удалёнными завершающими пробельными символами.

Синтаксис: rTrim(original)

Возвращаемое значение:

Строка типа agtype.

Параметры:

Имя Описание
original Выражение, вычисляющееся в строку.

Примечания:

  • rTrim(null) возвращает null.

Запрос:

SELECT *
FROM cypher('graph_name', $$
    RETURN rTrim(' hello ')
$$) as (right_trimmed_str agtype);

Результат:

right_trimmed_str
" hello"
1 строка

lTrim()

Функция lTrim() возвращает исходную строку с удалёнными начальными пробельными символами.

Синтаксис: lTrim(original)

Возвращаемое значение:

Строка типа agtype.

Параметры:

Имя Описание
original Выражение, вычисляющееся в строку.

Примечания:

  • lTrim(null) возвращает null.

Запрос:

SELECT *
FROM cypher('graph_name', $$
    RETURN lTrim(' hello ')
$$) as (left_trimmed_str agtype);

Результат:

left_trimmed_str
"hello "
1 строка

trim()

Функция trim() возвращает исходную строку с удалёнными начальными и завершающими пробельными символами.

Синтаксис: trim(original)

Возвращаемое значение:

Строка типа agtype.

Параметры:

Имя Описание
original Выражение, вычисляющееся в строку.

Примечания:

  • trim(null) возвращает null.

Запрос:

SELECT *
FROM cypher('graph_name', $$
    RETURN trim(' hello ')
$$) as (trimmed_str agtype);

Результат:

trimmed_str
"hello"
1 строка

toLower()

Функция toLower() возвращает исходную строку, преобразованную в нижний регистр.

Синтаксис: toLower(original)

Возвращаемое значение:

Строка типа agtype.

Параметры:

Имя Описание
original Выражение, вычисляющееся в строку.

Примечания:

  • toLower(null) возвращает null.

Запрос:

SELECT *
FROM cypher('graph_name', $$
    RETURN toLower('HELLO')
$$) as (lower_str agtype);

Результат:

lower_str
"hello"
1 строка

toUpper()

Функция toUpper() возвращает исходную строку, преобразованную в верхний регистр.

Синтаксис: toUpper(original)

Возвращаемое значение:

Строка типа agtype.

Параметры:

Имя Описание
original Выражение, вычисляющееся в строку.

Примечания:

  • toUpper(null) возвращает null.

Запрос:

SELECT *
FROM cypher('graph_name', $$
    RETURN toUpper('hello')
$$) as (upper_str agtype);

Результат:

upper_str
"HELLO"
1 строка

reverse()

Функция reverse() возвращает строку, в которой порядок всех символов исходной строки обращён.

Синтаксис: reverse(original)

Возвращаемое значение:

Строка типа agtype.

Параметры:

Имя Описание
original Выражение, вычисляющееся в строку.

Примечания:

  • reverse(null) возвращает null.

Запрос:

SELECT *
FROM cypher('graph_name', $$
    RETURN reverse("hello")
$$) as (reverse_str agtype);

Результат:

reverse_str
"olleh"
1 строка

toString()

Функция toString() преобразует целое число, число с плавающей точкой или булево значение в строку.

Синтаксис: toString(expression)

Возвращаемое значение:

Строка.

Параметры:

Имя Описание
expression Выражение, вычисляющееся в число, булево значение или строку.

Примечания:

  • toString(null) возвращает null.
  • Если expression уже является строкой, она возвращается без изменений.

Запрос:

SELECT *
FROM cypher('graph_name', $$
    RETURN toString(11.5), toString('a string'), toString(true)
$$) as (float_to_str agtype, str_to_str agtype, bool_to_string agtype);

Результат:

float_to_str str_to_str bool_to_str
"11.5" "a string" "true"
1 строка
← Предыдущая
Скалярные функции
Следующая →
Числовые функции