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

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

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

Предварительные требования

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

Примечание

Клиентские библиотеки Kusto совместимы с JavaScript и TypeScript. Чтобы преобразовать примеры TypeScript в JavaScript, просто удалите заметки типов, используемые для переменных, параметров и возвращаемых значений.

C#

Одна или несколько из следующих платформ пакета SDK для .NET:

• Пакет Azure SDK 5.0 или более поздней версии
• .NET Core 2.1 или более поздней версии
• .NET Standard 2.1 или более поздней версии
• .NET Framework 4.7.2 или более поздней версии.

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

Python

• Python версии 3.7 или выше
  • Убедитесь, что исполняемый python файл находится в PATH
  • Проверка установки. В командной оболочке выполните python --version команду , чтобы проверка, что версия 3.7 или более поздняя.

Typescript

• Узел 16 или более поздней версии , созданный с помощью ES6

  • Убедитесь, что исполняемый node файл находится в PATH
  • Проверка установки. В командной оболочке выполните node --version команду , чтобы проверка, что версия 3.7 или более поздняя.

• Приложение Node.js или веб-приложение на основе браузера, например приложение React.

• Для веб-приложений на основе браузера:

  • Если в приложении есть интерфейс входа, вы можете использовать библиотеку @auzre/identity для выдачи маркера авторизации и использовать для withTokenProvider отправки этого маркера в клиент Kusto:

    const tokenProvider =  () => Promise.resolve("someToken")
    KustoConnectionStringBuilder.withTokenProvider(clusterUri, tokenProvider)
    

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

    1. Создайте регистрацию приложения Microsoft Entra.
    2. На вкладке Проверка подлинности выберите + Добавить платформу. Затем выберите Одностраничное приложение.
    3. Введите нужные URI перенаправления, установите флажки маркеры доступа и маркеры идентификации и нажмите кнопку Настроить. Дополнительные сведения об URI перенаправления см. в разделе Классическое приложение, которое вызывает веб-API.
    4. Настройте делегированные разрешения для приложения.
    5. Предоставьте приложению доступ к базе данных azure Data Explorer.
    6. На вкладке Обзор скопируйте идентификатор приложения (клиента).

    В примерах в следующих руководствах для запроса проверки подлинности используется клиентская библиотека Kusto.

    Примечание

    Если вы принадлежите к организации, ограничения, основанные на конфигурациях организации, могут помешать проверке подлинности. Запросите доступ у администратора организации или повторите попытку на личная учетная запись.

Java

• JDK 8 или более поздней версии
  • Убедитесь, что исполняемый java файл находится в PATH
  • Проверка установки. В командной оболочке выполните java -version команду , чтобы проверка, что версия 8 или более поздняя.
• Maven 3.6.3 или более поздней версии
  • Убедитесь, что исполняемый mvn файл находится в PATH
  • Проверка установки. В командной оболочке выполните mvn -version проверка, что версия 3.6.3 или более поздняя.

Установка пакета

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

В следующей таблице перечислены клиентские библиотеки и соответствующие имена пакетов.

Имя библиотеки	Описание
Библиотека данных Kusto	Предоставляет клиент для подключения к кластерам. Используйте клиентную библиотеку для запроса данных или выполнения команд управления.
Библиотека приема Kusto	Предоставляет клиент для приема данных в кластеры. Дополнительные сведения см. в статье Прием данных в кластер.

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

C#

dotnet add package Microsoft.Azure.Kusto.Data --version 11.2.2
dotnet add package Microsoft.Azure.Kusto.Ingest --version 11.2.2

Python

python -m pip install azure-kusto-data
python -m pip install azure-kusto-ingest

Typescript

npm install azure-kusto-data
npm install azure-kusto-ingest

Java

При создании приложений используйте шаблон Maven-archetype-quickstart для пакета, как показано ниже.

 mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId==my-app -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

Затем добавьте следующие зависимости в pom.xml, заменив версии артефактов последними версиями, доступными в Maven Central для kusto-data и kusto-ingest.

<dependency>
  <groupId>com.microsoft.azure.kusto</groupId>
  <artifactId>kusto-data</artifactId>
  <version>5.0.0</version>
</dependency>
<dependency>
  <groupId>com.microsoft.azure.kusto</groupId>
  <artifactId>kusto-ingest</artifactId>
  <version>5.0.0</version>
</dependency>

Кроме того, необходимо добавить подключаемые модули maven-compiler-plugin и exec-maven-plugin в pom.xml. Если они еще не существуют, добавьте их следующим образом.

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>${maven-compiler-plugin.version}</version>
  <configuration>
    <source>${java.version}</source>
    <target>${java.version}</target>
  </configuration>
</plugin>
<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>exec-maven-plugin</artifactId>
    <version>3.1.0</version>
</plugin>

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

C#

Краткое руководство по C#

Python

Приложение быстрого запуска Python

Typescript

• Node.js приложение быстрого запуска
• Приложение быстрого запуска браузера

Java

Приложение для быстрого запуска Java

Узнайте, как создавать приложения, использующие клиентские библиотеки

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

• Создание первого приложения
• Создание приложения для выполнения базовых запросов
• Создание приложения для выполнения команд управления
• Создание приложения для получения данных с помощью приема в очереди

См. также

• Краткий справочник по KQL
• Мастер создания примеров приложений