Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Истории успеха
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • AI Studio
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Истории успеха
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Страница сервиса
Yandex DataLens
Документация
Yandex DataLens
    • Обзор
    • Синтаксис формул
      • Все функции
      • Поддержка функций
    • Параметры
  • Аудитные логи Audit Trails

В этой статье:

  • Остаток (%)
  • Умножение (*)
  • Сложение и конкатенация (+)
  • Вычитание (-)
  • Деление (/)
  • Сравнение
  • Степень (^)
  • CASE
  • IF
  • ABS
  • ACOS
  • AGO
  • ALL_CONCAT
  • AND
  • ANY
  • ARG_MAX
  • ARG_MIN
  • ARR_AVG
  • ARR_INTERSECT
  • ARR_MAX
  • ARR_MIN
  • ARR_PRODUCT
  • ARR_REMOVE
  • ARR_STR
  • ARR_SUM
  • ARRAY
  • ASCII
  • ASIN
  • AT_DATE
  • ATAN
  • ATAN2
  • AVG
  • AVG (оконная)
  • AVG_IF
  • AVG_IF (оконная)
  • BETWEEN
  • BOLD
  • BOOL
  • BR
  • CAST_ARR_FLOAT
  • CAST_ARR_INT
  • CAST_ARR_STR
  • CEILING
  • CHAR
  • COLOR
  • COMPARE
  • CONCAT
  • CONTAINS (массивы)
  • CONTAINS (строковая)
  • CONTAINS_ALL
  • CONTAINS_ANY
  • CONTAINS_SUBSEQUENCE
  • COS
  • COT
  • COUNT
  • COUNT (оконная)
  • COUNT_IF
  • COUNT_IF (оконная)
  • COUNT_ITEM
  • COUNTD
  • COUNTD_APPROX
  • COUNTD_IF
  • DATE
  • DATE_PARSE
  • DATEADD
  • DATEPART
  • DATETIME
  • DATETIME_PARSE
  • DATETRUNC
  • DAY
  • DAYOFWEEK
  • DB_CAST
  • DEGREES
  • DIV
  • DIV_SAFE
  • ENDSWITH
  • EXP
  • FDIV_SAFE
  • FIND
  • FIRST (оконная)
  • FLOAT
  • FLOOR
  • GEOPOINT
  • GEOPOLYGON
  • GET_ITEM
  • GREATEST
  • HOUR
  • ICONTAINS
  • IENDSWITH
  • IFNULL
  • IMAGE
  • IN
  • INT
  • IS FALSE
  • ISNULL
  • ISTARTSWITH
  • IS TRUE
  • ITALIC
  • LAG (оконная)
  • LAST (оконная)
  • LEAST
  • LEFT
  • LEN (массивы)
  • LEN
  • LIKE
  • LN
  • LOG
  • LOG10
  • LOWER
  • LTRIM
  • MARKUP
  • MAVG (оконная)
  • MAX
  • MAX (оконная)
  • MCOUNT (оконная)
  • MEDIAN
  • MIN
  • MIN (оконная)
  • MINUTE
  • MMAX (оконная)
  • MMIN (оконная)
  • MONTH
  • MSUM (оконная)
  • Отрицание (-)
  • NOT
  • NOW
  • OR
  • PI
  • POWER
  • QUANTILE
  • QUANTILE_APPROX
  • QUARTER
  • RADIANS
  • RANK (оконная)
  • RANK_DENSE (оконная)
  • RANK_PERCENTILE (оконная)
  • RANK_UNIQUE (оконная)
  • RAVG (оконная)
  • RCOUNT (оконная)
  • REGEXP_EXTRACT
  • REGEXP_EXTRACT_ALL
  • REGEXP_EXTRACT_NTH
  • REGEXP_MATCH
  • REGEXP_REPLACE
  • REPLACE (массивы)
  • REPLACE (строковая)
  • RIGHT
  • RMAX (оконная)
  • RMIN (оконная)
  • ROUND
  • RSUM (оконная)
  • RTRIM
  • SECOND
  • SIGN
  • SIN
  • SIZE
  • SLICE
  • SPACE
  • SPLIT
  • SQRT
  • SQUARE
  • STARTSWITH (массивы)
  • STARTSWITH (строковая)
  • STDEV
  • STDEVP
  • STR
  • SUBSTR
  • SUM
  • SUM (оконная)
  • SUM_IF
  • SUM_IF (оконная)
  • TAN
  • TODAY
  • TOOLTIP
  • TOP_CONCAT
  • TREE
  • TRIM
  • UNNEST
  • UPPER
  • URL
  • USER_INFO
  • UTF8
  • VAR
  • VARP
  • WEEK
  • YEAR
  • ZN
  1. Вычисляемые поля
  2. Справочник функций
  3. Все функции

Все функции

Статья создана
Yandex Cloud
Улучшена
amatol
Обновлена 17 апреля 2025 г.
  • Остаток (%)
  • Умножение (*)
  • Сложение и конкатенация (+)
  • Вычитание (-)
  • Деление (/)
  • Сравнение
  • Степень (^)
  • CASE
  • IF
  • ABS
  • ACOS
  • AGO
  • ALL_CONCAT
  • AND
  • ANY
  • ARG_MAX
  • ARG_MIN
  • ARR_AVG
  • ARR_INTERSECT
  • ARR_MAX
  • ARR_MIN
  • ARR_PRODUCT
  • ARR_REMOVE
  • ARR_STR
  • ARR_SUM
  • ARRAY
  • ASCII
  • ASIN
  • AT_DATE
  • ATAN
  • ATAN2
  • AVG
  • AVG (оконная)
  • AVG_IF
  • AVG_IF (оконная)
  • BETWEEN
  • BOLD
  • BOOL
  • BR
  • CAST_ARR_FLOAT
  • CAST_ARR_INT
  • CAST_ARR_STR
  • CEILING
  • CHAR
  • COLOR
  • COMPARE
  • CONCAT
  • CONTAINS (массивы)
  • CONTAINS (строковая)
  • CONTAINS_ALL
  • CONTAINS_ANY
  • CONTAINS_SUBSEQUENCE
  • COS
  • COT
  • COUNT
  • COUNT (оконная)
  • COUNT_IF
  • COUNT_IF (оконная)
  • COUNT_ITEM
  • COUNTD
  • COUNTD_APPROX
  • COUNTD_IF
  • DATE
  • DATE_PARSE
  • DATEADD
  • DATEPART
  • DATETIME
  • DATETIME_PARSE
  • DATETRUNC
  • DAY
  • DAYOFWEEK
  • DB_CAST
  • DEGREES
  • DIV
  • DIV_SAFE
  • ENDSWITH
  • EXP
  • FDIV_SAFE
  • FIND
  • FIRST (оконная)
  • FLOAT
  • FLOOR
  • GEOPOINT
  • GEOPOLYGON
  • GET_ITEM
  • GREATEST
  • HOUR
  • ICONTAINS
  • IENDSWITH
  • IFNULL
  • IMAGE
  • IN
  • INT
  • IS FALSE
  • ISNULL
  • ISTARTSWITH
  • IS TRUE
  • ITALIC
  • LAG (оконная)
  • LAST (оконная)
  • LEAST
  • LEFT
  • LEN (массивы)
  • LEN
  • LIKE
  • LN
  • LOG
  • LOG10
  • LOWER
  • LTRIM
  • MARKUP
  • MAVG (оконная)
  • MAX
  • MAX (оконная)
  • MCOUNT (оконная)
  • MEDIAN
  • MIN
  • MIN (оконная)
  • MINUTE
  • MMAX (оконная)
  • MMIN (оконная)
  • MONTH
  • MSUM (оконная)
  • Отрицание (-)
  • NOT
  • NOW
  • OR
  • PI
  • POWER
  • QUANTILE
  • QUANTILE_APPROX
  • QUARTER
  • RADIANS
  • RANK (оконная)
  • RANK_DENSE (оконная)
  • RANK_PERCENTILE (оконная)
  • RANK_UNIQUE (оконная)
  • RAVG (оконная)
  • RCOUNT (оконная)
  • REGEXP_EXTRACT
  • REGEXP_EXTRACT_ALL
  • REGEXP_EXTRACT_NTH
  • REGEXP_MATCH
  • REGEXP_REPLACE
  • REPLACE (массивы)
  • REPLACE (строковая)
  • RIGHT
  • RMAX (оконная)
  • RMIN (оконная)
  • ROUND
  • RSUM (оконная)
  • RTRIM
  • SECOND
  • SIGN
  • SIN
  • SIZE
  • SLICE
  • SPACE
  • SPLIT
  • SQRT
  • SQUARE
  • STARTSWITH (массивы)
  • STARTSWITH (строковая)
  • STDEV
  • STDEVP
  • STR
  • SUBSTR
  • SUM
  • SUM (оконная)
  • SUM_IF
  • SUM_IF (оконная)
  • TAN
  • TODAY
  • TOOLTIP
  • TOP_CONCAT
  • TREE
  • TRIM
  • UNNEST
  • UPPER
  • URL
  • USER_INFO
  • UTF8
  • VAR
  • VARP
  • WEEK
  • YEAR
  • ZN

Остаток (%)Остаток (%)

Синтаксис:number_1 % number_2

Возвращает остаток от деления первого числа number_1 на число number_2.

Умножение (*)Умножение (*)

Синтаксис:value_1 * value_2

Если оба аргумента — числа, то возвращает результат умножения числа value_1 на число value_2.

Если один из аргументов — Строка, а другой — Целое число, возвращает строку, повторенную заданное количество раз.

Сложение и конкатенация (+)Сложение и конкатенация (+)

Синтаксис:value_1 + value_2

Имеет различное поведение в зависимости от типов аргументов. Возможные варианты приведены в таблице:

Тип value_1 Тип value_2 Возвращаемое значение
Дробное число | Целое число Дробное число | Целое число Сумма чисел value_1 и value_2.
Дата Дробное число | Целое число Дата, на value_2 дней большая, чем value_1 (с округлением вниз до целого количества дней).
Дата и время Дробное число | Целое число Дата со временем, на value_2 дней большая, чем value_1. Если value_2 содержит дробную часть, то она пересчитывается в часы (1/24), минуты (1/1440) и секунды (1/86400).
Строка Строка Объединение (конкатенация) строк value_1 и value_2.
Массив дробных чисел | Массив целых чисел | Массив строк Массив дробных чисел | Массив целых чисел | Массив строк Объединение (конкатенация) массивов value_1 и value_2.

Изменение порядка аргументов не влияет на результат.

Вычитание (-)Вычитание (-)

Синтаксис:value_1 - value_2

Имеет различное поведение в зависимости от типов аргументов. Возможные варианты приведены в таблице:

Тип value_1 Тип value_2 Возвращаемое значение
Дробное число | Целое число Дробное число | Целое число Разность чисел value_1 и value_2.
Дата Дробное число | Целое число Дата, на value_2 дней меньшая, чем value_1 (с округлением вниз до целого количества дней).
Дата и время Дробное число | Целое число Дата со временем, на value_2 дней меньшая, чем value_1. Если value_2 содержит дробную часть, то она пересчитывается в часы (1/24), минуты (1/1440) и секунды (1/86400).
Дата Дата Разность двух дат в днях.
Любой Любой Разность двух дат в днях: целая часть — количество целых дней, дробная — количество часов, минут и секунд как долей целого дня (час — 1/24 и т.д.).
Дата и время Дата и время Разность двух дат в днях: целая часть — количество целых дней, дробная — количество часов, минут и секунд как долей целого дня (час — 1/24 и т.д.).

Деление (/)Деление (/)

Синтаксис:number_1 / number_2

Делит число number_1 на число number_2.

СравнениеСравнение

Синтаксис:
value_1 = value_2
или
value_1 != value_2
или
value_1 < value_2
или
value_1 <= value_2
или
value_1 > value_2
или
value_1 >= value_2

Сравнивают значение value_1 со значением value_2.

Степень (^)Степень (^)

Синтаксис:base ^ power

Возводит число base в степень power.

CASECASE

Синтаксис:
CASE expression WHEN value_1 THEN result_1 [ WHEN value_2 THEN result_2 ... ] ELSE default_result END
или
CASE( expression, value_1, result_1, [ value_2, result_2, ... ] default_result )

Сравнивает выражение expression с последовательностью значений value_1, value_2, ... и возвращает результат для первого совпадения.
Если совпадений не найдено, то возвращает default_result.

IFIF

Синтаксис:
IF condition_1 THEN result_1 [ ELSEIF condition_2 THEN result_2 ... ] ELSE default_result END
или
IF( condition_1, result_1, [ condition_2, result_2, ... ] default_result )

Проверяет последовательно логические выражения condition_1, condition_2, ... и возвращает соответствующий результат для первого выполнения.
Если все condition_1, condition_2, ... возвращают FALSE, то блок возвращает default_result. Проверяемые выражения задаются с помощью логических операторов.

ABSABS

Синтаксис:ABS( number )

Возвращает абсолютное значение заданного числа number.

ACOSACOS

Синтаксис:ACOS( number )

Возвращает выраженный в радианах арккосинус числа number.

AGOAGO

Синтаксис:
AGO( measure, date_dimension [ , unit [ , number ] ] )
или
AGO( measure, date_dimension [ , unit [ , number ] ] [ BEFORE FILTER BY ... ] [ IGNORE DIMENSIONS ... ] )

Вычисляет значение показателя measure для даты/времени с указанным смещением.
Аргумент date_dimension задает измерение, вдоль которого делается смещение.
Аргумент number задает размер смещения в единицах аргумента unit. Задается целым числом. Может принимать отрицательные значения. Значение по умолчанию равно 1.
Аргумент unit задает единицу измерения для number. Принимает следующие значения:

  • "year" — год;
  • "month" — месяц;
  • "week" — неделя;
  • "day" — день (значение по умолчанию);
  • "hour" — час;
  • "minute" — минута;
  • "second" — секунда.

Возможен вариант использования AGO( measure, date_dimension, number ). В этом случае аргумент unit принимает значение "day".

См. также AT_DATE, LAG.

ALL_CONCATALL_CONCAT

Синтаксис:
ALL_CONCAT( expression [ , separator ] )
или
ALL_CONCAT( expression [ , separator ] [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает строку, которая содержит все уникальные значения expression, разделенные separator (по умолчанию разделитель — запятая).

ANDAND

Синтаксис:value_1 AND value_2

Выполняет логическое соединение двух выражений по условию И.

ANYANY

Синтаксис:
ANY( value )
или
ANY( value [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает произвольное значение value из группы. Это недетерминированная агрегация — результат может различаться от запроса к запросу на одних и тех же входных данных.

ARG_MAXARG_MAX

Синтаксис:
ARG_MAX( value, expression_to_maximize )
или
ARG_MAX( value, expression_to_maximize [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает значение value, соответствующее максимальному значению expression_to_maximize. Если есть несколько значений value, соответствующих максимальному значению expression_to_maximize, то возвращает первое попавшееся из них. Это делает функцию недетерминированной.

ARG_MINARG_MIN

Синтаксис:
ARG_MIN( value, expression_to_minimize )
или
ARG_MIN( value, expression_to_minimize [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает значение value, соответствующее минимальному значению expression_to_minimize. Если есть несколько значений value, соответствующих минимальному значению expression_to_minimize, то возвращает первое попавшееся из них. Это делает функцию недетерминированной.

ARR_AVGARR_AVG

Синтаксис:ARR_AVG( array )

Возвращает среднее значение элементов в массиве array.

ARR_INTERSECTARR_INTERSECT

Синтаксис:ARR_INTERSECT( array_1, array_2, array_3 [ , ... ] )

Возвращает массив элементов, которые встречаются в каждом из переданных в качестве аргументов массивов. В массиве с результатом работы функции элементы расположены в произвольном порядке. Повторяющиеся элементы добавляются только в одном экземпляре.

ARR_MAXARR_MAX

Синтаксис:ARR_MAX( array )

Возвращает значение максимального элемента в массиве array.

ARR_MINARR_MIN

Синтаксис:ARR_MIN( array )

Возвращает значение минимального элемента в массиве array.

ARR_PRODUCTARR_PRODUCT

Синтаксис:ARR_PRODUCT( array )

Возвращает произведение элементов массива array.

ARR_REMOVEARR_REMOVE

Синтаксис:ARR_REMOVE( array, value )

Удаляет из массива array все элементы, равные value.

ARR_STRARR_STR

Синтаксис:ARR_STR( array [ , delimiter [ , null_str ] ] )

Из элементов массива array формирует строку, используя delimiter в качестве разделителя (запятая по умолчанию) и null_str в качестве строки, подставляемой вместо NULL (по умолчанию такие элементы пропускаются и в результат не попадают).

См. также STR

ARR_SUMARR_SUM

Синтаксис:ARR_SUM( array )

Возвращает сумму элементов в массиве array.

ARRAYARRAY

Синтаксис:ARRAY( value_1, value_2, value_3 [ , ... ] )

Возвращает массив, содержащий переданные элементы.

ASCIIASCII

Синтаксис:ASCII( string )

Возвращает числовое представление первого символа строки.

ASINASIN

Синтаксис:ASIN( number )

Возвращает выраженный в радианах арксинус числа number.

AT_DATEAT_DATE

Синтаксис:
AT_DATE( measure, date_dimension, date_expr )
или
AT_DATE( measure, date_dimension, date_expr [ BEFORE FILTER BY ... ] [ IGNORE DIMENSIONS ... ] )

Вычисляет measure для даты/времени, заданных выражением date_expr. Позволяет получить показатель на начало или конец периода, или на конкретную дату.
Аргумент date_dimension задает измерение, вдоль которого делается смещение.

В качестве аргумента date_expr можно использовать:

  • конкретную дату;
  • функцию получения текущей даты TODAY;
  • функции для вычисления даты и времени.

См. также AGO, LAG.

ATANATAN

Синтаксис:ATAN( number )

Возвращает выраженный в радианах арктангенс числа number.

ATAN2ATAN2

Синтаксис:ATAN2( x, y )

Возвращает выраженный в радианах арктангенс для заданных координат x и y.

AVGAVG

Синтаксис:
AVG( value )
или
AVG( value [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает среднее для всех значений. Работает с числовыми типами данных и с типами Дата.

AVG (оконная)AVG (оконная)

Синтаксис:
AVG( value TOTAL | WITHIN ... | AMONG ... )
или
AVG( value TOTAL | WITHIN ... | AMONG ... [ BEFORE FILTER BY ... ] )

Возвращает среднее арифметическое значений выражения. Работает только с числовыми типами данных.

AVG_IFAVG_IF

Синтаксис:
AVG_IF( expression, condition )
или
AVG_IF( expression, condition [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает среднее для всех значений, которые удовлетворяют условию condition. Если значения отсутствуют, то возвращается NULL. Работает только с числовыми типами данных.

AVG_IF (оконная)AVG_IF (оконная)

Синтаксис:
AVG_IF( expression, condition TOTAL | WITHIN ... | AMONG ... )
или
AVG_IF( expression, condition TOTAL | WITHIN ... | AMONG ... [ BEFORE FILTER BY ... ] )

Возвращает среднее для всех значений, которые удовлетворяют условию condition. Если значения отсутствуют, то возвращается NULL. Работает только с числовыми типами данных.

BETWEENBETWEEN

Синтаксис:value [ NOT ] BETWEEN low AND high

Возвращает TRUE, если value принадлежит диапазону значений с low по high включительно.

Вариант value NOT BETWEEN low AND high возвращает противоположное значение

BOLDBOLD

Синтаксис:BOLD( text )

Выделяет переданный текст жирным шрифтом.

BOOLBOOL

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

Переводит выражение expression в логический тип по следующим правилам:

Тип FALSE TRUE
Дробное число | Целое число 0, 0.0 Все остальные
Строка Пустая строка ("") Все остальные
Логический FALSE TRUE
Дата | Дата и время - TRUE

BRBR

Синтаксис:BR()

Добавляет перенос строки.

CAST_ARR_FLOATCAST_ARR_FLOAT

Синтаксис:CAST_ARR_FLOAT( array )

Приводит массив array к массиву дробных значений. Правила преобразования аналогичны функции FLOAT.

CAST_ARR_INTCAST_ARR_INT

Синтаксис:CAST_ARR_INT( array )

Приводит массив array к массиву целых чисел. Правила преобразования аналогичны функции INT.

CAST_ARR_STRCAST_ARR_STR

Синтаксис:CAST_ARR_STR( array )

Приводит массив array к массиву строк. Правила преобразования аналогичны функции STR.

CEILINGCEILING

Синтаксис:CEILING( number )

Округляет значение до ближайшего целого числа в большую сторону.

CHARCHAR

Синтаксис:CHAR( string )

Преобразовывает числовое представление символа ASCII в значение.

COLORCOLOR

Синтаксис:COLOR( text, color )

Позволяет указать цвет для переданного текста.

Рекомендуем использовать для указания цветов переменные из палитры дизайн-системы Gravity UI. Эти цвета будут хорошо различимы как в светлой, так и в темной теме.

Также цвет можно указать в любом формате представления веб-цвета: HEX, ключевым словом (например, green), RGB и т. д. Но в этом случае мы не гарантируем различимость цветов.

COMPARECOMPARE

Синтаксис:COMPARE( left, right, epsilon )

Возвращает:

  • 0, если left и right отличаются не более чем на epsilon.
  • -1, если left меньше right более чем на epsilon.
  • 1, если left больше right более чем на epsilon.

CONCATCONCAT

Синтаксис:CONCAT( arg_1, arg_2, arg_3 [ , ... ] )

Объединяет произвольное количество строк. При использовании нестроковых типов происходит преобразование в строку и объединение.

CONTAINS (массивы)CONTAINS (массивы)

Синтаксис:CONTAINS( array, value )

Возвращает TRUE, если array содержит value.

CONTAINS (строковая)CONTAINS (строковая)

Синтаксис:CONTAINS( string, substring )

Возвращает TRUE, если строка string содержит в себе подстроку substring. Для регистронезависимой проверки см. ICONTAINS.

CONTAINS_ALLCONTAINS_ALL

Синтаксис:CONTAINS_ALL( array_1, array_2 )

Возвращает TRUE, если array_1 содержит все элементы array_2.

CONTAINS_ANYCONTAINS_ANY

Синтаксис:CONTAINS_ANY( array_1, array_2 )

Возвращает TRUE, если array_1 содержит хотя бы один элемент из array_2.

CONTAINS_SUBSEQUENCECONTAINS_SUBSEQUENCE

Синтаксис:CONTAINS_SUBSEQUENCE( array_1, array_2 )

Возвращает TRUE, если array_2 является непрерывной подпоследовательностью array_1. Другими словами, возвращает TRUE исключительно если array1 = prefix + array2 + suffix.

COSCOS

Синтаксис:COS( number )

Возвращает косинус числа number, заданного в радианах.

COTCOT

Синтаксис:COT( number )

Возвращает котангенс числа number, заданного в радианах.

COUNTCOUNT

Синтаксис:
COUNT( [ value ] )
или
COUNT( [ value ] [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает количество элементов в группе.

Функцию можно использовать с константами, например, COUNT(1) или COUNT(). Если в чарте не используются другие показатели и измерения, результатом такого выражения всегда будет значение 1. Это происходит из-за того, что в функции не указано ни одного поля, поэтому DataLens в запросе не обращается ни к одной таблице источника.

COUNT (оконная)COUNT (оконная)

Синтаксис:
COUNT( [ value ] TOTAL | WITHIN ... | AMONG ... )
или
COUNT( [ value ] TOTAL | WITHIN ... | AMONG ... [ BEFORE FILTER BY ... ] )

Возвращает количество элементов в заданном окне.

COUNT_IFCOUNT_IF

Синтаксис:
COUNT_IF( condition )
или
COUNT_IF( condition [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает количество элементов в группе, которые удовлетворяют условию condition.

COUNT_IF (оконная)COUNT_IF (оконная)

Синтаксис:
COUNT_IF( expression, condition TOTAL | WITHIN ... | AMONG ... )
или
COUNT_IF( expression, condition TOTAL | WITHIN ... | AMONG ... [ BEFORE FILTER BY ... ] )

Возвращает количество элементов в заданном окне, которые удовлетворяют условию expression.

COUNT_ITEMCOUNT_ITEM

Синтаксис:COUNT_ITEM( array, value )

Возвращает количество элементов массива array, равных value. Тип value должен соответствовать типу элементов array.

COUNTDCOUNTD

Синтаксис:
COUNTD( value )
или
COUNTD( value [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает количество уникальных значений в группе.

См. также COUNTD_APPROX.

COUNTD_APPROXCOUNTD_APPROX

Синтаксис:
COUNTD_APPROX( value )
или
COUNTD_APPROX( value [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает приблизительное количество уникальных значений в группе. Работает быстрее функции COUNTD, но не гарантирует точность.

COUNTD_IFCOUNTD_IF

Синтаксис:
COUNTD_IF( expression, condition )
или
COUNTD_IF( expression, condition [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает количество уникальных значений в группе, которые удовлетворяют условию condition.

См. также COUNTD_APPROX.

DATEDATE

Синтаксис:DATE( expression [ , timezone ] )

Переводит выражение expression в формат даты.

Дата должна быть определена в формате YYYY-MM-DD.

Если expression является числом, то при наличии дополнительного параметра timezone дата рассчитывается для указанной временной зоны.

DATE_PARSEDATE_PARSE

Синтаксис:DATE_PARSE( value )

Переводит выражение value в формат даты. В отличие от DATE, поддерживает множество форматов.

DATEADDDATEADD

Синтаксис:DATEADD( datetime [ , unit [ , number ] ] )

Возвращает дату, полученную в результате добавления unit в количестве number к указанной дате datetime.

Аргумент number задается целым числом. Может принимать отрицательные значения.
Аргумент unit принимает следующие значения:

  • "year" — год;
  • "month" — месяц;
  • "day" — день;
  • "hour" — час;
  • "minute" — минута;
  • "second" — секунда.

DATEPARTDATEPART

Синтаксис:DATEPART( datetime, unit [ , firstday ] )

Возвращает часть даты в виде целого числа.

В зависимости от аргумента unit возвращает следующие значения:

  • "year" — номер года (см. YEAR);
  • "quarter" — номер квартала года (от 1 до 4) (см. QUARTER);
  • "month" — номер месяца в году (см. MONTH);
  • "week" — номер недели в году по ISO 8601 (см. WEEK);
  • "dayofweek", "dow" — номер дня недели (см. DAYOFWEEK);
  • "day" — номер дня в месяце (см. DAY);
  • "hour" — номер часа в дне (см. HOUR);
  • "minute" — номер минуты в часе (см. MINUTE);
  • "second" — номер секунды в минуте (см. SECOND).

Если выбран "dayofweek", то дополнительным параметром firstday можно задать, какой день недели считать первым — по умолчанию это понедельник. Более подробно об этом параметре смотрите в описании функции DAYOFWEEK.

DATETIMEDATETIME

Синтаксис:DATETIME( expression [ , timezone ] )

Переводит выражение expression в формат даты и времени. При переводе Date в DateTime время определяется, как 00:00:00.
Дата должна быть определена в формате YYYY-MM-DDThh:mm:ss или YYYY-MM-DD hh:mm:ss.
Числовые значения воспринимаются как время в формате Unix time и равны количеству секунд, прошедших с 00:00:00 1 января 1970 года, за вычетом поправок, сделанных из-за високосных секунд.

При наличии дополнительного параметра timezone дата и время рассчитываются для указанной временной зоны. Параметр timezone должен быть определен в формате Region/Data_Zone.

DATETIME_PARSEDATETIME_PARSE

Синтаксис:DATETIME_PARSE( value )

Переводит выражение value в формат даты и времени. В отличие от DATETIME, поддерживает множество форматов. Обработка выражения происходит на стороне источника ClickHouse®. Подробнее о поддерживаемых форматах читайте в документации ClickHouse®.

DATETRUNCDATETRUNC

Синтаксис:DATETRUNC( datetime, unit [ , number ] )

Возвращает дату, округленную по аргументу unit.

Если задан аргумент number, то происходит округление до этого количества временных единиц. Отсутствие аргумента эквивалентно значению 1.

Поддерживаемые значения unit:

  • "second";
  • "minute";
  • "hour";
  • "day" (при заданном number используется номер дня в году);
  • "week";
  • "month";
  • "quarter";
  • "year".

При использовании функции с тремя аргументами, она обрабатывается на стороне ClickHouse® функцией toStartOfInterval. Округление выполняется относительно определенного момента времени в соответствии с приведенной в описании функции таблицей. Например:

DATETRUNC(#2018-07-12 11:07:13#, "month", 4) = #2018-05-01 00:00:00#

Для аргумента unit со значением month округление считается от даты 1900-01-01. Между датами 2018-07-12 и 1900-01-01 прошло 1422 месяца. Если округлить это число до ближайшего числа, которое делится на 4 (аргумент number), то получится 1420 месяцев. Таким образом, если к дате 1900-01-01 прибавить 1420 месяцев, то получится значение 2018-05-01.

DAYDAY

Синтаксис:DAY( datetime )

Возвращает номер дня в месяце в указанной дате datetime.

DAYOFWEEKDAYOFWEEK

Синтаксис:DAYOFWEEK( datetime [ , firstday ] )

Возвращает день недели в соответствии с ISO 8601.

  • Понедельник — 1;
  • Воскресенье — 7.

Если указан дополнительный параметр firstday, то этот день считается первым в неделе. Допустимые значения:

  • "Monday", "Mon" — понедельник;
  • "Tuesday", "Tue" — вторник;
  • "Wednesday", "Wed" — среда;
  • "Thursday", "Thu" — четверг;
  • "Friday", "Fri" — пятница;
  • "Saturday", "Sat" — суббота;
  • "Sunday", "Sun" — воскресенье.

DB_CASTDB_CAST

Синтаксис:DB_CAST( expression, native_type [ , param_1 [ , param_2 ] ] )

Переводит выражение expression в указанный нативный тип данных native_type.

Поддерживаются следующие типы:

Источник данных Тип данных Нативный тип Параметры нативного типа Комментарий
ClickHouse Дата Date
ClickHouse Дата Date32
ClickHouse Дробное число Float32
ClickHouse Дробное число Float64
ClickHouse Дробное число Decimal Целое число, Целое число
ClickHouse Целое число Int8
ClickHouse Целое число Int16
ClickHouse Целое число Int32
ClickHouse Целое число Int64
ClickHouse Целое число UInt8
ClickHouse Целое число UInt16
ClickHouse Целое число UInt32
ClickHouse Целое число UInt64
ClickHouse Строка String
PostgreSQL Массив дробных чисел double precision[]
PostgreSQL Массив дробных чисел real[]
PostgreSQL Массив дробных чисел numeric[] Целое число, Целое число
PostgreSQL Массив целых чисел smallint[]
PostgreSQL Массив целых чисел integer[]
PostgreSQL Массив целых чисел bigint[]
PostgreSQL Массив строк text[]
PostgreSQL Массив строк character varying[]
PostgreSQL Массив строк varchar[]
PostgreSQL Дробное число double precision
PostgreSQL Дробное число real
PostgreSQL Дробное число numeric Целое число, Целое число
PostgreSQL Целое число smallint
PostgreSQL Целое число integer
PostgreSQL Целое число bigint
PostgreSQL Строка text
PostgreSQL Строка character Целое число Алиас: char
PostgreSQL Строка character varying Целое число Алиас: varchar
PostgreSQL Строка char Целое число Алиас для character
PostgreSQL Строка varchar Целое число Алиас для character varying

DEGREESDEGREES

Синтаксис:DEGREES( radians )

Преобразует радианы в градусы.

DIVDIV

Синтаксис:DIV( number_1, number_2 )

Возвращает результат деления number_1 на number_2.
Результат будет округлен до целого числа.

DIV_SAFEDIV_SAFE

Синтаксис:DIV_SAFE( numerator, denominator [ , fallback_value ] )

Возвращает результат деления numerator на denominator. В случае деления на ноль возвращает fallback_value. Если число fallback_value не указано, возвращает NULL.
Результат будет округлен до целого числа.

ENDSWITHENDSWITH

Синтаксис:ENDSWITH( string, substring )

Возвращает TRUE, если строка string оканчивается на подстроку substring.Для регистронезависимой проверки см. IENDSWITH.

EXPEXP

Синтаксис:EXP( number )

Возвращает результата возведения числа e в степень number.

FDIV_SAFEFDIV_SAFE

Синтаксис:FDIV_SAFE( numerator, denominator [ , fallback_value ] )

Возвращает результат деления numerator на denominator. В случае деления на ноль возвращает fallback_value. Если число fallback_value не указано, возвращает NULL.

FINDFIND

Синтаксис:FIND( string, substring [ , start_index ] )

Возвращает индекс позиции первого символа подстроки substring в строке string.

Если указан опциональный параметр start_index, то поиск начнется с указанной позиции.

FIRST (оконная)FIRST (оконная)

Синтаксис:
FIRST( value )
или
FIRST( value [ TOTAL | WITHIN ... | AMONG ... ] [ ORDER BY ... ] [ BEFORE FILTER BY ... ] )

Возвращает значение value из первой строки заданного окна. См. также LAST.

FLOATFLOAT

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

Переводит выражение expression в формат дробного числа по следующим правилам:

Тип Значение
Дробное число | Целое число Исходное значение.
Дата | Дата и время Unix-время соответствующее дате и времени. Если значение содержит в себе информацию о временной зоне, то она учитывается при вычислении. Если же временная зона неизвестна, то время считается UTC.
Строка Число из строки в десятичной записи.
Логический TRUE — 1.0, FALSE — 0.0.

FLOORFLOOR

Синтаксис:FLOOR( number )

Округляет значение до ближайшего целого числа в меньшую сторону.

GEOPOINTGEOPOINT

Синтаксис:GEOPOINT( value_1 [ , value_2 ] )

Формирует значение типа геоточка. Принимает на вход строку, либо значение типа "геоточка", либо координаты — широту value_1 и долготу value_2. Если на вход подается одна строка, в ней должен содержаться список из двух чисел, координат (широты и долготы) в JSON-синтаксисе.

GEOPOLYGONGEOPOLYGON

Синтаксис:GEOPOLYGON( value )

Переводит выражение value в формат геополигона. Функция принимает на вход строку вида [[[lat_1,lon_1], [lat_2,lon_2], ..., [lat_N-1,lon_N-1], [lat_N,lon_N]]].

GET_ITEMGET_ITEM

Синтаксис:GET_ITEM( array, index )

Возвращает элемент с индексом index из массива array. Индекс должен быть целым числом. Индексы в массиве начинаются с единицы. Возвращает последний элемент из массива, если значение index равно -1.

GREATESTGREATEST

Синтаксис:GREATEST( value_1, value_2, value_3 [ , ... ] )

Возвращает наибольшее из значений.

См. также LEAST.

В зависимости от указанного типа данных, возвращает:

  • наибольшее число;
  • последнюю строку в алфавитном порядке;
  • позднюю дату;
  • TRUE при выборе из TRUE и FALSE для логического типа.

HOURHOUR

Синтаксис:HOUR( datetime )

Возвращает номер часа в дне в указанной дате и времени datetime. При указании даты без времени возвращает 0.

ICONTAINSICONTAINS

Синтаксис:ICONTAINS( string, substring )

Регистронезависимый вариант CONTAINS. Возвращает TRUE, если строка string содержит в себе подстроку substring.

IENDSWITHIENDSWITH

Синтаксис:IENDSWITH( string, substring )

Регистронезависимый вариант ENDSWITH. Возвращает TRUE, если строка string оканчивается на подстроку substring.

IFNULLIFNULL

Синтаксис:IFNULL( check_value, alt_value )

Возвращает check_value, если оно не NULL. В противном случае возвращает alt_value.

IMAGEIMAGE

Синтаксис:IMAGE( src [ , width [ , height [ , alt ] ] ] )

Позволяет вставить в таблицу изображение, расположенное по адресу src. Ширина (width) и высота (height) изображения указываются в пикселях. Если для одного из размеров указано значение NULL, он рассчитывается автоматически пропорционально размеру другой стороны. Если для обоих размеров указано значение NULL, изображение вставляется с исходными размерами. В случае проблем с загрузкой изображения функция выводит альтернативный текст alt.

Допускается добавление изображений с доменов *.yandex.ru, *.yandex.net, yastat.net, yastatic.net или storage.yandexcloud.net. Самый простой способ — загрузить и опубликовать изображение в Yandex Object Storage (ознакомьтесь с правилами тарификации сервиса).

ININ

Синтаксис:item [ NOT ] IN (<list>)

Проверяет условие соответствия значения хотя бы одному из значений, перечисленных в IN(...).

Вариант item NOT IN (<list>) возвращает противоположное значение

INTINT

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

Переводит выражение expression в формат целого числа по следующим правилам:

Тип Значение
Целое число Исходное значение.
Дробное число Целая часть числа (округление вниз).
Дата | Дата и время Unix-время соответствующее дате и времени. Если значение содержит в себе информацию о временной зоне, то она учитывается при вычислении. Если же временная зона неизвестна, то время считается UTC.
Строка Число из строки в десятичной записи.
Логический TRUE — 1, FALSE — 0.

IS FALSEIS FALSE

Синтаксис:value IS [ NOT ] FALSE

Проверяет, является ли значение value ложным (FALSE).

Вариант value IS NOT FALSE возвращает противоположное значение.

ISNULLISNULL

Синтаксис:
ISNULL( expression )
или
expression IS [ NOT ] NULL

Возвращает TRUE, если expression является NULL. В противном случае возвращает FALSE.

Вариант expression IS NOT NULL возвращает противоположное значение.

ISTARTSWITHISTARTSWITH

Синтаксис:ISTARTSWITH( string, substring )

Регистронезависимый вариант STARTSWITH. Возвращает TRUE, если строка string начинается на подстроку substring.

IS TRUEIS TRUE

Синтаксис:value IS [ NOT ] TRUE

Проверяет, является ли значение value истинным (TRUE).

Вариант value IS NOT TRUE возвращает противоположное значение.

ITALICITALIC

Синтаксис:ITALIC( text )

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

LAG (оконная)LAG (оконная)

Синтаксис:
LAG( value [ , offset [ , default ] ] )
или
LAG( value [ , offset [ , default ] ] [ TOTAL | WITHIN ... | AMONG ... ] [ ORDER BY ... ] [ BEFORE FILTER BY ... ] )

Возвращает значение value из строки со смещением offset относительно текущей в рамках заданного окна:

  • положительное значение offset делает смещение назад;
  • отрицательное значение offset делает смещение вперед.

По умолчанию offset равно 1.

Если значение отсутствует (offset ссылается на строку до первой или после последней), то возвращается значение default в качестве результата. Если default не задано, то используется NULL.

См. также AGO в качестве неоконной альтернативы.

LAST (оконная)LAST (оконная)

Синтаксис:
LAST( value )
или
LAST( value [ TOTAL | WITHIN ... | AMONG ... ] [ ORDER BY ... ] [ BEFORE FILTER BY ... ] )

Возвращает значение value из последней строки заданного окна. См. также FIRST.

LEASTLEAST

Синтаксис:LEAST( value_1, value_2, value_3 [ , ... ] )

Возвращает наименьшее из значений.

См. также GREATEST.

В зависимости от указанного типа данных, возвращает:

  • наименьшее число;
  • первую строку в алфавитном порядке;
  • раннюю дату;
  • FALSE при выборе из TRUE и FALSE для логического типа.

LEFTLEFT

Синтаксис:LEFT( string, number )

Возвращает строку, которая содержит указанное количество символов number с начала строки string.

LEN (массивы)LEN (массивы)

Синтаксис:LEN( value )

Возвращает количество элементов в массиве value.

LENLEN

Синтаксис:LEN( value )

Возвращает количество символов в строке или элементов в массиве value.

LIKELIKE

Синтаксис:string_1 [ NOT ] LIKE string_2

Сравнивает строку string_1 со шаблоном string_2 и в случае совпадения возвращает TRUE.
В качестве string_2 можно задать значение или использовать знак %, который соответствует строке любой длины.

Вариант string_1 NOT LIKE возвращает противоположное значение.

Функция учитывает регистр символов при сравнении значений. Вы можете использовать LIKE совместно с функциями UPPER или LOWER, чтобы производить сравнение без учета регистра символов.

LNLN

Синтаксис:LN( number )

Возвращает натуральный логарифм числа number. Возвращает NULL, если число меньше или равно 0.

LOGLOG

Синтаксис:LOG( value, base )

Возвращает логарифм числа value по основанию числа base. Возвращает NULL, если число value меньше или равно 0.

LOG10LOG10

Синтаксис:LOG10( number )

Возвращает логарифм числа number по основанию 10. Возвращает NULL, если число меньше или равно 0.

LOWERLOWER

Синтаксис:LOWER( string )

Возвращает строку string в нижнем регистре.

LTRIMLTRIM

Синтаксис:LTRIM( string )

Возвращает строку string без знаков пробела в начале строки.

MARKUPMARKUP

Синтаксис:MARKUP( arg_1, arg_2, arg_3 [ , ... ] )

Объединяет размеченный текст. Также может быть использован для конвертации обычных строк в размеченный текст.

MAVG (оконная)MAVG (оконная)

Синтаксис:
MAVG( value, rows_1 [ , rows_2 ] )
или
MAVG( value, rows_1 [ , rows_2 ] [ TOTAL | WITHIN ... | AMONG ... ] [ ORDER BY ... ] [ BEFORE FILTER BY ... ] )

Возвращает скользящее среднее значений по окну записей. Значение определяется порядком сортировки и аргументами:

rows_1 rows_2 Окно
положительное - Текущая запись и rows_1 предшествующих.
отрицательное - Текущая запись и -rows_1 последующих.
любой знак любой знак rows_1 предшествующих записей, текущая и rows_2 последующих.

Аналогичное поведение у оконных функций MSUM, MCOUNT, MMIN, MMAX.

См. также AVG, RAVG.

MAXMAX

Синтаксис:
MAX( value )
или
MAX( value [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает максимальное значение.

Если value:

  • число — возвращает наибольшее число;
  • дата — возвращает самую позднюю дату;
  • строка — возвращает последнее значение в алфавитном порядке.

MAX (оконная)MAX (оконная)

Синтаксис:
MAX( value TOTAL | WITHIN ... | AMONG ... )
или
MAX( value TOTAL | WITHIN ... | AMONG ... [ BEFORE FILTER BY ... ] )

Возвращает максимальное значение.

Если value:

  • число — возвращает наибольшее число;
  • дата — возвращает самую позднюю дату;
  • строка — возвращает последнее значение в алфавитном порядке.

MCOUNT (оконная)MCOUNT (оконная)

Синтаксис:
MCOUNT( value, rows_1 [ , rows_2 ] )
или
MCOUNT( value, rows_1 [ , rows_2 ] [ TOTAL | WITHIN ... | AMONG ... ] [ ORDER BY ... ] [ BEFORE FILTER BY ... ] )

Возвращает количество значений (не равных NULL) по окну записей, которое определяется порядком сортировки и аргументами:

rows_1 rows_2 Окно
положительное - Текущая запись и rows_1 предшествующих.
отрицательное - Текущая запись и -rows_1 последующих.
любой знак любой знак rows_1 предшествующих записей, текущая и rows_2 последующих.

Аналогичное поведение у оконных функций MSUM, MMIN, MMAX, MAVG.

См. также COUNT, RCOUNT.

MEDIANMEDIAN

Синтаксис:
MEDIAN( value )
или
MEDIAN( value [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает медианное значение. При четном количестве элементов возвращает наибольший из соседних элементов в центральной позиции.

MINMIN

Синтаксис:
MIN( value )
или
MIN( value [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает минимальное значение.

Если value:

  • число — возвращает наименьшее число;
  • дата — возвращает самую раннюю дату;
  • строка — возвращает первое значение в алфавитном порядке.

MIN (оконная)MIN (оконная)

Синтаксис:
MIN( value TOTAL | WITHIN ... | AMONG ... )
или
MIN( value TOTAL | WITHIN ... | AMONG ... [ BEFORE FILTER BY ... ] )

Возвращает минимальное значение.

Если value:

  • число — возвращает наименьшее число;
  • дата — возвращает самую раннюю дату;
  • строка — возвращает первое значение в алфавитном порядке.

MINUTEMINUTE

Синтаксис:MINUTE( datetime )

Возвращает номер минуты в часе в указанной дате datetime. При указании даты без времени возвращает 0.

MMAX (оконная)MMAX (оконная)

Синтаксис:
MMAX( value, rows_1 [ , rows_2 ] )
или
MMAX( value, rows_1 [ , rows_2 ] [ TOTAL | WITHIN ... | AMONG ... ] [ ORDER BY ... ] [ BEFORE FILTER BY ... ] )

Возвращает скользящий максимум значений по окну записей. Значение определяется порядком сортировки и аргументами:

rows_1 rows_2 Окно
положительное - Текущая запись и rows_1 предшествующих.
отрицательное - Текущая запись и -rows_1 последующих.
любой знак любой знак rows_1 предшествующих записей, текущая и rows_2 последующих.

Аналогичное поведение у оконных функций MSUM, MCOUNT, MMIN, MAVG.

См. также MAX, RMAX.

MMIN (оконная)MMIN (оконная)

Синтаксис:
MMIN( value, rows_1 [ , rows_2 ] )
или
MMIN( value, rows_1 [ , rows_2 ] [ TOTAL | WITHIN ... | AMONG ... ] [ ORDER BY ... ] [ BEFORE FILTER BY ... ] )

Возвращает скользящий минимум значений по окну записей, определяемому порядком сортировки и аргументами:

rows_1 rows_2 Окно
положительное - Текущая запись и rows_1 предшествующих.
отрицательное - Текущая запись и -rows_1 последующих.
любой знак любой знак rows_1 предшествующих записей, текущая и rows_2 последующих.

Аналогичное поведение у оконных функций MSUM, MCOUNT, MMAX, MAVG.

См. также MIN, RMIN.

MONTHMONTH

Синтаксис:MONTH( datetime )

Возвращает номер месяца в году в указанной дате datetime.

MSUM (оконная)MSUM (оконная)

Синтаксис:
MSUM( value, rows_1 [ , rows_2 ] )
или
MSUM( value, rows_1 [ , rows_2 ] [ TOTAL | WITHIN ... | AMONG ... ] [ ORDER BY ... ] [ BEFORE FILTER BY ... ] )

Возвращает скользящую сумму значений по окну записей, которое определяется порядком сортировки и аргументами:

rows_1 rows_2 Окно
положительное - Текущая запись и rows_1 предшествующих.
отрицательное - Текущая запись и -rows_1 последующих.
любой знак любой знак rows_1 предшествующих записей, текущая и rows_2 последующих.

Аналогичное поведение у оконных функций MCOUNT, MMIN, MMAX, MAVG.

См. также SUM, RSUM.

Отрицание (-)Отрицание (-)

Синтаксис:-value

Возвращает число value с противоположным знаком.

NOTNOT

Синтаксис:NOT value

Инвертирует логическое значение.

NOWNOW

Синтаксис:NOW()

Возвращает текущую дату и время в зависимости от источника данных и типа соединения.

OROR

Синтаксис:value_1 OR value_2

Выполняет логическое соединение двух выражений по условию ИЛИ.

PIPI

Синтаксис:PI()

Возвращает число Пи. Точность зависит от источника данных.

POWERPOWER

Синтаксис:POWER( base, power )

Возводит число base в степень power.

QUANTILEQUANTILE

Синтаксис:
QUANTILE( value, quant )
или
QUANTILE( value, quant [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает точный квантиль уровня quant (значение от 0 до 1).

QUANTILE_APPROXQUANTILE_APPROX

Синтаксис:
QUANTILE_APPROX( value, quant )
или
QUANTILE_APPROX( value, quant [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает примерный квантиль уровня quant (значение от 0 до 1).

QUARTERQUARTER

Синтаксис:QUARTER( datetime )

Возвращает номер квартала года (от 1 до 4) в указанной дате datetime.

RADIANSRADIANS

Синтаксис:RADIANS( degrees )

Преобразует градусы degrees в радианы.

RANK (оконная)RANK (оконная)

Синтаксис:
RANK( value [ , direction ] )
или
RANK( value [ , direction ] [ TOTAL | WITHIN ... | AMONG ... ] [ BEFORE FILTER BY ... ] )

Выполняет ранжирование значений с пропусками: возвращает порядковый номер строки при сортировке по value. Строки, которые соответствуют одному и тому же значению value, имеют одно и то же значение ранга. Если первые две строки получают ранг 1, то ранг следующей строки (если значение value не совпадает) будет равен 3. Значение 2 в этом случае пропускается.

Если direction равно "desc" или не указано, то ранжирование происходит от большего к меньшему, если "asc", то от меньшего к большему. По умолчанию используется "desc".

См. также RANK_DENSE, RANK_UNIQUE, RANK_PERCENTILE.

RANK_DENSE (оконная)RANK_DENSE (оконная)

Синтаксис:
RANK_DENSE( value [ , direction ] )
или
RANK_DENSE( value [ , direction ] [ TOTAL | WITHIN ... | AMONG ... ] [ BEFORE FILTER BY ... ] )

Выполняет ранжирование значений без пропусков: возвращает порядковый номер строки при сортировке по value. Строки, которые соответствуют одному и тому же значению value, имеют одно и то же значение ранга. Если первые две строки получают ранг 1, то ранг следующей строки (если значение value не совпадает) будет равен 2. Значения ранга не пропускаются.

Если direction равно "desc" или не указано, то ранжирование происходит от большего к меньшему, если "asc", то от меньшего к большему. По умолчанию используется "desc".

См. также RANK, RANK_DENSE, RANK_PERCENTILE.

RANK_PERCENTILE (оконная)RANK_PERCENTILE (оконная)

Синтаксис:
RANK_PERCENTILE( value [ , direction ] )
или
RANK_PERCENTILE( value [ , direction ] [ TOTAL | WITHIN ... | AMONG ... ] [ BEFORE FILTER BY ... ] )

Выполняет относительное ранжирование. Возвращает дробный ранг (от 0 до 1). Расчитывается как (RANK(...) - 1) / (количество строк).

Если direction равно "desc" или не указано, то ранжирование происходит от большего к меньшему, если "asc", то от меньшего к большему. По умолчанию используется "desc".

См. также RANK, RANK_DENSE, RANK_UNIQUE.

RANK_UNIQUE (оконная)RANK_UNIQUE (оконная)

Синтаксис:
RANK_UNIQUE( value [ , direction ] )
или
RANK_UNIQUE( value [ , direction ] [ TOTAL | WITHIN ... | AMONG ... ] [ BEFORE FILTER BY ... ] )

Выполняет уникальное ранжирование. Возвращает порядковый номер строки при сортировке по value. Строки, которые соответствуют одному и тому же значению value, имеют разные значения ранга. Ни для каких двух строк значения не совпадают. Принимает все значения от 1 до значения, которое равно количеству строк.

Если direction равно "desc" или не указано, то ранжирование происходит от большего к меньшему, если "asc", то от меньшего к большему. По умолчанию используется "desc".

См. также RANK, RANK_DENSE, RANK_PERCENTILE.

RAVG (оконная)RAVG (оконная)

Синтаксис:
RAVG( value [ , direction ] )
или
RAVG( value [ , direction ] [ TOTAL | WITHIN ... | AMONG ... ] [ ORDER BY ... ] [ BEFORE FILTER BY ... ] )

Возвращает среднее арифметическое значений в рамках окна записей, определяемого аргументом direction:

direction Окно
"asc" От первой записи до текущей.
"desc" От текущей записи до последней.

По умолчанию используется значение "asc".

Аналогичное поведение у оконных функций RSUM, RCOUNT, RMIN, RMAX.

См. также AVG, MAVG.

RCOUNT (оконная)RCOUNT (оконная)

Синтаксис:
RCOUNT( value [ , direction ] )
или
RCOUNT( value [ , direction ] [ TOTAL | WITHIN ... | AMONG ... ] [ ORDER BY ... ] [ BEFORE FILTER BY ... ] )

Возвращает количество значений в рамках окна записей, определяемого порядком сортировки и значением аргумента direction:

direction Окно
"asc" От первой записи до текущей.
"desc" От текущей записи до последней.

По умолчанию используется значение "asc".

Аналогичное поведение у оконных функций RSUM, RMIN, RMAX, RAVG.

См. также COUNT, MCOUNT.

REGEXP_EXTRACTREGEXP_EXTRACT

Синтаксис:REGEXP_EXTRACT( string, pattern )

Возвращает подстроку string, которая соответствует регулярному выражению pattern.

REGEXP_EXTRACT_ALLREGEXP_EXTRACT_ALL

Синтаксис:REGEXP_EXTRACT_ALL( string, pattern )

Возвращает все подстроки string, которые соответствуют регулярному выражению pattern. Для регулярных выражений с подгруппами работает только для первой подгруппы.

REGEXP_EXTRACT_NTHREGEXP_EXTRACT_NTH

Синтаксис:REGEXP_EXTRACT_NTH( string, pattern, match_index )

Возвращает подстроку string, которая соответствует шаблону регулярного выражения pattern, начиная с указанного индекса.

REGEXP_MATCHREGEXP_MATCH

Синтаксис:REGEXP_MATCH( string, pattern )

Возвращает TRUE, если в строке string есть подстрока, которая соответствует шаблону регулярного выражения pattern.

REGEXP_REPLACEREGEXP_REPLACE

Синтаксис:REGEXP_REPLACE( string, pattern, replace_with )

Ищет подстроку в строке string по шаблону регулярного выражения pattern и заменяет ее строкой replace_with.

Если подстрока не найдена, то строка не будет изменена.

REPLACE (массивы)REPLACE (массивы)

Синтаксис:REPLACE( array, old, new )

Заменяет в массиве array все элементы, равные old, на new.

REPLACE (строковая)REPLACE (строковая)

Синтаксис:REPLACE( string, substring, replace_with )

Ищет подстроку substring в строке string и заменяет ее строкой replace_with.

Если подстрока не найдена, то строка не будет изменена.

RIGHTRIGHT

Синтаксис:RIGHT( string, number )

Возвращает строку, которая содержит указанное количество символов number с конца строки string.

RMAX (оконная)RMAX (оконная)

Синтаксис:
RMAX( value [ , direction ] )
или
RMAX( value [ , direction ] [ TOTAL | WITHIN ... | AMONG ... ] [ ORDER BY ... ] [ BEFORE FILTER BY ... ] )

Возвращает максимальное из значений в рамках окна записей, определяемого порядком сортировки и значением аргумента direction:

direction Окно
"asc" От первой записи до текущей.
"desc" От текущей записи до последней.

По умолчанию используется значение "asc".

Аналогичное поведение у оконных функций RSUM, RCOUNT, RMIN, RAVG.

См. также MAX, MMAX.

RMIN (оконная)RMIN (оконная)

Синтаксис:
RMIN( value [ , direction ] )
или
RMIN( value [ , direction ] [ TOTAL | WITHIN ... | AMONG ... ] [ ORDER BY ... ] [ BEFORE FILTER BY ... ] )

Возвращает минимальное из значений в рамках окна записей, определяемого порядком сортировки и значением аргумента direction:

direction Окно
"asc" От первой записи до текущей.
"desc" От текущей записи до последней.

По умолчанию используется значение "asc".

Аналогичное поведение у оконных функций RSUM, RCOUNT, RMAX, RAVG.

См. также MIN, MMIN.

ROUNDROUND

Синтаксис:ROUND( number [ , precision ] )

Округляет число number до указанного числа знаков precision после запятой.
Если число precision не указано, то number округляется до ближайшего целого.

RSUM (оконная)RSUM (оконная)

Синтаксис:
RSUM( value [ , direction ] )
или
RSUM( value [ , direction ] [ TOTAL | WITHIN ... | AMONG ... ] [ ORDER BY ... ] [ BEFORE FILTER BY ... ] )

Возвращает сумму значений в рамках окна записей, определяемого порядком сортировки и значением аргумента direction:

direction Окно
"asc" От первой записи до текущей.
"desc" От текущей записи до последней.

По умолчанию используется значение "asc".

Аналогичное поведение у оконных функций RCOUNT, RMIN, RMAX, RAVG.

См. также SUM, MSUM.

RTRIMRTRIM

Синтаксис:RTRIM( string )

Возвращает строку string без знаков пробела в конце строки.

SECONDSECOND

Синтаксис:SECOND( datetime )

Возвращает номер секунды в минуте в указанной дате datetime. При указании даты без времени возвращает 0.

SIGNSIGN

Синтаксис:SIGN( number )

Возвращает знак числа number:

  • -1 если число отрицательное;
  • 0 если число равно нулю;
  • 1 если число положительное.

SINSIN

Синтаксис:SIN( number )

Возвращает синус числа number, заданного в радианах.

SIZESIZE

Синтаксис:SIZE( text, size )

Позволяет указать размер в пикселях для переданного текста.

SLICESLICE

Синтаксис:SLICE( array, offset, length )

Возвращает часть массива array длины length, начиная с индекса offset. Индексы в массиве начинаются с единицы.

SPACESPACE

Синтаксис:SPACE( value )

Возвращает строку с указанным количеством пробелов.

SPLITSPLIT

Синтаксис:SPLIT( orig_string [ , delimiter [ , part_index ] ] )

Разделяет orig_string на последовательность подстрок, используя символ разделителя delimiter, и возвращает подстроку, порядковый номер которой равен параметру part_index. Разделитель по умолчанию — запятая. Если part_index отрицательный, отсчет возвращаемой подстроки ведется с конца orig_string. Если количество подстрок меньше, чем абсолютное значение part_index, возвращается пустая строка. Если не передан part_index, то возвращается массив подстрок (только для источников ClickHouse, PostgreSQL).

SQRTSQRT

Синтаксис:SQRT( number )

Возвращает квадратный корень заданного числа.

SQUARESQUARE

Синтаксис:SQUARE( number )

Возвращает число number, возведенное в степень 2.

STARTSWITH (массивы)STARTSWITH (массивы)

Синтаксис:STARTSWITH( array_1, array_2 )

Возвращает TRUE, если значения из массива array_2 находятся в начале массива array_1.

STARTSWITH (строковая)STARTSWITH (строковая)

Синтаксис:STARTSWITH( string, substring )

Возвращает TRUE, если строка string начинается на подстроку substring. Для регистронезависимой проверки см. ISTARTSWITH.

STDEVSTDEV

Синтаксис:
STDEV( value )
или
STDEV( value [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает статистическое стандартное отклонение всех значений в выражении на основе выборки из совокупности.

STDEVPSTDEVP

Синтаксис:
STDEVP( value )
или
STDEVP( value [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

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

STRSTR

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

Переводит выражение expression к типу строки.

SUBSTRSUBSTR

Синтаксис:SUBSTR( string, from_index [ , length ] )

Возвращает подстроку string, начиная с индекса from_index. Нумерация начинается с единицы.

Если указан дополнительный аргумент length, то будет возвращена подстрока указанной длины.

SUMSUM

Синтаксис:
SUM( value )
или
SUM( value [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает сумму всех значений выражения. Работает только с числовыми типами данных.

SUM (оконная)SUM (оконная)

Синтаксис:
SUM( value TOTAL | WITHIN ... | AMONG ... )
или
SUM( value TOTAL | WITHIN ... | AMONG ... [ BEFORE FILTER BY ... ] )

Возвращает сумму всех значений выражения. Работает только с числовыми типами данных.

SUM_IFSUM_IF

Синтаксис:
SUM_IF( expression, condition )
или
SUM_IF( expression, condition [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает сумму всех значений выражения, которые удовлетворяют условию condition. Работает только с числовыми типами данных.

SUM_IF (оконная)SUM_IF (оконная)

Синтаксис:
SUM_IF( expression, condition TOTAL | WITHIN ... | AMONG ... )
или
SUM_IF( expression, condition TOTAL | WITHIN ... | AMONG ... [ BEFORE FILTER BY ... ] )

Возвращает сумму всех значений выражения, которые удовлетворяют условию condition. Работает только с числовыми типами данных.

TANTAN

Синтаксис:TAN( number )

Возвращает тангенс числа number, заданного в радианах.

TODAYTODAY

Синтаксис:TODAY()

Возвращает текущую дату в зависимости от источника данных и типа соединения.

TOOLTIPTOOLTIP

Синтаксис:TOOLTIP( text, tooltip [ , placement ] )

Добавляет небольшую всплывающую подсказку к тексту или результату выполнения других функций разметки. Аргумент placement отвечает за расположение подсказки (top, right, bottom, left или auto). Значение по умолчанию — auto.

TOP_CONCATTOP_CONCAT

Синтаксис:
TOP_CONCAT( expression, amount [ , separator ] )
или
TOP_CONCAT( expression, amount [ , separator ] [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает строку, которая содержит amount наиболее часто встречающихся уникальных значений из expression, разделенных separator (по умолчанию разделитель — запятая).

TREETREE

Синтаксис:TREE( array )

Переводит выражение array в формат Дерево строк. Используется для создания древовидных иерархий.

TRIMTRIM

Синтаксис:TRIM( string )

Возвращает строку string без знаков пробела в начале и конце строки.

UNNESTUNNEST

Синтаксис:UNNEST( array )

Дублирует исходную строку для каждого элемента массива array.

UPPERUPPER

Синтаксис:UPPER( string )

Возвращает строку string в верхнем регистре.

URLURL

Синтаксис:URL( address, text )

Оборачивает text в ссылку на URL address. При переходе по ссылке страница открывается в новой вкладке браузера.

USER_INFOUSER_INFO

Синтаксис:USER_INFO( user_id, user_info_type )

По идентификатору пользователя user_id возвращает размеченный текст для отображения его имени или email в зависимости от значения второго аргумента user_info_type:

  • email — возвращает email;
  • name — возвращает имя.

Если пользователь не найден, возвращается оригинальная строка из источника.

UTF8UTF8

Синтаксис:UTF8( string, old_encoding )

Переводит кодировку строки string в UTF8.

VARVAR

Синтаксис:
VAR( value )
или
VAR( value [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает статистическую дисперсию всех значений в выражении на основе выборки из совокупности.

VARPVARP

Синтаксис:
VARP( value )
или
VARP( value [ FIXED ... | INCLUDE ... | EXCLUDE ... ] [ BEFORE FILTER BY ... ] )

Возвращает статистическую дисперсию всех значений в выражении по всей совокупности.

WEEKWEEK

Синтаксис:WEEK( value )

Возвращает номер недели в соответствии с ISO 8601. Первой считается неделя, которая содержит первый четверг года и 4.01.

YEARYEAR

Синтаксис:YEAR( datetime )

Возвращает номер года в указанной дате datetime.

ZNZN

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

Возвращает значение выражения expression, если оно не NULL. В противном случае возвращает 0.

Была ли статья полезна?

Предыдущая
Синтаксис формул
Следующая
Обзор
Проект Яндекса
© 2025 ООО «Яндекс.Облако»