GET таблица

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

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

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

GET	Managed	https://{your-domain}/e/{your-environment-id}/api/v1/userSessionQueryLanguage/table
	Cреда ActiveGate	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.dynatrace.com/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.dynatrace.com/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