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

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

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

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

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

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

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

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

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

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

   

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

   

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

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

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

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

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

StormEvents | count 

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

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

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

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

Дополнительные сведения о язык запросов Kusto см. в язык запросов Kusto.

Примечание.

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

Если текст не выбран, предполагается, что запрос или команда разделены пустыми строками. Если текст выбран, будет выполнен выделенный текст.

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

Примечание.

В Kusto существует два типа методов параметризации запросов:

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

• Параметризация запросов на стороне клиента — это функция только приложения Kusto.Explorer. Это эквивалентно использованию операций строковой замены запросов перед отправкой их для выполнения службой. Синтаксис не является частью самого языка запросов и не может использоваться при отправке запросов в службу другими средствами, кроме Kusto.Explorer.

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

Можно легко определить и изменить существующие параметры запроса:

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

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

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

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

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

1. Запустите запрос в Kusto.Explorer.

2. На вкладке "Главная" в разделе "Общий доступ " выберите "Запрос и результаты" в буфер обмена (или нажмите клавиши CTRL+SHIFT+C).

   

   Kusto.Explorer копирует следующее в буфер обмена:

   • Запрос
   • Результаты запроса (таблица или диаграмма)
   • Сведения о подключении для дома событий и базы данных
   • Ссылка, которая повторно запускает запрос автоматически

3. Вставьте содержимое буфера обмена в новое сообщение электронной почты.

Запросы с глубокой компоновкой

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

Примечание.

По соображениям безопасности глубокое связывание отключено для команд управления.

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

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

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

Выполнение: [Web] [Desktop] [Web (Lens)] [Desktop (SAW)] https://trd-1234.kusto.fabric.microsoft.com

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

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

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

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

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

1. Укажите параметр для каждого параметра запроса в URI. Чтобы скопировать URI, в области запросов KQL в Fabric выберите "Копировать ссылку запроса>" в буфер обмена.

2. Вставьте ссылку в области запросов Kusto.Explorer.

Примечание.

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

Ограничения

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

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

URI открывает Kusto.Explorer и запускает указанный запрос. Откроется новая вкладка, если уже запущенный экземпляр.

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

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

<https://\BaseAddress>/groups/1234ab-cd55-6789-0123-e4567fg890hi/database/01234abc-defg-6789-4567fg890hi?experience=power-bi&extensionScenario=openArtifact&query=1234AAAAAAAAAAA567890BBBBBBBB01234567890CCCCC1234AAAAAAAAAAAAA567890BBBBBBBB01234567890CCCCC1234AAAAAAAAAAAAA567890BBBBBBBB01234567890CCCCC%AB%AB

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

 UrlEncode(Base64Encode(gzip(original query)))

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

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

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

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

Kusto.Explorer поддерживает несколько аргументов командной строки в следующем синтаксисе (вопросы порядка):

[LocalScriptFile] [QueryString]

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

Аргумент командной строки	Description
LocalScriptFile	Имя файла скрипта на локальном компьютере, которое должно иметь расширение .kql. Если файл существует, Kusto.Explorer автоматически загружает файл при запуске.
QueryString	Строка, использующая форматирование строк HTTP-запроса. Этот метод предоставляет дополнительные свойства, как описано в следующей таблице.

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

Аргумент	Description
Выполнение запроса
query	Запрос для выполнения (gzipped, а затем закодированный base64; см. статью "Получение коротких ссылок"). Если параметр не указан, используется querysrc.
querysrc	URL-адрес файла или большого двоичного объекта, в который требуется выполнить запрос.
Подключение к кластеру Kusto
uri	Строка подключения кластера Kusto для подключения.
name	Отображаемое имя подключения к кластеру Kusto.
Группа подключений
path	URL-адрес файла группы подключений для скачивания (URL-кодированный).
group	Имя группы соединений.
filename	Локальный файл, содержащий группу подключений.

Пример

Чтобы запустить Kusto.Explorer с именем c:\temp\script.kql и настроенным файлом скрипта для взаимодействия с определенной группой и базой данных, используйте следующую команду:

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)