Команда .show queries

  • Статья

Команда .showqueries перечисляет запросы в кластере, которые достигли конечного состояния, и что пользователь, вызывающий команду, имеет доступ к просмотру. При необходимости команда может возвращать запросы, которые по-прежнему выполняются, запросы определенных пользователей или запросы, сгруппированные по пользователям. Чтобы просмотреть как запросы, так и завершение команд, используйте .show queries-and-commands.

Разрешения

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

Синтаксис

.show queries

.showrunningqueries [ by userUserPrincipalName]

Дополнительные сведения о соглашениях о синтаксисе.

Параметры

Имя Тип Обязательно Описание
UserPrincipalName string Имя участника-пользователя определенного пользователя, для которого возвращается список запросов.

Возвращаемое значение

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

Примечание

Текст запроса усекается после 64 КБ.

Возвращаемая схема таблицы:

ColumnName ColumnType Описание
ClientActivityId string Идентификатор клиента запроса
Текст string Текст запроса, усеченный в 64 КБ
База данных string Имя базы данных, в которой был выполнен запрос
StartedOn datetime Метка времени начала выполнения запроса
LastUpdatedOn datetime Метка времени последнего обновления состояния
Duration timespan Длительность запроса на стороне сервера
Состояние string Состояние завершения
RootActivityId guid Идентификатор запроса на стороне сервера
Пользователь string Идентификатор пользователя, выполняющего запрос
FailureReason string Причина сбоя. Если запрос выполнен успешно, это поле будет пустым.
TotalCpu timespan Общий объем ЦП, потребляемый запросом
CacheStatistics dynamic Статистика использования кэша данных
Приложение string Имя приложения, которое использовалось для выполнения запроса
MemoryPeak long Пиковая статистика памяти
ScannedExtentsStatistics dynamic Статистика отсканированных сегментов (экстентов)
Основной string Идентификатор AAD пользователя или приложения, который использовался для выполнения запроса
ClientRequestProperties dynamic Свойства клиентского запроса
ResultSetStatistics dynamic Статистика, описывающая возвращаемый набор данных
WorkloadGroup string Имя группы рабочей нагрузки, с которым связан запрос

Примеры

Отображение завершенных запросов

Выполнить запрос

.show queries 
| project Text, Duration
| take 10

Выходные данные

Текст Duration
StormEvents | sort by DeathsDirect desc 00:00:00.2343761
StormEvents | sort by DeathsDirect desc 00:00:00.2187503
StormEvents | sort by DeathsDirect desc 00:00:00.2343115
StormEvents | sort by DamageProperty desc 00:00:00.2656510
StormEvents | sort by StartTime desc 00:00:00.2343012
StormEvents | sort by StartTime desc 00:00:00.2813042
StormEvents | sort by StartTime desc 00:00:00.3594493
TestFunction(5) 00:00:00.0312024
traceAgg(now(5500d)) 00:00:00.0312952
traceAgg(now(-5500d)) 00:00:00.0312445

Отображение выполняемых запросов текущим пользователем

.show running queries

Отображение запросов, выполняемых указанным пользователем

.show running queries by user <UserPrincipalName>

См. также