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

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

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

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

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

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

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

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

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

   

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

   

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

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

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

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

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

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. Обозреватель только приложение. Это эквивалентно использованию операций замены строк в запросах перед отправкой их для выполнения службой. Описанный ниже синтаксис не является частью самого языка запросов и не может использоваться при отправке запросов в службу с помощью средств, отличных от Kusto. Обозреватель.

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

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

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

Общий доступ к запросам и результатам

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

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

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

1. Выполните запрос в Kusto. Обозреватель.

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

   

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

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

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

   

Запросы с глубоким связыванием

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

Примечание

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

Создание прямой ссылки

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

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

https://help.kusto.windows.net/Samples [Выполнение запроса]

Первая ссылка открывает Kusto. Обозреватель и соответствующим образом задает контекст кластера и базы данных. Вторая ссылка (Run the query) — это прямая ссылка. Если переместить ссылку в сообщение электронной почты и нажать клавиши CTRL+K, вы увидите фактический URL-адрес:

https://help.kusto.windows.net/Samples?web=0& query=H4sIAAAAAAAAAEAAsuySS%2fKdS1LzSspVuDlqlEoLs3NTSzKrEpVSM4vzSvRR0FRIqlRIyszTCC5JLCoJycxN1VEwT9EEKS1KzUtJLVIoAYolZwAlFQCB3oo%2bTAAAAA%3d%3d%3d

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

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

1. Создайте запрос, который будет сформирован как параметризованный запрос (например, KustoLogs | where Timestamp > ago({Period}) | count).

2. Укажите параметр для каждого параметра запроса в URI, например:

   https://<your_cluster>.kusto.windows.net/MyDatabase? web=0&query=KustoLogs+%7c+where+Timestamp+>+ago({Period})+%7c+count&Period=1h

   Замените <your_cluster> именем кластера Azure Data Explorer.

Ограничения

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

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

Формат URI: https://<ClusterCname>.kusto.windows.net/<DatabaseName>web=0?query=<QueryToExecute>

Пример: https://help.kusto.windows.net/Samples?web=0query=StormEvents+%7c+limit+10

Этот универсальный код ресурса (URI) откроет Kusto. Обозреватель подключитесь к Help Кластер Kusto и выполнение указанного запроса к Samples базе данных. Если имеется экземпляр Kusto. Обозреватель уже выполняется, запущенный экземпляр откроет новую вкладку и выполнит в ней запрос.

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

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

https://help.kusto.windows.net/Samples?web=0& query=H4sIAAAAAAAAAEAAsuySS%2fKdS1LzSspVuDlqlEoLs3NTSzKrEpVSM4vzSvRR0FRIqlRIyszTCC5JLCoJycxN1VEwT9EEKS1KzUtJLVIoAYolZwAlFQCB3oo%2bTAAAAA%3d%3d%3d

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

 UrlEncode(Base64Encode(GZip(original query)))

Kusto. Обозреватель аргументов командной строки

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

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

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

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

[LocalScriptFile] [QueryString]

• LocalScriptFile — это имя файла скрипта на локальном компьютере, который должен иметь расширение .kql. Если такой файл существует, Kusto. Обозреватель автоматически загружает этот файл при его запуске.
• QueryString — это строка, использующая форматирование строки ЗАПРОСА HTTP. Этот метод предоставляет дополнительные свойства, как описано в таблице ниже.

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

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

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

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

Важно!

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

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

   

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

3. Укажите сведения о субъекте, а затем выберите Добавить участника.

   

4. Убедитесь, что вы хотите добавить авторизованного субъекта.

   

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

См. также

• Сочетания клавиш Kusto.Explorer
• Параметры Kusto.Explorer
• Устранение неполадок с Kusto.Explorer
• Kusto. функции кода Обозреватель
• Язык запросов Kusto (KQL)