GET таблица

Материал из Документация Ключ-АСТРОМ

Выполняет запрос USQL и возвращает результаты в виде структуры таблицы запрошенных столбцов.

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

Запрос создает в качестве полезной нагрузки application/json формат.

GET Managed https://{your-domain}/e/{your-environment-id}/api/v1/userSessionQueryLanguage/table
Cреда АктивногоШлюза https://{your-activegate-domain}/e/{your-environment-id}/api/v1/userSessionQueryLanguage/table

Аутентификация

Чтобы выполнить этот запрос, вам нужен токен доступа с областью сеансов пользователей ( DTAQLAccess) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

Параметры

Параметр Тип Описание In Необходимость
query string Выполняемый запрос сеанса пользователя. Подробнее о синтаксисе см. на странице документации USQL .

Вы можете найти доступные столбцы таблицы usersession в UserSessionобъекте.

Вот пример запроса: SELECT country, city, COUNT(*) FROM usersession GROUP BY country, city.

query требуется
startTimestamp integer Отметка времени начала запроса в миллисекундах UTC.

Если не установлено или установлено как 0, используется отставание от текущего времени на 2 часа.

Если важны точные времена, задайте таймфрейм в самом запросе ( параметр запроса ).

query по желанию
endTimestamp integer Отметка времени окончания запроса в миллисекундах UTC.

Если не установлено или установлено как 0, используется текущая метка времени.

Если важны точные времена, задайте таймфрейм в самом запросе ( параметр запроса ).

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

Может быть положительным или отрицательным. Например, если местное время UTC+02:00, timeOffset равно 120. Если это UTC-05:00, timeOffset равно -300.

query по желанию
pageSize integer Необязательный предел того, сколько фактических результатов запроса должно быть возвращено в табличном результате. query по желанию
pageOffset integer Необязательное смещение запрошенных результатов от начала табличных результатов. Относится к размеру страницы.

Например, для запроса, который может вернуть 500 результатов, вы можете захотеть получить результаты фрагментами по 50 строк.

это может быть достигнуто путем использования pageSize=50 и установки pageOffset в последующих вызовах. В примере добавление pageOffset=50 возвращает строки результата 51-100.

query по желанию
addDeepLinkFields boolean Добавьте ( true), чтобы включить прямые ссылки на дополнительные поля в запросе.

Если не установлено, то falseиспользуется

query по желанию
explain boolean Добавьте ( true) или не добавляйте ( false) дополнительную информацию о результате в ответ.

Это помогает понять запрос и то, как был рассчитан результат.

Если не установлено, то falseиспользуется

query по желанию

Ответ

Коды ответов

Код Тип Описание
199 UserSession Структура данных сеанса пользователя. Этот код ответа никогда не возвращается.
200 DtaqlResultAsTable Успех. Ответ содержит результат запроса.
400 Не удалось. Запрос отсутствует.
404 Не удалось. Запрос недействителен. Дополнительную информацию см. в теле ответа.

Объекты тела ответа

Объект DtaqlResultAsTable

Результат запроса сеанса пользователя в виде таблицы.

Элемент Тип Описание
extrapolationLevel integer Уровень экстраполяции результата.

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

Число является знаменателем дроби и указывает количество фактических данных. Значение 1означает, что результат содержит только фактические данные. Значение 4означает, что результат рассчитывается с использованием 1/4 фактических данных.

Если вам нужно, чтобы анализ основывался на реальных данных, уменьшите временные рамки вашего запроса. Например, в случае уровня экстраполяции 4попробуйте использовать 1/4 исходного таймфрейма.

additionalColumnNames string[] Список столбцов в таблице AdditionalValues.

Присутствует только в том случае, если конечная точка была вызвана с deepLinkFields=trueпараметром.

additionalValues array[] Список строк данных.

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

Размер каждой строки данных и порядок элементов соответствуют содержимому AdditionalColumnNames .

Присутствует только в том случае, если конечная точка была вызвана с deepLinkFields=trueпараметром.

explanations string[] Дополнительная информация о запросе и результате, помогающая понять запрос и способ расчета результата.

Появляется только тогда, когда для параметра объяснения установлено значение true.

Пример. Количество результатов по умолчанию ограничено 50. Используйте LIMITпункт, чтобы увеличить или уменьшить это ограничение.

columnNames string[] Список столбцов в таблице результатов.
values array[] Список строк данных.

Каждый элемент массива представляет строку в таблице результатов.

Размер каждой строки данных и порядок элементов соответствуют содержимому columnNames .

JSON-модель тела ответа

{
  "extrapolationLevel": 1,
  "columnNames": [
    "city",
    "avg(duration)",
    "max(duration)"
  ],
  "values": [
    [
      "Klagenfurt",
      "65996.75",
      "129940"
    ],
    [
      "Linz",
      "57360.86",
      "222912"
    ],
    [
      "Gdansk",
      "22482.2",
      "351263"
    ]
  ]
}

Пример

В этом примере запрос выполняет SELECT country, city, avg(duration), max(duration) FROM usersession GROUP BY country, cityзапрос.

Маркер API передается в заголовке авторизации .

Результат усекается до 4 записей.

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

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

Значение extrapolationLevel , равное 4, указывает, что значения экстраполируются на основе 1/4 фактических данных.

Curl

curl -X GET \
  'https://mySampleEnv.live.ruscomtech.ru/api/v1/userSessionQueryLanguage/table?query=select%20country,%20city,%20avg%28duration%29,%20max%28duration%29%20from%20usersession%20group%20by%20country,%20city' \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890-'

URL-адрес запроса

https://mySampleEnv.live.ruscomtech.ru/api/v1/userSessionQueryLanguage/table?query=select%20country,%20city,%20avg%28duration%29,%20max%28duration%29%20from%20usersession%20group%20by%20country,%20city

Тело ответа

{
  "extrapolationLevel": 4,
  "columnNames": [
    "city",
    "avg(duration)",
    "max(duration)"
  ],
  "values": [
    [
      "Austria",
      "Vienna",
      64423.908602150535,
      557649
    ],
    [
      "United States"
      "Detroit",
      60316.97509339975,
      504369
    ],
    [
      "Poland",
      "Gdańsk",
      24914.196428571428,
      445353
    ],
    [
      "United States",
      "Boston",
      65826.70517928287,
      434636
    ]
  ]
}

Код ответа

200