Использование мастера создания примеров приложений для создания кода приема данных и запросов по ним

Мастер создания примеров приложений позволяет создать работающее приложение для приема и запрашивания данных на предпочитаемом языке программирования. Код будет создан со ссылками на нужные платформы и пакеты SDK, а также с учетом параметров вашего кластера и ваших данных. Созданное приложение будет автономным исполняемым примером, который демонстрирует подключение к кластеру, использование проверки подлинности, администрирование кластера, прием данных и запрос по ним с использованием пакета SDK.

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

Необходимые компоненты

• Учетная запись Майкрософт или удостоверение пользователя Microsoft Entra. Подписка Azure не обязательна.
• Кластер и база данных Azure Data Explorer. Создайте кластер и базу данных.
• Войдите в пользовательский веб-интерфейс Azure Data Explorer и добавьте подключение к кластеру.

Примечание.

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

Доступ к мастеру

Мастер создания примеров приложений помогает выполнить прием данных.

Чтобы получить доступ к мастеру из веб-интерфейса Azure Data Explorer, выполните следующие действия.

1. В области слева выберите элемент Запрос.

2. Щелкните правой кнопкой мыши нужную таблицу и выберите "Создать>пример кода".

   

Создание примера приложения

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

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

• и приеме данных в имеющуюся таблицу.
• принимать данные в новой таблице,
• Прием данных из:
  • Хранилище BLOB-объектов
  • локального файла;

Назначение

На вкладке "Назначение ":

1. Выберите кластер и базу данных.

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

3. Выберите язык программирования для приложения.

   

4. Выберите Далее: Источник.

Исходный код

На вкладке "Источник":

1. Выберите один из следующих параметров:

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

2. Если выбран запрос и прием, выберите исходный файл или большой двоичный объект для приема.

3. Выберите Далее: Схема.

Схема

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

1. Подтвердите тип автогенерированного сжатия.

2. Выберите формат данных из форматов, поддерживаемых Azure Data Explorer для приема. Разные форматы имеют разные спецификации.

3. В окне предварительного просмотра частичных данных настройте схему по мере необходимости. Для этого щелкните стрелку в верхней части столбца, чтобы открыть меню с параметрами изменения типа данных, создания нового столбца, удаления столбца и т. д. Если данные используются в формате Parquet, JSON или Avro, можно применить преобразования сопоставления.

   

4. Нажмите кнопку "Далее" — создание примера приложения.

Совет

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

Преобразования сопоставлений

Форматы данных Parquet, JSON и Avro поддерживают простые преобразования времени приема. Чтобы применить преобразования сопоставления, создайте или обновите столбец в окне частичного предварительного просмотра данных.

Преобразования сопоставления можно выполнять в столбце строки типа или даты и времени с исходными данными с типом данных int или long. Поддерживаются следующие преобразования сопоставлений:

• DateTimeFromUnixSeconds;
• DateTimeFromUnixMilliseconds;
• DateTimeFromUnixMicroseconds;
• DateTimeFromUnixNanoseconds.

Дополнительные сведения см. в разделе "Сопоставление преобразований".

Создать

После завершения сопоставления схем и обработки столбцов мастер создания примеров приложений запускает процесс создания кода. Когда завершится создание кода, проект с примером приложения станет доступен для скачивания в формате ZIP-файла.

Подробные инструкции по запуску проекта с выбранным пакетом SDK предоставляются при успешном создании и в примере файла проекта. Кроме того, мастер предоставляет варианты использования быстрых запросов для первоначального изучения данных.

Примечание.

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

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

• Настройка среды разработки для использования клиентских библиотек Kusto