Поделиться через


Команда .show queries

Область применения: ✅Microsoft Fabric✅Azure Data Explorer

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

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

Разрешения

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

Синтаксис

.show queries

.showrunning queries [ by user UserPrincipalName]

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

Параметры

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

Возвраты

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

Примечание.

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

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

ColumnName ColumnType Description
ClientActivityId string Идентификатор клиента запроса
Текст string Текст запроса, усеченный в 64 КБ
База данных string Имя базы данных, в которой был выполнен запрос
StartedOn datetime Метка времени при запуске выполнения запроса
LastUpdatedOn datetime Метка времени последнего обновления состояния
Duration timespan Длительность запроса на стороне сервера
Штат string Состояние завершения
RootActivityId guid Идентификатор запроса на стороне сервера
User 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 | сортировка по StartTime desc 00:00:00.2343012
StormEvents | сортировка по StartTime desc 00:00:00.2813042
StormEvents | сортировка по 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>