Использование Kusto.explorer

Переключайте службы с помощью раскрывающегося списка Версия. Дополнительные сведения о навигации.
Область применения: ✅ Microsoft Fabric ✅ Azure Data Explorer

Kusto.Explorer — это классическое приложение, которое позволяет изучать данные с помощью языка запросов Kusto (KQL) в интуитивно понятном интерфейсе. В этом руководстве объясняется, как использовать режимы поиска и запросов, совместно использовать запросы и управлять кластерами, базами данных и таблицами для упрощенного анализа данных.

Режим поиска++

Режим Search++ позволяет искать термин с помощью синтаксиса поиска в одной или нескольких таблицах.

1. На вкладке "Главная" в раскрывающемся списке "Запрос " выберите "Поиск++".

2. Выберите несколько таблиц.

3. В разделе "Выбор таблиц" укажите таблицы для поиска и нажмите кнопку "ОК".

4. В поле редактирования введите фразу поиска и нажмите кнопку "Перейти".

   Тепловая карта таблицы и сетки интервалов времени показывает, где расположены термины.

   

5. Выберите ячейку в сетке, а затем выберите "Просмотреть сведения ", чтобы отобразить соответствующие записи в области результатов.

   

Режим запроса

Kusto.Explorer включает мощный режим запросов, позволяющий создавать, редактировать и запускать встроенные запросы. Режим запроса включает выделение синтаксиса и IntelliSense, поэтому вы быстро улучшаете знания о языке запросов Kusto.

В этом разделе объясняется, как выполнять базовые запросы в Kusto.Explorer и добавлять параметры в запросы.

Базовые запросы

Если у вас есть журналы таблиц, вы можете начать их изучение:

StormEvents | count 

Когда курсор находится на этой строке, он серый. Выберите F5 , чтобы запустить запрос.

Ниже приведены несколько примеров запросов:

// Take 10 lines from the table. This is useful to get familiar with the data.
StormEvents | take 10 

// Filter by EventType == 'Flood' and State == 'California' (where =~ means case insensitive). 
// Take a sample of 10 lines.
StormEvents 
| where EventType == 'Flood' and State =~ 'California'
| take 10

Узнайте больше о языке запросов Kusto.

Параметризация запросов на стороне клиента

Если вы используете одно и то же значение в нескольких запросах или вкладках, это неудобно, чтобы изменить это значение во всех местах его использования. Kusto.Explorer позволяет использовать параметры запроса для удобства. Параметры запроса разделяются между вкладками, поэтому их можно легко использовать. Параметры указываются фигурными скобками ({}). Например, {parameter1}.

Определение и изменение параметров запроса:

Можно использовать несколько наборов параметров, перечисленных в поле со списком "Набор параметров ". Выберите "Добавить новое " или "Удалить текущий" для управления наборами параметров.

Предоставление общего доступа к запросам и результатам

В Kusto.Explorer поделитесь запросами и результатами по электронной почте. Создайте глубокие ссылки для открытия и запуска запроса в браузере.

Предоставление общего доступа к запросам и результатам по электронной почте

Предоставление общего доступа к запросам и результатам запроса по электронной почте в Kusto.Explorer.

Запросы глубоких ссылок

Вы можете создать универсальный код ресурса (URI), который при открытии в браузере открывает Kusto.Explorer локально и выполняет определенный запрос в указанной базе данных Kusto.

Создание глубокой ссылки

Самый простой способ создать глубокую ссылку — написать запрос в Kusto.Explorer, а затем скопировать Query and results to Clipboard запрос, включая глубокую ссылку и результаты, в буфер обмена. Затем вы можете поделиться им по электронной почте.

При копировании в сообщение электронной почты несколько ссылок для выполнения отображаются на небольшом шрифте. Например:

Веб-ссылка открывает запрос в Azure Data Explorer. Ссылка на рабочий стол — это глубокая связь. Он открывает запрос в Kusto.Explorer и задает контекст соответствующим образом.

При перемещении ссылки на сообщение электронной почты и нажатии клавиш CTRL+K вы увидите фактический URL-адрес.

Глубокие ссылки и параметризованные запросы

Для глубокого связывания можно использовать параметризованные запросы.

1. Создание запроса для формирования в виде параметризованного запроса (например, KustoLogs | where Timestamp > ago({Period}) | count)

Ограничения

Запросы ограничены 2000 символами из-за ограничений браузера, прокси-серверов HTTP и средств проверки ссылок, таких как Microsoft Outlook. Ограничение является приблизительным, так как зависит от длины имени кластера и базы данных. Дополнительные сведения см. в разделе https://support.microsoft.com/kb/208427.

Чтобы уменьшить вероятность достижения предела символов, см. статью "Получение коротких ссылок".

Получение более коротких ссылок

Запросы могут стать длинными. Чтобы уменьшить вероятность превышения максимальной длины, используйте String Kusto.Data.Common.CslCommandGenerator.EncodeQueryAsBase64Url(string query) метод в клиентской библиотеке Kusto. Этот метод создает более компактную версию запроса. Более короткий формат также распознается Kusto.Explorer.

Сделайте запрос более компактным, применяя следующее преобразование:

 UrlEncode(Base64Encode(gzip(original query)))

Аргументы командной строки Kusto.Explorer

Аргументы командной строки позволяют средству выполнять дополнительные функции при запуске, например загрузку скрипта и подключение к кластеру. Однако аргументы командной строки не заменяют функциональные возможности Kusto.Explorer.

Аргументы командной строки являются частью URL-адреса, используемого для открытия приложения, аналогично запросу глубокого связывания.

Синтаксис аргумента командной строки

Kusto.Explorer поддерживает несколько аргументов командной строки, используя этот синтаксис (порядок имеет значение):

[LocalScriptFile] [QueryString]

Аргументы командной строки

Аргументы запроса

Пример

Kusto.Explorer.exe c:\temp\script.kql "uri=https://help.kusto.windows.net/Samples;Fed=true&name=Samples"

Kusto.Explorer.exe c:\temp\script.kql "uri=https://<baseaddress>/groups/<GroupID>/databases/<DatabaseID>"

Управление базами данных, таблицами или субъектами, имеющими разрешение на выполнение функций

1. Чтобы просмотреть список авторизованных субъектов, откройте панель "Подключения", щелкните правой кнопкой мыши целевую сущность и выберите "Управление авторизованными субъектами базы данных". Этот параметр также можно выбрать в меню "Управление".

   

2. Выберите " Добавить участника" , чтобы добавить авторизованного субъекта.

3. Введите основные данные, затем выберите Добавить администратора.

   

4. Подтвердите добавление авторизованного субъекта.

   

Чтобы удалить авторизованного субъекта, выберите "Удалить субъект " и подтвердите действие.

Связанный контент

• Сочетания клавиш Kusto.Explorer
• Параметры Kusto.Explorer
• Устранение неполадок Kusto.Explorer
• Возможности кода Kusto.Explorer
• Дополнительные сведения о языке запросов Kusto (KQL)