Функции

CAST

CAST(hiredate AS CHAR(40)) FROM employee

Меняет тип данных выражения или нулевого литерала на другой тип данных. Например, можно привести к другому типу данных элемент customer_name (с типом данных CHAR или VARCHAR) или birthdate (литерал datetime).

Функция CAST используется для изменения типа данных на тип Date (Дата).

Не используйте TODATE.

CAST(expr AS type)

IFNULL

IFNULL(Sales, 0)

Проверяет, равняется ли значение выражения неопределенному значению, и, если равняется, присваивает выражению указанное значение.

IFNULL(expr, value)

INDEXCOL

SELECT INDEXCOL(VALUEOF ("NQ_SESSION"."GEOGRAPHY_LEVEL"), Country, State, City), Revenue FROM Sales

Использует внешние данные для возврата соответствующего столбца подключенному к системе пользователю.

INDEXCOL([integer literal], [expr1] [, [expr2], ?-])

NULLIF

SELECT e.last_name, NULLIF(e.job_id, j.job_id) "Old Job ID" FROM employees e, job_history j WHERE e.employee_id = j.employee_id ORDER BY last_name, "Old Job ID";

Используется для сравнения двух выражений. Если они равны, функция возвращает неопределенное значение (NULL). Если они не равны, функция возвращает первое выражение. Указывать литерал NULL в качестве первого выражения нельзя.

NULLIF([expression], [expression])

To_DateTime

SELECT To_DateTime ('2009-03-0301:01:00', 'yyyy-mm-dd hh:mi:ss') FROM sales

Преобразует строковые литералы формата DateTime в тип данных DateTime.

To_DateTime([expression], [literal])

VALUEOF

SalesSubjectArea.Customer.Region = VALUEOF("Region Security"."REGION")

Ссылается на значение переменной семантической модели в фильтре.

Переменные expr используются как аргументы функции VALUEOF. Обращайтесь к статическим переменным семантической модели по имени.

VALUEOF(expr)

Извлечение дня

Возвращает метку времени на полночь (12 AM) в день, когда появляется входное значение. Например, если 22 февраля входной меткой времени является 3:02:01 AM, функция возвращает метку времени на 12:00:00 AM 22 февраля.

EXTRACTDAY(expr)

Извлечение часов

Возвращает метку времени на начало часа, в течение которого появляется входное значение. Например, если входной меткой времени является 11:18:30 PM, функция возвращает метку времени на 11:00:00 PM.

EXTRACTHOUR (expr)

Извлечение часов дня

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

EXTRACTHOUROFDAY(expr)

Извлечение миллисекунд

EXTRACTMILLISECOND(expr)

Извлечение минут

Возвращает метку времени на начало минуты, в течение которой появляется входное значение. Например, если входной меткой времени является 11:38:21 PM, функция возвращает метку времени на 11:38:00 PM.

EXTRACTMINUTE (expr)

Извлечение месяца

Возвращает метку времени на первый день месяца, в котором появляется входное значение. Например, если входной меткой времени является 22 февраля, функция возвращает метку времени на 1 февраля.

EXTRACTMONTH(expr)

Извлечение квартала

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

EXTRACTQUARTER(expr)

Извлечение секунд

Возвращает метку времени для входного значения. Например, если входной меткой времени является 15:32:02.150, функция возвращает метку времени на 15:32:02.

EXTRACTSECOND(expr)

Извлечение недели

Возвращает дату первого дня недели (воскресенье), на которой появляется входное значение. Например, если входная метка времени появляется в среду, 24 сентября, функция возвращает метку времени на воскресенье, 21 сентября.

Примечание. Если первый день недели (т. е. воскресенье) приходится на предыдущий год и тем самым отрицательно влияет на агрегацию, функция возвращает седьмой день недели (субботу) текущим годом вместо первого дня недели, относящегося к предыдущему году. Например, 1/1/24, 1/2/24 и 1/3/24 агрегируются по субботе 1/6/24 вместо воскресенья 12/29/23.

EXTRACTWEEK(expr)

Извлечение года

Возвращает метку времени на 1 января года, в котором появляется входное значение. Например, если входная метка времени появляется в 1967 г., функция возвращает метку времени на 1 января 1967 г.

EXTRACTYEAR (expr)

BottomN

BottomN(Sales, 10)

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

BottomN([NumericExpression], [integer])

FILTER

FILTER(Sales USING Product = 'widget')

Служит для вычисления выражения с помощью заданного фильтра предварительной агрегации.

FILTER(measure USING filter_expr)

MAVG

MAVG(Sales, 10)

Служит для вычисления скользящего среднего (усредненного значения) для последних n строк данных набора результатов, включая текущую строку.

MAVG([NumericExpression], [integer])

MSUM

SELECT Month, Revenue, MSUM(Revenue, 3) as 3_MO_SUM FROM Sales

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

Сумма для первой строки равна значению числового выражения первой строки. Сумма второй строки вычисляется как сумма первых двух строк данных и т. д. После достижения n-й строки данных вычисляется сумма последних n строк данных.

MSUM([NumericExpression], [integer])

NTILE

NTILE(Sales, 100)

Определяет ранг значения из заданного пользователям диапазона. Возвращает целые значения, представляющие произвольный диапазон рангов. В примере показан диапазон значений от 1 до 100, где наименьший объем продаж = 1, а наибольший объем продаж = 100.

NTILE([NumericExpresssion], [integer])

PERCENTILE

PERCENTILE(Sales)

Служит для вычисления ранга процентиля для каждого значения, удовлетворяющего аргументу числового выражения. Ранги процентиля находятся в пределах от 0 (первый процентиль) до 1 (сотый процентиль) включительно.

PERCENTILE([NumericExpression])

RANK

RANK(Sales)

Служит для вычисления ранга каждого значения, удовлетворяющего аргументу числового выражения. Наибольшему значению присваивается ранг 1, а каждому следующему по порядку рангу присваивается следующее по порядку целое число (2, 3, 4,...). Если имеется несколько равных значений, им присваивается одинаковый ранг (например, 1, 1, 1, 4, 5, 5, 7...).

RANK([NumericExpression])

RCOUNT

SELECT month, profit, RCOUNT(profit) FROM sales WHERE profit > 200

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

RCOUNT([NumericExpression])

RMAX

SELECT month, profit, RMAX(profit) FROM sales

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

RMAX([NumericExpression])

RMIN

SELECT month, profit, RMIN(profit) FROM sales

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

RMIN([NumericExpression])

RSUM

SELECT month, revenue, RSUM(revenue) as RUNNING_SUM FROM sales

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

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

RSUM([NumericExpression])

TOPN

TOPN(Sales, 10)

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

TOPN([NumericExpression], [integer])

EVALUATE

SELECT EVALUATE('instr(%1, %2)', address, 'Foster City') FROM employees

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

EVALUATE([строковое выражение], [выражения, разделенные запятыми])

EVALUATE_AGGR

EVALUATE_AGGR('REGR_SLOPE(%1, %2)', sales.quantity, market.marketkey)

Передает указанную функцию базы данных с дополнительными ссылочными столбцами в качестве параметров на оценку в базу данных. Эта функция предназначена для функций агрегирования с фразой GROUP BY.

EVALUATE_AGGR('db_agg_function(%1...%N)' [AS datatype] [, column1, columnN])

ABS

ABS(Profit)

Вычисление абсолютного значения числового выражения.

expr — любое выражение, в результате вычисления которого получается числовое значение.

ABS(expr)

ACOS

ACOS(1)

Вычисление арккосинуса числового выражения.

expr — любое выражение, в результате вычисления которого получается числовое значение.

ACOS(expr)

ASIN

ASIN(1)

Вычисление арксинуса числового выражения.

expr — любое выражение, в результате вычисления которого получается числовое значение.

ASIN(expr)

ATAN

ATAN(1)

Вычисления арктангенса числового выражения.

expr — любое выражение, в результате вычисления которого получается числовое значение.

ATAN(expr)

ATAN2

ATAN2(1, 2)

Служит для вычисления арктангенса y/x, где y — первое числовое выражение, а x — второе числовое выражение.

ATAN2(expr1, expr2)

CEILING

CEILING(Profit)

Округление нецелого числового выражения до ближайшего целого числа в сторону увеличения. Если результатом числового выражения является целое число, функция CEILING возвращает это целое число.

CEILING(expr)

COS

COS(1)

Вычисление косинуса числового выражения.

expr — любое выражение, в результате вычисления которого получается числовое значение.

COS(expr)

COT

COT(1)

Вычисление котангенса числового выражения.

expr — любое выражение, в результате вычисления которого получается числовое значение.

COT(expr)

DEGREES

DEGREES(1)

Служит для преобразования выражения из радиан в градусы

expr — любое выражение, в результате вычисления которого получается числовое значение.

DEGREES(expr)

EXP

EXP(4)

Служит для возведения значения в указанную степень Вычисляет значение e в степени n, где e — основание натурального логарифма.

EXP(expr)

ExtractBit

Int ExtractBit(1, 5)

Извлекает бит в конкретной позиции целого числа. Возвращает целое число, 0 или 1, соответствующее позиции бита.

ExtractBit([Source Number], [Digits])

FLOOR

FLOOR(Profit)

Округление нецелого числового выражения до ближайшего целого числа в сторону уменьшения. Если результатом числового выражения является целое число, функция FLOOR возвращает это целое число.

LOG

LOG(1)

Служит для вычисления натурального логарифма выражения

expr — любое выражение, в результате вычисления которого получается числовое значение.

LOG(expr)

LOG10

LOG10(1)

Служит для вычисления десятичного логарифма выражения

expr — любое выражение, в результате вычисления которого получается числовое значение.

LOG10(expr)

MOD

MOD(10, 3)

Делит первое числовое выражение на второе числовое выражение и возвращает остаток от деления.

MOD(expr1, expr2)

PI

PI()

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

PI()

POWER

POWER(Profit, 2)

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

POWER(expr1, expr2)

RADIANS

RADIANS(30)

Служит для преобразования выражения из градусов в радианы.

expr — любое выражение, в результате вычисления которого получается числовое значение.

RADIANS(expr)

RAND

RAND()

Служит для получения псевдослучайного числа между 0 и 1.

RAND()

RANDFromSeed

RAND(2)

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

RAND(expr)

ROUND

ROUND(2.166000, 2)

Округляет числовое выражение с точностью до n десятичных знаков.

expr — любое выражение, в результате вычисления которого получается числовое значение.

integer — любое положительное целое число, которое представляет число значащих разрядов

ROUND(expr, integer)

SIGN

SIGN(Profit)

Возвращает следующее:

• 1, если результат вычисления числового выражения — положительное число;

• -1, если результат вычисления числового выражения — отрицательное число;

• 0, если результат вычисления числового выражения — ноль.

SIGN(expr)

SIN

SIN(1)

Вычисление синуса числового выражения.

SIN(expr)

SQRT

SQRT(7)

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

SQRT(expr)

TAN

TAN(1)

Вычисление тангенса числового выражения.

expr — любое выражение, в результате вычисления которого получается числовое значение.

TAN(expr)

TRUNCATE

TRUNCATE(45.12345, 2)

Усекает десятичное число и возвращает число с заданным количеством десятичных знаков.

expr — любое выражение, в результате вычисления которого получается числовое значение.

integer — любое положительное целое число, представляющее количество символов справа от десятичной точки в возвращаемом числе.

TRUNCATE(expr, integer)

MAVG

Служит для вычисления скользящего среднего (усредненного значения) для последних n строк данных набора результатов, включая текущую строку.

expr —любое выражение, в результате вычисления которого получается числовое значение. integer — любое положительное целое число. Представляет среднее для последних n строк данных.

MAVG(expr, integer)

MSUM

select month, revenue, MSUM(revenue, 3) as 3_MO_SUM from sales_subject_area

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

expr —любое выражение, в результате вычисления которого получается числовое значение. integer — любое положительное целое число. Представляет сумму последних n строк данных.

MSUM(expr, integer)

RSUM

SELECT month, revenue, RSUM(revenue) as RUNNING_SUM from sales_subject_area

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

expr — любое выражение, в результате вычисления которого получается числовое значение.

RSUM(expr)

RCOUNT

select month, profit, RCOUNT(profit) from sales_subject_area where profit > 200

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

expr — выражение произвольного типа данных.

RCOUNT(expr)

RMAX

SELECT month, profit,RMAX(profit) from sales_subject_area

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

expr — выражение произвольного типа данных.

RMAX(expr)

RMIN

select month, profit,RMIN(profit) from sales_subject_area

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

expr — выражение произвольного типа данных.

RMIN(expr)

ASCII

ASCII('a')

Преобразование строки, состоящей из одного символа, в соответствующий код ASCII (число от 0 до 255). Если символьное выражение содержит несколько символов, возвращается ASCII-код первого символа в выражении.

expr — любое выражение, в результате вычисления которого получается строка символов.

ASCII(expr)

BIT_LENGTH

BIT_LENGTH('abcdef')

Возвращает длину указанной строки в битах. Длина каждого символа Unicode — 2 байта (16 битов).

expr — любое выражение, в результате вычисления которого получается строка символов.

BIT_LENGTH(expr)

CHAR

CHAR(35)

Преобразует числовое значение от 0 до 255 в символьное значение, ASCII-код которого соответствует этому значению.

expr — любое выражение, в результате вычисления которого получается числовое значение от 0 до 255.

CHAR(expr)

CHAR_LENGTH

CHAR_LENGTH(Customer_Name)

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

expr — любое выражение, в результате вычисления которого получается строка символов.

CHAR_LENGTH(expr)

CONCAT

SELECT DISTINCT CONCAT ('abc', 'def') FROM employee

Объединяет две строки символов.

expr — выражение, в результате вычисления которого получаются строки символов, разделенные запятыми.

Для функции CONCAT необходимо использовать необработанные, неформатированные данные.

CONCAT(expr1, expr2)

INSERT

SELECT INSERT('123456', 2, 3, 'abcd') FROM table

Вставка заданной строки символов в указанное местоположение в другой строке символов.

expr1 — любое выражение, в результате вычисления которого получается строка символов. Определяет целевую строку символов.

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

integer2 — любое положительное целое число, представляющее количество символов в целевой строке, которое требуется заменить второй строкой.

expr2 — любое выражение, в результате вычисления которого получается строка символов. Определяет строку символов, которую требуется вставить в целевую строку.

INSERT(expr1, integer1, integer2, expr2)

LEFT

SELECT LEFT('123456', 3) FROM table

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

expr — любое выражение, в результате вычисления которого получается строка символов.

integer — любое положительное целое число, представляющее количество символов от левого края строки, которое возвращается в качестве результата.

LEFT(expr, integer)

LENGTH

LENGTH(Customer_Name)

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

expr — любое выражение, в результате вычисления которого получается строка символов.

LENGTH(expr)

LOCATE

LOCATE('d' 'abcdef')

Возвращает номер позиции строки символов в другой строке символов. Если строка символов не найдена в выбранной строке, функция возвращает значение 0.

expr1 — любое выражение, в результате вычисления которого получается строка символов. Определяет строку, которую требуется найти.

expr2 — любое выражение, в результате вычисления которого получается строка символов.

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

LOCATE(expr1, expr2)

LOCATEN

LOCATEN('d' 'abcdef', 3)

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

expr1 — любое выражение, в результате вычисления которого получается строка символов. Определяет строку, которую требуется найти.

expr2 — любое выражение, в результате вычисления которого получается строка символов. Определяет строку символов, в которой выполняется поиск.

integer — любое положительное (ненулевое) целое число, представляющее начальную позицию, с которой начинается поиск данной строки символов.

LOCATEN(expr1, expr2, integer)

LOWER

LOWER(Customer_Name)

Преобразование строки символов в нижний регистр.

expr — любое выражение, в результате вычисления которого получается строка символов.

LOWER(expr)

OCTET_LENGTH

OCTET_LENGTH('abcdef')

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

expr — любое выражение, в результате вычисления которого получается строка символов.

OCTET_LENGTH(expr)

POSITION

POSITION('d', 'abcdef')

Возвращает номер позиции элемента strExpr1 в символьном выражении. Если элемент strExpr1 не найден, функция возвращает значение 0.

expr1 — любое выражение, в результате вычисления которого получается строка символов. Определяет строку, поиск которой следует выполнить в целевой строке. Например, "d".

expr2 — любое выражение, в результате вычисления которого получается строка символов. Определяет целевую строку символов, в которой осуществляется поиск. Например, "abcdef".

POSITION(expr1, expr2)

REPEAT

REPEAT('abc', 4)

Повторяет указанное выражение n раз.

expr — любое выражение, в результате вычисления которого получается строка символов.

integer — любое положительное целое число, представляющее количество вхождений заданной строки символов.

REPEAT(expr, integer)

REPLACE

REPLACE('abcd1234', '123', 'zz')

Замена одного или нескольких символов в указанном символьном выражении другим символом или несколькими другими символами.

expr1 — любое выражение, в результате вычисления которого получается строка символов. Это строка символов, в которой требуется выполнить замену символов.

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

expr3 — любое выражение, в результате вычисления которого получается строка символов. Третья строка задает символы, которые требуется подставить в первую строку.

REPLACE(expr1, expr2, expr3)

RIGHT

SELECT RIGHT('123456', 3) FROM table

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

expr — любое выражение, в результате вычисления которого получается строка символов.

integer — любое положительное целое число, представляющее количество символов от правого края строки, которое возвращается в качестве результата.

RIGHT(expr, integer)

SPACE

SPACE(2)

Выполняет вставку пробелов.

integer — положительное целое число, задающее количество пробелов, которое требуется вставить.

SPACE(expr)

SUBSTRING

SUBSTRING('abcdef' FROM 2)

Создание новой строки, начинающейся после фиксированного количества символов в исходной строке.

expr — любое выражение, в результате вычисления которого получается строка символов.

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

SUBSTRING([SourceString] FROM [StartPostition])

SUBSTRINGN

SUBSTRING('abcdef' FROM 2 FOR 3)

Подобно функции SUBSTRING создает новую строку, начинающуюся с фиксированного числа символов исходной строки.

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

expr — любое выражение, в результате вычисления которого получается строка символов.

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

SUBSTRING(expr FROM startPos FOR length)

TrimBoth

Trim(BOTH '_' FROM '_abcdef_')

Удаление указанных символов в начале и в конце строки.

char — любой отдельный символ. Если не задан символ (и обязательные одинарные кавычки), по умолчанию используется пустой символ.

expr — любое выражение, в результате вычисления которого получается строка символов.

TRIM(BOTH char FROM expr)

TRIMLEADING

TRIM(LEADING '_' FROM '_abcdef')

Удаление указанных символов в начале строки.

char — любой отдельный символ. Если не задан символ (и обязательные одинарные кавычки), по умолчанию используется пустой символ.

expr — любое выражение, в результате вычисления которого получается строка символов.

TRIM(LEADING char FROM expr)

TRIMTRAILING

TRIM(TRAILING '_' FROM 'abcdef_')

Удаление указанных символов в конце строки.

char — любой отдельный символ. Если не задан символ (и обязательные одинарные кавычки), по умолчанию используется пустой символ.

expr — любое выражение, в результате вычисления которого получается строка символов.

TRIM(TRAILING char FROM expr)

UPPER

UPPER(Customer_Name)

Преобразование строки символов в верхний регистр.

expr — любое выражение, в результате вычисления которого получается строка символов.

UPPER(expr)

AGO

SELECT Year_ID, AGO(sales, year, 1)

Вычисляет агрегированное значение показателя за указанный период времени в прошлом. Например, для расчета месячного дохода один год назад используйте AGO(Revenue, Year, 1, SHIP_MONTH). Для расчета квартального дохода в прошлом квартале используйте AGO(Revenue, Quarter, 1).

AGO(MEASURE, TIME_LEVEL, OFFSET)

Где:

• MEASURE представляет собой показатель для расчета, например дохода.
• TIME_LEVEL представляет собой временной интервал, который может быть годом, кварталом, месяцем, неделей или днем.
• OFFSET представляет собой количество временных интервалов, для которых выполняется расчет; например, "1" для одного года.

PERIODROLLING

SELECT Month_ID, PERIODROLLING (monthly_sales, -1, 1)

Вычисляет агрегацию показателя за период, начало и конец которого отстоят от текущего момента времени соответственно на x и y единиц времени. Например, функция PERIODROLLING может вычислить продажи за период, который начинается за квартал до текущего квартала и заканчивается через квартал после текущего квартала.

PERIODROLLING(measure, x [,y])

Где:

• MEASURE представляет собой имя столбца показателя.
• X – это целое число, которое представляет собой смещение относительно текущего момента времени.
• Y – это целое число, которое представляет собой количество единиц времени, в течение которых вычисляется функция.
• HIERARCHY – это необязательный аргумент, который задает имя иерархии во временном измерении, например YR, MON, DAY, и который требуется использовать для вычисления интервала времени.

TODATE

SELECT Year_ID, Month_ID, TODATE (sales, year)

Вычисляет агрегированное значение показателя от начала периода времени до последнего периода времени (например, расчет с начала года).

Например, для расчета продаж с начала года используйте TODATE(sales, year).

TODATE(MEASURE, TIME_LEVEL)

Где:

• MEASURE представляет собой выражение, содержащее ссылку хотя бы на один столбец показателя, например продажи.
• TIME_LEVEL представляет собой временной интервал, который может быть годом, кварталом, месяцем, неделей или днем.