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

АппОптима собирает подробные данные сеанса пользователя каждый раз, когда пользователь взаимодействует с вашим контролируемым приложением. Эти данные включают все действия пользователя и данные о производительности высокого уровня. Используя Ключ-АТСРОМ API или язык запросов сеансов пользователя АппОптима (USQL), вы можете легко выполнять мощные запросы, сегментации и агрегации этих собранных данных. Чтобы помочь вам, в этой теме приведены подробные сведения о ключевых словах и функциях, синтаксисе, работе с таблицами мониторинга реальных пользователей, автоматизированных запросах и многом другом.

Язык запросов сеансов пользователей — это не [[wikipedia:SQL|'''''SQL''''']], и АппОптима не хранит данные сеансов пользователей в реляционной базе данных. Язык запросов сеансов пользователей — это язык запросов, специфичный для АппОптима, хотя он и опирается на некоторые концепции SQL, а синтаксис похож, что упрощает начало работы.

'''''Выберите один из подходов:'''''

== Запросы сеансов пользователя через веб-интерфейс АппОптима ==

# Перейдите в раздел '''SQL - запросы сессий''' .
# Введите запрос и нажмите на кнопку '''Выполнить запрос''' .

=== Выбор таймфрейма с помощью USQL ===
С помощью селектора таймфрейма данные сеанса пользователя можно фильтровать на основе выбранного таймфрейма анализа. Выберите новый таймфрейм.

[[Файл:Таймфрейм new.png|граница]]

==== Элементы управления выбором таймфрейма ====
Глобальный селектор временных рамок служит временным фильтром, который в большинстве случаев позволяет вам выбрать определенный временной интервал анализа, который сохраняется на всех страницах и в представлениях продуктов по мере навигации по вашему анализу.

[[Файл:Подробный Таймфрейм.png|граница]]

* Вкладка '''Пресеты''' содержит список всех доступных стандартных таймфреймов. Выберите один, чтобы изменить свой таймфрейм на этот предустановленный.
* Вкладка '''Custom''' отображает календарь. Щелкните начальный день, щелкните конечный день, а затем щелкните на кнопку '''Применить''', чтобы выбрать этот диапазон дней в качестве таймфрейма.
** Выбранные интервалы календаря устанавливаются на окончание в начале следующего дня (со временем, установленным на <code>00:00</code>). Например, если вы выбираете в календаре период с 3 по 4 сентября, временной интервал начинается 3 сентября в момент времени <code>00:00</code>и заканчивается 5 сентября в момент времени <code>00:00</code>, поэтому вы никогда не пропустите последнюю минуту временного диапазона. Вы можете редактировать отображаемое время.
* Вкладка '''Недавний''' отображает недавно использованные таймфреймы. Выберите один, чтобы вернуться к этому таймфрейму.
* Элементы управления '''<''' '''>''' сдвигают временной диапазон вперед или назад по времени. Шаг  — это длина исходного таймфрейма. Например, если текущий таймфрейм <code>Последние 2 часа</code> (двухчасовой диапазон, заканчивающийся сейчас), щелкните '''<''' , чтобы сместить таймфрейм на два часа назад, на <code>-4h to -2h</code> (двухчасовой диапазон, заканчивающийся два часа назад).
* Наведите курсор на таймфрейм, чтобы увидеть время начала, продолжительность и время окончания.  [[Файл:Курсор с таймфреймом.png|граница|172x172пкс]]

==== Выражения выбора таймфрейма ====
Если выбрать текущий таймфрейм в строке меню, отобразится редактируемое '''выражение таймфрейма'''.

* Если читать слева направо, выражение таймфрейма имеет начальное время, оператор <code>to</code> и конечное время.
* Если время окончания явно не указано, то подразумеваются <code>to</code> и <code>now</code>. Например, <code>-2h</code> это одно и то же <code>-2h to now</code>.
* Поддерживаемые единицы: <code>s</code>, <code>m</code>, <code>h</code>, <code>d</code>, <code>w</code>, <code>M</code>, <code>q</code>, <code>y</code> (также можно использовать целые слова, такие как <code>minutes</code>и <code>quarter</code>)

{| class="wikitable"
!Примеры выражений таймфрейма
!Значение
|-
|<code>today</code>
|От начала сегодняшнего дня до начала завтрашнего дня.
|-
|<code>yesterday</code>
|От начала вчерашнего дня до начала сегодняшнего дня. Нравится <code>-1d/d to today</code>.
|-
|<code>yesterday to now</code>
|С начала вчерашнего дня по текущее время сегодня.
|-
|<code>previous week</code>
|Предыдущие семь полных дней. Если сегодня понедельник, вы получаете "предыдущий понедельник по предыдущее воскресенье (вчера)".
|-
|<code>this year</code>
|Текущий календарный год, с 1 января текущего года <code>00:00</code>по 1 января следующего года <code>00:00</code>.
|-
|<code>last 6 weeks</code>
|Последние 42 дня (6 недель * 7 дней), заканчивающиеся сейчас. Эквивалентно <code>-6w to now</code>.
|-
|<code>-2h</code>
|От 2 часов (120 минут) назад до текущего времени (<code>now</code> уже подразумевается). Эквивалентно <code>Last 2 hours</code> и <code>-2h to now</code>.
|-
|<code>-4d to -1h30m</code>
|От 4 дней (96 часов) назад до 1,5 часов назад.
|-
|<code>-1w</code>
|Последние 7 дней (168 часов), с этого времени 7 дней назад до текущего времени (<code>now</code>). Эквивалентно <code>-7d</code>и <code>-168h</code>.
|-
|<code>-1w/w</code>
|С начала предыдущей календарной недели по текущий момент времени (сейчас).

* Если вы используете его <code>-1w/w</code>в пятницу днем в 3:00, вы получите диапазон 11 дней 15 часов, начиная с начала понедельника предыдущей недели, поскольку <code>/w</code>округление происходит до начала недели.
* Если вы использовали <code>-1w</code>without <code>/w</code>в пятницу днем в 3:00, то время начала будет ровно на 7 дней (168 часов) раньше: в предыдущую пятницу в 3:00 дня.

В общем случае, <code>/</code>используется в сочетании с единицей (например <code>/d</code>, <code>/w</code>, <code>/M</code>, , и <code>/y</code>) означает округление даты или времени до начала указанной единицы времени. Например, <code>-3d</code>означает ровно 72 часа назад, тогда как <code>-3d/d</code>означает три дня назад, округленное до ближайшего дня (начиная с времени <code>00:00</code>, начала дня). Используется <code>now/d</code>для обозначения начала сегодняшнего дня.
|-
|<code>-1w/w + 8h</code>
|Начиная с начала прошлой недели плюс 8 часов (8:00 утра понедельника).

* Обратите внимание, что вы можете использовать операторы <code>+</code>и <code>-</code>с единицами измерения, временными метками и т . д <code>now</code>.
|-
|<code>-1d/d+9h00m to -1d/d+17h00m</code>
|Часы работы вчера: с 09:00 до 17:00 (с 9:00 до 17:00).
|-
|<code>2020-08-16 21:28 to 2020-08-19 10:02</code>
|Абсолютный диапазон, состоящий из абсолютных дат и времени начала и окончания в <code>YYYY-MM-DD hh:mm</code>формате .

* Если вы указываете дату, но не указываете время (например, просто <code>2020-08-16</code>), предполагается, что время соответствует началу дня ( <code>00:00</code>)
* Если вы указываете время, но не указываете дату (например, просто <code>21:28</code>), предполагается, что дата сегодняшняя.
|-
|<code>1598545932346 to 1598837052346</code>
|Миллисекундные временные метки Unix.
|}

=== Автозаполнение с помощью USQL ===
Автозаполнение доступно для операторов запроса на основе текущего введенного текста. Автозаполнение является контекстно-зависимым и основано на текущем контексте курсора. Оно разумно предугадывает, какой текст вы захотите ввести следующим.

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

Список полей содержит только допустимые поля или функции для выбранной таблицы, а его контекстная зависимость отображает только числовые поля, когда курсор находится внутри вызова функции, которая работает только с числовыми данными, например <code>SUM()</code>, или <code>AVG()</code>.

Значения полей предлагаются только для полей, основанных на перечислении. Фактический запрос к Elasticsearch для автозаполнения не выполняется.

== API среды АппОптима ==
Вы можете выполнять вызовы API с помощью вашего предпочтительного клиента. Найдите соответствующую документацию API в разделе API сеансов пользователя .

Для выполнения этих вызовов вам необходимо разрешение User sessions (<code>DTAQLAccess</code>), назначенное вашему API-токену. Чтобы узнать, как получить и использовать ваш токен, см. [[Токены и аутентификация (API)|'''''АппОптима API - Токены и аутентификация''''']].

=== Таймфрейм API среды ===
Данные сеанса пользователя всегда должны быть доступны с таймфреймом. Доступ к большим таймфреймам может быть сложен из-за большого количества потенциальных одиночных совпадений с запросами.

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

Однако вы можете использовать поля времени, такие как <code>starttime</code>и <code>endtime</code>для выбора временных рамок. Вы также можете использовать эти поля в функциях, например, чтобы узнать, в какое время дня начинается большинство сеансов пользователей, как в <code>HOUR(starttime)</code>.

== Ключевые слова и функции ==
Для доступа к данным сеанса пользователя определены следующие ключевые слова:

<code>AND</code>, <code>AS</code>, <code>ASC</code>, <code>BETWEEN</code>, <code>BY</code>, <code>DESC</code>, <code>DISTINCT</code>, <code>FALSE</code>, <code>FROM</code>, <code>GROUP</code>, <code>IN</code>, <code>IS</code>, <code>JSON</code>, <code>LIMIT</code>, <code>NOT</code>, <code>NULL</code>, <code>OR</code>, <code>ORDER</code>, <code>SELECT</code>, <code>STARTSWITH</code>, <code>TRUE</code>, <code>WHERE</code>, <code>LIKE</code>, <code>FILTER</code>

Для доступа к данным сеанса пользователя определены следующие функции:

<code>SUM</code>, <code>MAX</code>, <code>MIN</code>, <code>AVG</code>, <code>MEDIAN</code>, <code>COUNT</code>, <code>YEAR</code>, <code>MONTH</code>, <code>DAY</code>, <code>HOUR</code>, <code>MINUTE</code>, <code>DATETIME</code>, <code>TOP</code>, <code>PERCENTILE</code>, <code>KEYS</code>

Ключевые слова, функции и имена столбцов нечувствительны к регистру. Соответствия строк в условиях <code>WHERE</code> чувствительны к регистру.

== Синтаксис ==
Типичный запрос строится из следующих ключевых слов:

<code>SELECT <columns> FROM <nowiki><table> WHERE <condition> GROUP BY <grouping> ORDER BY <ordering></nowiki></code>

Однако единственными обязательными элементами являются <code>SELECT <columns></code>и <code>FROM <nowiki><table></nowiki></code>.

'''''Пример'''''

<code>SELECT browserType, userId, city, AVG(userActionCount) AS "Average user action count", AVG(duration) AS "Average duration", count(*) AS "Sessions", SUM(totalErrorCount) AS "Errors" FROM usersession WHERE ip between '52.179.11.1' and '52.179.11.255' GROUP BY browserType, userId, city</code>

=== Часто используемые ключевые слова ===

==== SELECT <code><columns></code> ====
Выбирает один или несколько столбцов из указанной таблицы данных или выполняет функции агрегации из набора поддерживаемых функций.

<code>columns: [DISTINCT] <column>, <column>, ... | function(<parameter>) |</code>

<code><column> AS <alias> | JSON</code>

'''''Пример'''''

<code>SELECT country, city, browserfamily FROM usersession</code>

<code>SELECT DISTINCT country, city, useractioncount FROM usersession</code>

<code>SELECT country, city, avg(duration) AS average FROM usersession GROUP BY country, city</code>

==== FUNNEL ====
Позволяет использовать предопределенный формат '''FUNNEL''' для запроса. Может использоваться для построения графика потока определенных действий пользователя. Также может сочетаться с пользовательскими свойствами сеанса и другими условиями.

Он изменяет синтаксис любого запроса на следующий:

<code>SELECT FUNNEL (<condition> AS <alias>, <condition>, ...) FROM <nowiki><table> WHERE <condition></nowiki></code>

* Для <code>FUNNEL</code>запросов не используйте функции <code>SELECT *</code> или ключевые слова, такие как <code>JSON</code>.
* В настоящее время в <code>FUNNEL</code> не допускаются операторы , <code>GROUP BY</code>, <code>ORDER BY</code>или .<code>LIMIT</code>
* <code>FUNNEL</code>не поддерживает упорядочивание. Нет гарантии, что это <code>useraction1</code>произошло раньше <code>useraction2</code>для <code>SELECT FUNNEL (useraction.name = "useraction1", useraction.name = "useraction2") FROM usersession</code>запроса. Этот запрос является эквивалентом только двух <code>SELECT</code>операторов, как поясняется в примерах ниже.

'''''Пример 1'''''

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

<code>SELECT COUNT(*) FROM usersession where useraction.name = "AppStart"</code>

<code>SELECT COUNT(*) FROM usersession where useraction.name = "AppStart" AND useraction.name = "searchJourney"</code>

<code>SELECT COUNT(*) FROM usersession where useraction.name = "AppStart" AND useraction.name = "searchJourney"  AND useraction.name = "bookJourney"</code>

Следующий запрос возвращает тот же результат:

<code>SELECT FUNNEL (useraction.name = "AppStart", useraction.name = "searchJourney", useraction.name = "bookJourney")</code>

<code>FROM usersession</code>

'''''Пример 2'''''

Чтобы просмотреть количество пользователей, успешно завершивших <code>bookJourney</code>:

<code>SELECT FUNNEL (useraction.name="login", useraction.name = "searchJourney", useraction.name = "bookJourney")</code>

<code>FROM usersession</code>

==== FROM <code><nowiki><table></nowiki></code> ====
Вы можете указать только одну таблицу. Таблицы для данных сеанса пользователя следующие.

* <code>usersession</code> содержит информацию о сеансах пользователей .
* <code>useraction</code> хранит данные о действиях пользователя .
* <code>userevent</code> предоставляет информацию о событиях пользователя , таких как изменение страницы или события ярости.
* <code>usererror</code> содержит больше данных о событиях ошибок , т.е. об ошибках и сбоях.

'''''Пример'''''

<code>SELECT country, city, browserfamily FROM usersession</code>

<code>SELECT name, starttime, endtime, duration FROM useraction ORDER BY duration DESC</code>

==== WHERE <code><condition></code> ====
Вы можете объединить несколько условий, используя булеву логику и скобки в <code>WHERE</code>предложении, например, <code>WHERE (city = 'Barcelona' AND country = 'Spain')</code>чтобы включить только города с названием Барселона, которые находятся в Испании.

<code>condition: (condition AND condition) | (condition OR condition) | field IN(...) |</code>

<code>field IS <value> | field IS NULL | field = <value> | field > <value> | field < <value> |</code>

<code>field <> <value> | field IS NOT <value> | field BETWEEN <value> AND <value> | ...</code>

Однако только правая часть условий может содержать значение, поэтому сравнивать два поля нельзя.

'''''Пример'''''

<code>SELECT country, city, browserfamily FROM usersession WHERE country = 'Albania' AND screenWidth > 1000</code>

<code>SELECT TOP(country, 20), TOP(city, 20), TOP(duration, 10), AVG(duration) AS average</code>

<code>FROM usersession</code>

<code>WHERE duration BETWEEN 1000 AND 2000</code>

<code>GROUP BY TOP(country, 20), TOP(city, 20), TOP(duration, 10)</code>

==== GROUP BY <code><grouping></code> ====
При агрегировании полей необходимо указать соответствующие ключевые слова <code>GROUP BY</code> , указывающие, как будет выполняться агрегирование.

<code>grouping: <column>, ...</code>

'''''Пример'''''

<code>SELECT city, count(*) FROM usersession GROUP BY city</code>

<code>SELECT MONTH(starttime) as month, count (*) FROM usersession</code>

<code>GROUP BY month</code>

==== LIMIT <code><limit></code> ====
Позволяет ограничить количество возвращаемых результатов. Например, вы можете выбрать только 10 лучших результатов, когда это объединено с заказом.

Фреймворк всегда применяет верхний предел для предотвращения перегрузки системы. Если не используется <code>LIMIT</code> , по умолчанию возвращается 50 результатов.

'''''Пример'''''

<code>SELECT city, starttime FROM usersession ORDER BY starttime DESC LIMIT 10</code>

<code>LIMIT</code> может также использоваться для увеличения количества результатов в случаях, когда <code>LIMIT</code>условие отсутствует, поскольку тогда применяется ограничение по умолчанию.

==== ORDER BY <code><ordering></code> ====
Позволяет упорядочить результаты по столбцам, в порядке возрастания или убывания. Порядок будет возрастающим, если не указано иное.

Упорядочение выполняется по частоте. Например, 5 верхних возвращаемых городов являются наиболее часто встречающимися. Указав поле в предложении <code>ORDER BY</code>, вы можете добавить значение сортировки для строк, дат и чисел.

Сортировка по <code>enums</code> или по <code>function values</code> таким как <code>AVG</code>и <code>SUM</code> упорядочивает возвращаемые результаты, но вы можете не получить верхние элементы. Например, если вы запросите верхние 5 результатов по <code>AVG(duration)</code>, запрос только 10 может добавить результаты даже наверху.

<code>ordering: <column> ASC | <column> DESC | <column>, ...</code>

'''''Пример 1'''''

<code>SELECT useraction.name, starttime FROM usersession ORDER BY starttime DESC</code>

'''''Пример 2'''''

Вы можете упорядочить подсчеты, добавив ключевое слово <code>DISTINCT</code>.

<code>SELECT DISTINCT city, COUNT(*) FROM usersession ORDER BY COUNT(*) DESC</code>

'''''Пример 3'''''

<code>SELECT avg(duration) AS average, count(*) as number, day(startTime) as startDay</code>

<code>FROM usersession where duration < 2000</code>

<code>GROUP BY startTime</code>

<code>ORDER BY average</code>

или

<code>SELECT avg(duration) AS average, count(*) as number, day(startTime) as startDay</code>

<code>FROM usersession where duration < 2000</code>

<code>GROUP BY startTime</code>

<code>ORDER BY number DESC, average ASC</code>

==== LIKE ====
Позволяет сравнивать данные с выражением, используя подстановочные знаки для соответствия указанному шаблону. Можно использовать следующие символы:

* <code>%</code>или <code>*</code>: Соответствует любой строке из 0 или более символов
* <code>?</code>: Соответствует любому отдельному символу

Строковые значения чувствительны к регистру. Например, <code>SELECT city FROM usersession WHERE userId LIKE "*astromkey*"</code>соответствует <code>me@astromkey.com</code>, но не <code>me@asTromKey.com</code>. Чтобы избежать этого, используйте подстановочный знак <code>?</code>, как в этом примере:<code>SELECT city FROM usersession WHERE userId LIKE "*astromkey*"</code>

Экранирование подстановочных знаков

Чтобы экранировать подстановочный символ, добавьте перед ним обратную косую черту <code>\</code>. Например, <code>\%</code>, <code>\*</code>, и <code>\?</code> рассматриваются как стандартные строковые литералы <code>%</code>, <code>*</code>, и <code>?</code>.

Чтобы экранировать сам обратный слеш <code>\</code>, добавьте перед ним еще один обратный слеш <code>\</code>. Полученная запись <code>\\</code> рассматривается как один обратный слеш <code>\</code>.

Если вы добавляете две обратные косые черты <code>\\</code> перед подстановочным символом (что приводит к записям типа <code>\\%</code>, <code>\\*</code>или <code>\\?</code>), такая запись рассматривается как одна экранированная обратная косая черта <code>\</code> и один подстановочный символ. Например, <code>\\*</code>запись соответствует <code>\abc</code>, <code>\123ABC</code>или <code>\</code>.

Краткое описание того, как экранировать подстановочные знаки:
{| class="wikitable"
!Вход
!Рассматривается как
!Совпадения
|-
|<code>\%</code>
|<code>%</code>
|<code>%</code>
|-
|<code>\*</code>
|<code>*</code>
|<code>*</code>
|-
|<code>\?</code>
|<code>?</code>
|<code>?</code>
|-
|<code>\\</code>
|<code>\</code>
|<code>\</code>
|-
|<code>\\%</code>
|<code>\</code>и любая строка из нуля или более символов
|<code>\abc</code>, <code>\123ABC</code>, <code>\</code>, и т. д.
|-
|<code>\\*</code>
|<code>\</code>и любая строка из нуля или более символов
|<code>\abc</code>, <code>\123ABC</code>, <code>\</code>, и т. д.
|-
|<code>\\?</code>
|<code>\</code>и любой отдельный символ
|<code>\a</code>, <code>\1</code>, <code>\A</code>, и т. д.
|}
'''''Примеры экранирования подстановочных знаков:'''''

''Запрос соответствует , <code>userId</code>что равно <code>AU%40KWM</code> :'' 

<code>SELECT userId FROM usersession WHERE userId LIKE "AU\%40KWM"</code>

''Запрос соответствует , <code>userId</code>что равно <code>AU*40KWM</code> :'' 

<code>SELECT userId FROM usersession WHERE userId like "AU\*40KWM"</code>

''Запрос ищет значение , <code>userId</code>равное <code>AU?40KWM</code> :'' 

<code>SELECT userId FROM usersession WHERE userId LIKE "AU\?40KWM"</code>

''Запрос содержит одну экранированную обратную косую черту <code>\</code>и один подстановочный знак <code>%</code>, поэтому запрос соответствует, <code>userId</code>например <code>AU\40KWM</code>, <code>AU\abcd40KWM</code>, <code>AU\ab12340KWM</code>, или <code>AU\777_12340KWM</code> :'' 

<code>SELECT userId FROM usersession WHERE userId LIKE "AU\\%40KWM"</code>

'''''Запросы, содержащие 11+ условий LIKE с непересекающимися подстановочными знаками, отклоняются'''''

Запросы USQL, содержащие 11 или более <code>LIKE</code>условий в начале <code>*</code>или <code>%</code>внутри шаблона поиска (но не в конце), отклоняются из выполнения.

Обычно мы просто подсчитываем количество <code>LIKE</code>условий, используемых в запросе. Например, <code>LIKE</code>в запросе ниже пять условий — мы подсчитываем каждое вхождение <code>LIKE</code>в <code>WHERE</code>предложении и <code>CONDITION</code>функции.

<code>SELECT CONDITION(COUNT(userSessionId), WHERE useraction.name LIKE '*search.html'),</code>

<code>       CONDITION(COUNT(userSessionId), WHERE useraction.name LIKE '*booking-payment1.html')</code>

<code>FROM usersession</code>

<code>WHERE city LIKE "%York"</code>

<code>    OR city LIKE "S*Francisco"</code>

<code>    AND city LIKE "L*inz"</code>

Однако при использовании функции <code>FUNNEL</code> расчет становится более сложным. Для этой функции мы внутренне преобразуем один запрос в несколько запросов. После этого преобразования мы подсчитываем количество условий <code>LIKE</code> в этих внутренне преобразованных запросах.

'''''Например, следующий запрос:'''''

<code>SELECT FUNNEL (useraction.name LIKE "*start", useraction.name LIKE "Jou%rney", useraction.name LIKE "bookJourn*ey") FROM usersession</code>

''изменяется на следующие три запроса:''

<code>SELECT COUNT(*) FROM usersession where useraction.name LIKE "*start"</code>

<code>SELECT COUNT(*) FROM usersession where useraction.name LIKE "*start" AND useraction.name LIKE "Jou%rney"</code>

<code>SELECT COUNT(*) FROM usersession where useraction.name LIKE "*start" AND useraction.name LIKE "Jou%rney" AND useraction.name LIKE "bookJourn*ey"</code>

Это означает, что в приведенном выше запросе <code>FUNNEL</code> на самом деле шесть условий <code>LIKE</code> .

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

'''''Пример'''''

<code>SELECT useraction.application,</code>

<code>AVG(usersession.doubleProperties.bookings)</code>

<code>FILTER > 1500</code>

<code>FROM usersession</code>

<code>WHERE usersession.doubleProperties.bookings IS NOT NULL</code>

<code>GROUP BY useraction.application</code>

* Функции <code>WHERE</code> и <code>FILTER</code> не являются взаимозаменяемыми. Хотя вы можете использовать функцию <code>WHERE</code> только для абсолютных значений, функция <code>FILTER</code> работает и для агрегированных значений.

=== Часто используемые функции ===

==== MIN(field) ====
Запрашивает минимальное значение числового поля или поля даты.

'''''Пример'''''

<code>SELECT MIN(duration), MAX(duration), AVG(duration), MEDIAN(duration)</code>

<code>FROM usersession</code>

==== MAX(field) ====
Запрашивает максимальное значение числового поля или поля даты.

'''''Пример'''''

<code>SELECT MIN(duration), MAX(duration), AVG(duration), MEDIAN(duration)</code>

<code>FROM usersession</code>

==== AVG(field) ====
Запрашивает среднее значение числового поля или поля даты. Может иметь значение <code>NaN</code>, если поле всегда <code>null</code>.

'''''Пример'''''

<code>SELECT MIN(duration), MAX(duration), AVG(duration), MEDIAN(duration)</code>

<code>FROM usersession</code>

==== MEDIAN(field) ====
Запрашивает медианное значение числового поля или поля даты.

'''''Пример'''''

<code>SELECT MIN(duration), MAX(duration), AVG(duration), MEDIAN(duration)</code>

<code>FROM usersession</code>

==== SUM(field) ====
Вычисляет сумму числового поля.

'''''Пример'''''

<code>SELECT TOP(name, 20), SUM(duration) FROM useraction</code>

<code>GROUP BY name</code>

==== COUNT(field), COUNT(*), COUNT(DISTINCT field) ====
Подсчитывает количество совпадающих строк.

* <code>COUNT(*)</code>: Подсчитывает количество совпадающих элементов.
* <code>COUNT(<field>)</code>: Подсчитывает количество совпадающих элементов, где <code><field></code> не равно нулю.
* <code>COUNT(DISTINCT <field>)</code>: Подсчитывает количество различных значений <code><field></code> в выбранных элементах.
'''''Пример'''''

<code>SELECT country, COUNT(*), COUNT(city), COUNT(DISTINCT city)</code>

<code>FROM usersession</code>

<code>GROUP BY country</code>

Результаты, возвращаемые функцией, <code>COUNT(DISTINCT <field>)</code>являются приблизительными, чтобы предотвратить высокое использование памяти. Если <code>COUNT(DISTINCT <field>)</code>используется в поле с высокой кардинальностью, результаты могут быть еще более грубыми. Поля с высокой кардинальностью — это те поля, которые имеют всего несколько дубликатов.

'''''Поля с высокой кардинальностью'''''
{| class="wikitable"
!Table
!Fields
|-
|<code>usersession</code>
|<code>ip</code> , <code>userSessionId</code> , <code>internalUserId</code> , <code>userId</code>
|}
АппОптима отклоняет и не выполняет запросы, <code>COUNT(DISTINCT <field>)</code> которые могут потреблять много памяти. Это происходит для всех полей с чрезвычайно высокой кардинальностью, например, для <code>dateTime</code> полей типа <code>usersession.startTime</code>, <code>usersession.endTime</code> или <code>useraction.networkTime</code>.

'''''Поля с чрезвычайно высокой кардинальностью'''''
{| class="wikitable"
!Table
!Fields
|-
|<code>usersession</code>
|<code>startTime</code> , <code>endTime</code> , <code>replayEnd</code> , <code>clientTimeOffset</code>, <code>duration</code> , <code>replayStart</code>
|-
|<code>useraction</code>
|<code>domContentLoadedTime</code> , <code>startTime</code> , <code>firstPartyBusyTime</code> , <code>documentInteractiveTime</code> , <code>navigationStart</code> , <code>totalBlockingTime</code> '''''deprecated''''', <code>largestContentfulPaint</code> , <code>visuallyCompleteTime</code> , <code>cdnBusyTime</code> , <code>endTime</code> , <code>domCompleteTime</code> , <code>networkTime</code> , <code>loadEventStart</code> , <code>serverTime</code> , <code>firstInputDelay</code> , <code>responseStart</code> , <code>thirdPartyBusyTime</code> , <code>duration</code> , <code>loadEventEnd</code> , <code>responseEnd</code> , <code>frontendTime</code> , <code>requestStart</code>
|-
|<code>userevent</code>
|<code>startTime</code>
|-
|<code>usererror</code>
|<code>startTime</code>
|}
'''''Пример'''''

<code>SELECT country, COUNT(*), COUNT(city), COUNT(DISTINCT city)</code>

<code>FROM usersession</code>

<code>GROUP BY country</code>

==== TOP(field, n) ====
Возвращает верхние результаты <code><n></code> из поля. Значение по умолчанию <code>1</code> (верхнее значение), если <code>n</code> не указано.

'''''Пример'''''

<code>SELECT TOP(name, 20), SUM(duration)</code>

<code>FROM useraction</code>

<code>GROUP BY name</code>

Если выбрано <code>TOP(<field>, n)</code> и результаты сгруппированы, но <code><field></code> не являются частью группировки, первые n элементов возвращаются в виде списка в одном поле.

<code>SELECT TOP(country, 20), TOP(city, 3), COUNT(*)</code>

<code>FROM usersession</code>

<code>GROUP BY country</code>

==== YEAR(datefield), MONTH(datefield), DAY(datefield), HOUR(datefield), MINUTE(datefield) ====
Возвращает заданный элемент, извлеченный из поля даты.

* <code>YEAR</code>: Четырехзначный год.
* <code>MONTH</code>: Номер месяца, от 1 до 12
* <code>DAY</code>: День месяца, от 1 до 31.
* <code>HOUR</code>: Значение часа от 0 до 23.
* <code>MINUTE</code>: Значение минут от 0 до 59.

'''''Пример'''''

<code>SELECT starttime,</code>

<code>DATETIME(starttime), YEAR(starttime), MONTH(starttime), DAY(starttime), HOUR(starttime), MINUTE(starttime)</code>

<code>FROM usersession</code>

<code>ORDER BY starttime DESC</code>

==== DATETIME(datefield [, format [, interval]]) ====
Форматирует выбранное поле даты с заданной строкой формата. Формат по умолчанию — <code>yyyy-MM-dd HH:mm</code>.

Допустимые буквы в строке формата:

* <code>y</code>: год
* <code>M</code>: месяц
* <code>d</code>: день месяца
* <code>H</code>: час (0-23)
* <code>h</code>: час (1-12)
* <code>m</code>: минута
* <code>s</code>: второй
* <code>E</code>: день недели (пн-вс)

Интервалы <code>year</code> | <code>month</code> | <code>week</code> предназначены для одного <code>interval</code>. Для <code>d</code>(дней), <code>h</code>(часов), <code>m</code>(минут) или <code>s</code>(секунд) можно использовать число, за которым следует буква для строки формата, например <code>5m</code>. Например, <code>SELECT DISTINCT DATETIME(starttime, 'HH:mm', '5m'), COUNT(*) FROM usersession</code> подсчитывает сеансы в пятиминутных временных блоках.

'''''Пример'''''

<code>SELECT DATETIME(starttime, 'yyyy-MM') FROM usersession</code>

<code>SELECT DISTINCT DATETIME(starttime, 'HH:mm', '5m'), COUNT(*) FROM usersession</code>

Подобно другим функциям даты ( <code>YEAR</code>, <code>MONTH</code>, <code>DAY</code>, <code>HOUR</code>, и <code>MINUTE</code>), вы можете использовать его <code>DATETIME</code> для форматирования результата (даже результата других функций, таких как <code>MAX</code>, <code>MIN</code>, <code>AVG</code>, или <code>CONDITION</code>), создания гистограмм или получения списка временных меток, где есть результаты, например, дни недели, когда использовалось приложение.

'''''Пример'''''

<code>SELECT application, DATETIME(MAX(starttime)) AS LastUsedTime FROM useraction GROUP BY application</code>

<code>SELECT DATETIME(starttime, "HH") AS hourOfDay, COUNT(*) FROM usersession GROUP BY hourOfDay</code>

<code>SELECT application, DATETIME(starttime, "E") AS daysOfWeek FROM useraction GROUP BY application</code>

<code>SELECT DATETIME(CONDITION(MAX(startTime), WHERE name = "index.jsp")) FROM useraction</code>

==== CONDITION(function, condition) ====
Позволяет комбинировать несколько функций с различными условиями.

Допустимые функции в строке формата следующие:

* <code>MIN()</code>
* <code>MAX()</code>
* <code>AVG()</code>
* <code>SUM()</code>
* <code>PERCENTILE()</code>
* <code>MEDIAN()</code>
* <code>COUNT()</code>

Вы можете объединить несколько условий, используя булеву логику и скобки с <code>CONDITION</code>функцией, например, <code>CONDITION(COUNT(*), WHERE city = 'Barcelona' AND country = 'Spain')</code>включить только города с названием Барселона, которые находятся в Испании.

<code>CONDITION(function, condition)</code>


<code>condition:</code>

<code>(condition AND condition) | (condition OR condition) | field IN(...) |</code>

<code>field IS <value> | field IS NULL | field = <value> | field > <value> | field < <value> |</code>

<code>field <> <value> | field IS NOT <value> | field BETWEEN <value> AND <value> | ...</code>

Вы также можете использовать <code>FILTER</code> фильтр предложений для функций , имеющих числовые значения, тем самым отображая только определенные результаты агрегаций.

<code>SELECT CONDITION(COUNT(usersessionId), WHERE userActionCount > 2 AND useraction.name = "search.jsp") FILTER > 1000, city FROM usersession GROUP BY city</code>

'''''Пример'''''

<code>SELECT CONDITION(COUNT(usersessionId), WHERE userActionCount > 2 AND useraction.name = "search.jsp") FROM usersession</code>


<code>SELECT CONDITION(SUM(usersession.duration), WHERE name = "index.jsp") AS c1, CONDITION(SUM(usersession.duration), WHERE name = "search.jsp") AS c2, CONDITION(SUM(usersession.duration), WHERE name IS NOT "index.jsp" AND name IS NOT "search.jsp") AS c3 FROM useraction WHERE (duration > 1000 OR usersession.userActionCount > 4)</code>


<code>SELECT CONDITION(SUM(usersession.duration), WHERE name = "index.jsp") AS c1 FROM useraction WHERE (duration > 1000 OR usersession.userActionCount > 4) ORDER BY c1</code>


<code>SELECT DATETIME(CONDITION(MIN(startTime ), WHERE useraction.application = "RUM Default Application" ), "yyyy-MM-dd" ) FROM usersession</code>

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

'''''Пример'''''

<code>SELECT name, usersession.country, usersession.browserFamily,</code>

<code>AVG(duration),</code>

<code>MEDIAN(duration),</code>

<code>PERCENTILE(duration, 99)</code>

<code>FROM useraction</code>

<code>WHERE useraction.name = "easytravel/rest/login"</code>

<code>GROUP BY usersession.country, usersession.browserFamily, name</code>

<code>ORDER BY usersession.continent</code>

==== KEYS(customProperty) ====
Возвращает ключи действий пользователя или свойства сеанса пользователя в соответствии с типом данных свойства, определенным в аргументе.

Проверьте таблицу ниже, чтобы понять, возвращаются ли ключи свойств действий пользователя или ключи свойств сеанса пользователя.
{| class="wikitable"
!KEYS(customProperty)
!Table
!Action properties
!Session properties
|-
|<code>KEYS(<dataType>Properties)</code>
|<code>useraction</code>
| +
|
|-
|<code>KEYS(<dataType>Properties)</code>
|<code>usersession</code>
|
| +
|-
|<code>KEYS(useraction.<dataType>Properties)</code>
|<code>useraction</code>
| +
|
|-
|<code>KEYS(useraction.<dataType>Properties)</code>
|<code>usersession</code>
| +
|
|-
|<code>KEYS(usersession.<dataType>Properties)</code>
|<code>useraction</code>
|
| +
|-
|<code>KEYS(usersession.<dataType>Properties)</code>
|<code>usersession</code>
|
| +
|}
Часть <code><dataType></code> функции может принимать следующие значения:

* <code>string</code>
* <code>long</code>
* <code>double</code>
* <code>date</code>

'''''Пример 1'''''

<code>SELECT KEYS(stringProperties) FROM useraction WHERE application = "easyTravel demo application"</code>

<code>SELECT KEYS(useraction.longProperties) FROM usersession WHERE applicationType="WEB_APPLICATION" ORDER BY keys(useraction.longProperties)</code>

<code>SELECT KEYS(usersession.stringProperties) FROM useraction WHERE usersession.city ="Berlin"</code>


Для извлечения отдельных ключей действия или свойств сеанса используйте <code>DISTINCT KEYS(customProperty)</code>.


'''''Пример 2'''''

<code>SELECT DISTINCT KEYS(stringProperties) FROM useraction WHERE useraction.application = "easyTravel demo application" ORDER BY keys(stringProperties)</code>

<code>SELECT DISTINCT KEYS(doubleProperties) FROM usersession</code>

== Математические операции ==
В рамках запросов поддерживаются следующие операции:

* операции над числами
* операции над числовыми полями и полями '''dateTime'''
* операции над определенными функциями, такими как <code>YEAR</code>, <code>MONTH</code>, <code>DAY</code>, <code>HOUR</code>,<code>MINUTE</code>
* операции над числовыми значениями и их отображение в различных вариантах использования измерений

=== Синтаксис ===
<code>Number/NumericField/DateTimeField/Function OPERATOR Number/NumericField/DateTimeField/Function</code>

Функция: <code>YEAR</code>, <code>MONTH</code>, <code>DAY</code>, <code>HOUR</code> или <code>MINUTE</code> Оператор: <code>+</code>, <code>-</code>, <code>*</code>, <code>/</code>, <code>%</code>, или <code>MOD</code>

'''''Пример'''''

<code>SELECT 7 + 80 * 100, duration + startTime, MONTH(startTime) - 1</code>

<code>FROM usersession</code>

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

=== Базовые операторы ===
Основными операторами сравнения являются <code>=</code>, <code>!=</code>, <code><></code>, <code><</code>, <code>></code>, <code><=</code>, <code>>=</code>, <code>IS</code>, и <code>IS NOT</code>.

Чтобы проверить наличие значения поля, сравните поле с <code>NULL</code>.

'''''Пример'''''

<code>SELECT userId FROM usersession WHERE userActionCount > 3</code>

=== Диапазоны ===
Диапазоны обрабатываются с помощью ключевых слов, таких как <code>BETWEEN</code> или <code>NOT BETWEEN</code>, <code><lowerLimit></code> и <code><upperLimit></code>.

'''''Пример 1'''''

<code>SELECT DISTINCT ip FROM usersession</code>

<code>WHERE ip BETWEEN '192.168.0.0' AND '192.168.255.255'</code>

'''''Пример 2'''''

<code>SELECT startTime FROM useraction</code>

<code>WHERE NOT startTime BETWEEN $NOW - DURATION("2h") AND $NOW</code>

'''''Пример 3'''''

<code>SELECT ip, browserType, userId, city</code>

<code>FROM usersession</code>

<code>WHERE NOT ip BETWEEN '52.179.11.1' AND '52.179.11.255'</code>

==== Сеты ====
Строковое <code>"STARTSWITH"</code> условие проверяет, начинается ли строка или поле перечисления с указанного текста.

'''''Пример'''''

<code>SELECT userId FROM usersession WHERE city IN ("NEW YORK", "San Francisco")</code>

=== Строковые условия ===
Строковое <code>"STARTSWITH"</code> условие проверяет, начинается ли строка или поле перечисления с указанного текста.

'''''Пример'''''

<code>SELECT city FROM usersession WHERE userId STARTSWITH "astromkey"</code>

=== Значения даты и времени ===
При выполнении условий для поля даты и времени поддерживаются следующие форматы значений:
{| class="wikitable"
!Формат
!Описание
!Пример
|-
|—
|Временная метка '''Unix''' как число в миллисекундах
|<code>1514152800000</code>
|-
|<code>yyyy-MM-dd'T'HH:mm:ssZ</code>
|'''ISO datetime''' с часовым поясом
|<code>2017-12-24T21:00:00+01:00</code>
|-
|<code>yyyy-MM-dd HH:mm:ss</code>
|Дата с дополнительным временем
|<code>2017-12-24 21:00</code>
|-
|<code>yyyy/MM/dd HH:mm:ss</code>
|Дата с дополнительным временем
|<code>2017/12/24 21</code>
|-
|<code>MM/dd/yyyy HH:mm:ss</code>
|Дата с дополнительным временем
|<code>12/24/2017</code>
|-
|<code>dd.MM.yyyy HH:mm:ss</code>
|Дата с дополнительным временем
|<code>24.12.2017 21:00:00</code>
|}
Для форматов, где время необязательно, поддерживаются следующие форматы времени:
{| class="wikitable"
!Формат
!Пример
|-
|<code>HH:mm:ss</code>
|<code>08:20:59</code>
|-
|<code>H:mm:ss</code>
|<code>8:20:59</code>
|-
|<code>HH:mm</code>
|<code>08:20</code>
|-
|<code>H:mm</code>
|<code>8:20</code>
|-
|<code>HH</code>
|<code>08</code>
|-
|<code>H</code>
|<code>8</code>
|}
Если время отсутствует, предполагается значение по умолчанию <code>00:00:00</code>.

Иногда запросы со значениями '''datetime''' могут давать неверные результаты из-за преобразования летнего времени. Если дата в запросе предшествует дате окончания летнего времени (например, до 7 ноября 2021 г. 02:00), попробуйте использовать '''ISO datetime''' со смещением времени, например, <code>2021-10-05T17:30:00+03:00</code>.

'''''Пример'''''

<code>SELECT starttime FROM usersession WHERE starttime > "8.8.2018 8:00"</code>

=== Оптимизация условий ===

==== IN ====
Если ваш запрос содержит несколько условий "равно" для одного и того же поля через <code>OR</code>, используйте функцию <code>IN</code> вместо этого, так как она более производительна. Например, вы можете переписать следующий запрос, используя функцию <code>IN</code>.

'''''Пример ДО'''''

<code>SELECT COUNT(*) FROM userevent</code>

<code>WHERE pageReferrer = "/some/page/referrer/1"</code>

<code>  OR pageReferrer = "/some/page/referrer/2"</code>

<code>  OR pageReferrer = "/some/page/referrer/3"</code>

<code>  OR pageReferrer = "/some/page/referrer/4"</code>

<code>  OR pageReferrer = "/some/page/referrer/5"</code>

'''''Пример ПОСЛЕ'''''

<code>SELECT COUNT(*) FROM userevent</code>

<code>WHERE pageReferrer IN ("/some/page/referrer/1",</code>

<code>  "/some/page/referrer/2",</code>

<code>  "/some/page/referrer/3",</code>

<code>  "/some/page/referrer/4",</code>

<code>  "/some/page/referrer/5")</code>

==== NOT IN ====
Чтобы оптимизировать скорость выполнения запросов, используйте массивы для запросов: вместо использования нескольких операторов <code>NOT</code>, <code><></code> или <code>!=</code> используйте оператор <code>NOT IN</code> .

'''''Пример ДО'''''

<code>SELECT useraction.name, usersession.userId</code>

<code>FROM useraction</code>

<code>WHERE name = "loading of page /"</code>

<code>  AND usersession.userId IS NOT NULL</code>

<code>    AND usersession.userId <> "Speed Travel Agency"</code>

<code>    AND usersession.userId <> "some user"</code>

<code>    AND usersession.userId <> "easyTravel - One step to happiness"</code>

<code>    AND usersession.userId <> "easyTravel - Booking - Finish"</code>

'''''Пример ПОСЛЕ'''''

<code>SELECT useraction.name, usersession.userId</code>

<code>FROM useraction</code>

<code>WHERE name = "loading of page /"</code>

<code>  AND usersession.userId IS NOT NULL</code>

<code>    AND NOT usersession.userId IN ("Speed Travel Agency",</code>

<code>    "some user",</code>

<code>    "easyTravel - One step to happiness",</code>

<code>    "easyTravel - Booking - Finish")</code>

== Расширенные синтаксические конструкции ==

=== Запрос диапазонов IP-адресов ===
Поле IP может быть запрошено для диапазонов адресов. Оба варианта <code>BETWEEN ip > <lower ipaddress range> AND ip < <upper ipaddress range></code> и <code>BETWEEN <lower ipaddress range> AND <lower ipaddress range></code>работают.

'''''Пример'''''

<code>SELECT * FROM usersession WHERE ip > '211.44.94.0' AND ip < '212.113.5.0'</code>

<code>SELECT * FROM usersession WHERE ip BETWEEN '211.44.94.0' AND '212.113.5.0'</code>

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

* <code>TIME_FRAME_START</code>
* <code>TIME_FRAME_END</code>

'''''Пример'''''

<code>SELECT * FROM usersession WHERE startTime >= $TIME_FRAME_START AND endTime < $TIME_FRAME_END</code>

Селекторы таймфреймов можно использовать для ограничения таймфреймов запросов, которые выполняются на вторичных таблицах (<code>useraction</code>). По умолчанию фильтр таймфрейма применяется к таблице <code>usersession</code> , даже если запрос выполняется на любой вторичной таблице. Чтобы применить фильтр также и к вторичной таблице, можно использовать селектор таймфреймов для добавления условия к полю вторичной таблицы <code>startTime</code> . См. следующий пример для извлечения <code>name</code>и <code>duration</code>действий пользователя, которые произошли только в течение таймфрейма запроса:

'''''Пример'''''

<code>SELECT name, duration FROM useraction</code>

<code>WHERE startTime BETWEEN $TIME_FRAME_START and $TIME_FRAME_END</code>

=== Запрос относительного таймфрейма ===
Вы можете выбрать временные рамки относительно времени выполнения запроса. Текущее время выражается переменной <code>$NOW</code>.

<code>$NOW [+/-] DURATION("[number]TIME_UNIT")</code>

Для выражения продолжительности поддерживаются следующие единицы времени:

* <code>y</code>: год
* <code>q</code>: четверть
* <code>M</code>: месяц
* <code>d</code>: день
* <code>w</code>: неделя
* <code>h</code>: час
* <code>m</code>: минута
* <code>s</code>: секунда

'''''Пример'''''

<code>SELECT * FROM usersession WHERE startTime >= $NOW - DURATION("1q") AND endTime <= $NOW</code>

<code>SELECT * FROM useraction WHERE startTime BETWEEN $NOW - DURATION("2h") AND $NOW</code>

<code>SELECT * FROM useraction WHERE usersession.startTime >= $TIME_FRAME_START - DURATION("2h") AND $NOW - DURATION("1h")</code>

=== Вторичные таблицы для <code>usersession</code>, <code>useraction</code>, <code>userevent</code>, и <code>usererror</code> ===
При использовании <code>SELECT</code> с <code>usersession</code>, <code>useraction</code>, <code>userevent</code>, или <code>usererror</code> столбцы из другой таблицы могут быть доступны и включены в результаты путем добавления к именам столбцов префикса имени таблицы.

'''''Пример 1'''''

Выбор логического представления <code>usersession</code> или <code>useraction</code> таблицы. Несколько значений объединяются в результирующем столбце при добавлении информации из <code>useraction</code> в запрос по <code>usersession</code>.

<code>SELECT city, useraction.name FROM usersession</code>

<code>SELECT usersession.city, name FROM useraction</code>

Вы можете использовать другие вторичные таблицы <code>userevent</code> таким <code>usererror</code> же образом.

<code>SELECT usersession.country, name, page FROM userevent</code>

<code>SELECT usersession.country, name, type FROM usererror</code>

<code>SELECT country, userevent.name, usererror.name FROM usersession</code>


При запросе из <code>usersession</code> первичной таблицы можно комбинировать поля из других вторичных таблиц (<code>useraction</code>, <code>userevent</code>, и <code>usererror</code>). В условии можно использовать <code>WHERE</code> также поля из вторичных таблиц.


'''''Пример 2'''''

<code>SELECT city, useraction.name, userevent.page, usererror.type FROM usersession</code>

<code>SELECT city, usererror.name, userevent.page, useraction.duration FROM usersession WHERE usererror.name IS NOT NULL</code>


'''''Пример 3'''''

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

<code>SELECT * FROM usersession</code>

<code>WHERE userevent.application = "a" OR useraction.application="a"</code>


При запросе из любой из вторичных таблиц (<code>useraction</code>, <code>userevent</code>, или <code>usererror</code>) вы можете использовать поля только из <code>usersession</code> первичной таблицы; вы не можете использовать поля из других вторичных таблиц. Например, запрос ниже не выполняется, так как выбрана таблица , что означает, что можно выбрать <code>userevent</code> только поля из <code>userevent</code> или .<code>usersession</code>

<code>SELECT usersession.city, useraction.name, userevent.page, usererror.type FROM userevent</code>

Такое же ограничение применяется к другим вторичным таблицам — <code>useraction</code> и <code>usererror</code>.


'''''Пример 4'''''

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

<code>SELECT usersession.userId, name, duration FROM useraction</code>

<code>SELECT usersession.userId, name, type FROM usererror</code>


Применяемые условия различаются по значению в зависимости от таблицы. Например, предположим, что вы хотите перечислить все сеансы пользователя, которые содержат действия пользователя с именами <code>a</code> и <code>b</code>:

<code>SELECT * FROM usersession</code>

<code>WHERE useraction.name = "a" AND useraction.name = "b"</code>

Это означает, что сеанс должен содержать действие пользователя с именем <code>"a"</code> и действие пользователя с именем <code>"b"</code>. Выполнение того же запроса в <code>useraction</code> таблице возвращает пустой результат, поскольку одно и то же действие пользователя не может иметь два разных значения для имени.

Если вы хотите выбрать данные сеанса пользователя для определенного действия пользователя, которое соответствует нескольким критериям, выполните следующий запрос к <code>useraction</code> таблице.

<code>SELECT usersession.*, * FROM useraction</code>

<code>WHERE useraction.name = "a" AND useraction.duration > 1000</code>

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

Давайте рассмотрим другой запрос.

<code>SELECT COUNT(usersession.userSessionId)</code>

<code>FROM usersession</code>

<code>WHERE userevent.name = 'Page change'</code>

<code>  AND userevent.pageGroup = '/Booking'</code>

<code>  AND userevent.type = 'UserTag'</code>

Поскольку запрос выполняется в <code>usersession</code> таблице, условия применяются к общему набору пользовательских событий, которые принадлежат одному сеансу. Это означает, что любой пользовательский сеанс с пользовательскими событиями, которые удовлетворяют условиям, отражается в подсчете. Например, если пользовательский сеанс содержит три пользовательских события, каждое из которых удовлетворяет одному из заданных условий, пользовательский сеанс отражается в подсчете.

Если вы запустите тот же запрос в <code>userevent</code> таблице, условия будут применены к каждому отдельному событию пользователя. Это означает, что только сеансы пользователя, которые имеют хотя бы одно событие пользователя, удовлетворяющее всем условиям, будут отражены в подсчете.

<code>SELECT COUNT(usersession.userSessionId)</code>

<code>FROM userevent</code>

<code>WHERE userevent.name = 'Page change'</code>

<code>  AND userevent.pageGroup = '/Booking'</code>

<code>  AND userevent.type = 'UserTag'</code>

=== Фильтрация с использованием полей вторичной таблицы ===
Будьте осторожны при фильтрации с использованием полей одной из вторичных таблиц. Рассмотрим примеры ниже.

'''''Пример 1'''''

<code>SELECT useraction.name FROM usersession WHERE useraction.name="abc"</code>

Этот запрос возвращает список всех сеансов пользователя, которые содержат хотя бы одно действие пользователя с именем <code>abc</code>. Результат содержит список всех действий пользователя для каждого сеанса, поскольку запрос выполняется на <code>usersession</code> уровне.

'''''Пример 2'''''

<code>SELECT name FROM useraction WHERE name="abc"</code>

Этот запрос извлекает список только тех действий пользователя, которые имеют имя <code>abc</code>.

=== SELECT * FROM table ===
'''''Пример'''''

<code>SELECT * FROM usersession</code>

<code>SELECT useraction.* FROM usersession</code>

<code>SELECT city, useraction.* FROM usersession</code>

<code>SELECT *, useraction.* FROM usersession</code>

Звездочка <code>*</code> сама по себе выбирает столбцы из основной таблицы, а не из вторичной. Например, поля из <code>useraction</code>не включены в <code>SELECT * FROM usersession</code>, если только вы не включите <code>useraction.*</code>.

=== Экспорт JSON ===
Ключевое <code>JSON</code> слово добавляет дополнительный столбец, содержащий данные о запрошенной записи (сеанс пользователя, действие пользователя, событие пользователя или ошибка пользователя) в формате JSON.

Если выбрать <code>usersession</code> основную таблицу, будут возвращены полные строки JSON для соответствующих сеансов пользователей независимо от выбранных столбцов.

'''''Пример 1'''''

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

<code>SELECT usersessionId, browserFamily, useraction.name, useraction.duration, JSON</code>

<code>FROM usersession LIMIT 5</code>


Если выбрана вторичная таблица ( <code>useraction</code>, <code>userevent</code>, или <code>usererror</code>), возвращаются полные строки JSON для соответствующей подзаписи (действие пользователя, событие пользователя или ошибка пользователя).

'''''Пример 2'''''

<code>SELECT name, duration, JSON</code>

<code>FROM useraction LIMIT 5</code>

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

'''''Пример'''''

<code>SELECT * FROM usersession WHERE userId = "some 'custom' name for ""my user"""</code>

<code>SELECT * FROM usersession WHERE userId = 'some <nowiki>''</nowiki>custom<nowiki>''</nowiki> name for "my user"'</code>

=== Funnel charting ===
Funnel charting позволяет отслеживать шаги через ваш цифровой сервис и исследовать области, в которых ваши пользователи испытывают трудности. 

'''''Пример'''''

<code>RE userISELECT FUNNEL(</code>

<code>useraction.name = "AppStart (easyTravel)" AS "Open easytravel",</code>

<code>useraction.name = "searchJourney" AS "Search journey",</code>

<code>useraction.name = "bookJourney" AS "Book journey",</code>

<code>useraction.matchingConversionGoals = "Payment" OR useraction.matchingConversionGoals = "booking-finished" AS "Booked")</code>

<code>FROM usersession</code>


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

'''''Пример'''''

<code>SELECT FUNNEL(</code>

<code>useraction.name = "AppStart (easyTravel)" AS "Open easytravel",</code>

<code>useraction.name = "searchJourney" AS "Search journey",</code>

<code>useraction.name = "bookJourney" AS "Book journey",</code>

<code>useraction.matchingConversionGoals = "Payment" OR useraction.matchingConversionGoals = "booking-finished" AS "Booked")</code>

<code>FROM usersession</code>

<code>WHERE stringProperties.memberstatus="GOLD"</code>

* <code>FUNNEL</code> не поддерживает упорядочивание. Нет гарантии, что <code>useraction1</code> произошло раньше <code>useraction2</code> для <code>SELECT FUNNEL (useraction.name = "useraction1", useraction.name = "useraction2") FROM usersession</code> запроса. Этот запрос является эквивалентом только двух операторов <code>SELECT</code>.

== Доступные таблицы и поля данных сеанса пользователя ==
Для данных сеансов пользователей доступны следующие таблицы.

* <code>usersession</code> содержит информацию о сеансах пользователей .
* <code>useraction</code> хранит данные о действиях пользователя .
* <code>userevent</code> предоставляет информацию о событиях пользователя , таких как изменение страницы или события ярости.
* <code>usererror</code> содержит больше данных о событиях ошибок , т.е. об ошибках и сбоях.

Вторичные таблицы для <code>usersession</code>, <code>useraction</code>, <code>userevent</code>, и <code>usererror</code> включают описание того, как данные в одной из этих таблиц доступны в другой.

== Выполнение запросов USQL для создания пользовательских отчетов ==
Интерфейс REST позволяет вам получать результаты для ваших пользовательских запросов. Все, что вам нужно, это создать уникальный API-токен с привилегией языка запросов сеанса пользователя . Возможность запрашивать данные сеанса пользователя таким образом полезна при автоматизированном тестировании, проверке данных и других автоматизированных функциях. Она включает следующие конечные точки:

<code>/table</code>: возвращает данные в виде плоской таблицы даже при группировке по различным элементам и выполнении иерархических агрегаций по данным сеанса пользователя.

<code>/tree</code>: Возвращает данные в виде полного иерархического дерева на основе входных данных.

Доступны следующие параметры запроса:

<code>query</code>: Необходимо кодировать при помещении в URL, например, <code>%20</code> вместо пробелов. <code>startTimestamp/endTimestamp</code>: Позволяет определять точки во времени, передаваемые как количество миллисекунд с начала эпохи Unix. Если не указано, по умолчанию используются последние два часа.

'''''Примеры'''''

Этот код:

<code>curl --location --insecure -H "Content-Type: application/json" -H "Authorization: Api-Token _token_" \</code>

<code>-XGET "<nowiki>https://{your-environment-id}.live.astromkey.com/api/v1/userSessionQueryLanguage/table?query=select%20city,count(*)%20from%20usersession%20group%20by%20city</nowiki>"</code>

дает следующий результат:

<code>{</code>

<code>    "columnNames": ["city",    "count(*)"],</code>

<code>    "values": [</code>

<code>        ["Dublin",    23],</code>

<code>        ["N. Virginia (Amazon)",    80],</code>

<code>        ["Portland",    56]</code>

<code>    ]</code>

<code>}</code>


Этот код:

<code>curl --location --insecure -H "Content-Type: application/json" -H "Authorization: Api-Token _token_" \</code>

<code>-XGET "<nowiki>https://{your-environment-id}.live.astromkey.com/api/v1/userSessionQueryLanguage/tree?query=select%20country,city,count(*)%20from%20usersession%20group%20by%20country,city</nowiki>"</code>

дает следующий результат:

<code>{</code>

<code>    "branchNames": ["country",    "city"],</code>

<code>    "leafNames": ["count(*)"],</code>

<code>    "values": {</code>

<code>        "United States": {</code>

<code>            "Portland": [56],</code>

<code>            "N. Virginia (Amazon)": [83]</code>

<code>        },</code>

<code>        "Ireland": {</code>

<code>            "Dublin": [24]</code>

<code>        }</code>

<code>    }</code>

<code>}</code>

== Преобразование запросов в пользовательские метрики USQL ==
Вы можете преобразовать некоторые запросы в пользовательские метрики USQL для своих веб-приложений , мобильных приложений и пользовательских приложений .

Пользовательские метрики USQL доступны как пользовательские метрики сеанса пользователя (USCM) и пользовательские метрики действий пользователя (UACM). Пользовательские метрики действий пользователя поддерживаются с АппОптима версии 1.260.

# Перейдите в раздел '''SQL-запросы сессий.'''
# Введите запрос, а затем нажмите на кнопку '''Выполнить запрос''' .
# Выберите '''Создать пользовательскую метрику''' .
# Введите название метрики, а затем просмотрите предлагаемые настройки.

== Ограничения ==

* АппОптима сохраняет и сохраняет Real User Monitoring (действия и сеансы пользователя) в течение ограниченного периода времени. Подробности см. в разделе Периоды хранения данных .
* По умолчанию возвращается 50 результатов, но количество результатов можно увеличить до 5000 с помощью ключевого слова <code>LIMIT</code>.
* Количество потенциальных максимальных результатов в сегментах ограничено максимумом в 100 000. Значение по умолчанию — 10 000.  Это влияет на то, как <code>TOP()</code>применяется при использовании <code>DISTINCT</code>или <code>GROUP BY</code>. Если не указано<code>TOP()</code>, 10 000 возможных результатов равномерно распределяются по указанным столбцам. Эти значения по умолчанию можно перезаписать, указав для каждого столбца <code>TOP()</code>. Умноженные значения <code>TOP()-</code> не могут превышать 100 000 результатов.  '''''Примеры'''''
** Функцию <code>TOP()</code> можно использовать для увеличения количества различных значений в агрегации.
** Максимальное количество различных результатов на агрегацию ограничено 1000.
** Следующий запрос использует не более 10 000 теоретически возможных результатов: <code>select browserFamily, city, count * FROM usersession group by browserFamily, city</code>
** Следующий запрос включает <code>TOP()</code> и, следовательно, может использовать до 100 000 (100 × 1000) теоретически возможных результатов: <code>select TOP(browserFamily, 1000), TOP(city, 100), count * FROM usersession group by browserFamily, city</code>

* Объединения не допускаются.
* В одном <code>SELECT</code> может быть только одна таблица.
* Поиск строковых значений с использованием регулярных выражений не поддерживается.
* Два разных поля нельзя сравнивать. Например, <code>WHERE field1 = field2</code> не работает.
* <code>WHERE</code>условия работают только с полями, поэтому ни то <code>WHERE true</code>, ни другое <code>WHERE COUNT(*) > 3</code> не поддерживаются.
* Запросить можно только закрытые сеансы пользователей. Сеансы активных пользователей не учитываются.
* Заказ поддерживается частично.  Например, сортировка по математической операции не поддерживается.  <code>SELECT endTime - startTime AS duration FROM usersession ORDER BY duration</code>

* Для обширных временных рамок и высоконагруженных сред мы можем экстраполировать данные из выборочного подмножества (уровень экстраполяции). Это происходит независимо от того, используете ли вы API АппОптима или веб-интерфейс АппОптима. Если вам нужны 100% точные данные, уменьшите временные рамки или добавьте дополнительные условия для дальнейшей фильтрации запрашиваемых данных.
* Функции в предложении не допускаются <code>GROUP BY</code>. Поэтому, если вы хотите сгруппировать по месяцам, укажите псевдоним.
* <code>FUNNEL</code>нельзя использовать с <code>SELECT *</code>функциями, ключевыми словами, такими как <code>JSON</code>, и операторами <code>GROUP BY</code>, <code>ORDER</code>и <code>LIMIT</code>.
* Для математических операций поддержка <code>GROUP BY</code>, <code>ORDER BY</code>и других операций над функциями недоступна.
* К . можно применить максимум 10 условий <code>FUNNEL</code>.
* Некоторые поля, такие как <code>duration</code>, всегда возвращают целые значения вместо десятичных, когда над ними выполняются математические операции, такие как деление. Это происходит потому, что эти поля хранятся и отображаются как целые значения. Например, <code>SELECT duration FROM usersession</code>возвращает длительность <code>4800</code>, а <code>SELECT duration/1000 FROM usersession</code>возвращает длительность <code>5</code>.