Применимо: ✅Microsoft Fabric✅Azure Data Explorer
Настройте среду для использования клиентских библиотек Kusto. Эти библиотеки позволяют создавать приложения, которые подключаются к кластеру, выполняют запросы или прием данных.
В этой статье объясняется, как установить пакеты клиентской библиотеки для предпочитаемого языка.
Предпосылки
Выберите необходимые условия для языка программирования, используемого для создания приложения.
Замечание
Клиентские библиотеки Kusto совместимы с JavaScript и TypeScript. Чтобы преобразовать примеры TypeScript в JavaScript, удалите заметки типа, используемые для переменных, параметров и возвращаемых значений.
Одна или несколько следующих платформ SDK для .NET:
- Пакет SDK для .NET версии 5.0 или более поздней версии
- .NET Core 2.1 или более поздней версии
- .NET Standard 2.1 или более поздней версии
- .NET Framework 4.7.2 или новее
Проверьте установку: в командной оболочке выполните команду dotnet sdk check , чтобы убедиться, что установленные версии соответствуют минимальным требованиям.
-
Python версии 3.7 или выше
- Убедитесь, что исполняемый
python файл находится в вашем PATH
- Проверьте установку: в командной оболочке выполните команду
python --version , чтобы убедиться, что версия 3.7 или более поздняя.
Узел 16 или более поздней версии , построенный с помощью ES6
- Убедитесь, что исполняемый
node файл находится в вашем PATH
- Проверьте установку: в командной оболочке выполните команду
node --version , чтобы убедиться, что версия 3.7 или более поздняя.
Приложение Node.js или веб-приложение на основе браузера, например приложение React.
Для веб-приложений на основе браузера:
Если в вашем приложении есть вход в систему, используйте библиотеку @auzre/identity для выдачи токена авторизации и передачи этого токена клиенту Kusto.
const tokenProvider = () => Promise.resolve("someToken")
KustoConnectionStringBuilder.withTokenProvider(clusterUri, tokenProvider)
Если у приложения нет возможности входа или вы предпочитаете использовать клиентскую библиотеку Kusto для запроса проверки подлинности, необходимо настроить регистрацию приложения с необходимыми разрешениями:
-
Создание регистрации приложения Microsoft Entra
- На вкладке "Проверка подлинности " выберите +Добавить платформу. Затем выберите одностраничные приложения.
- Введите нужные URI перенаправления, выберите флажки для маркеров доступа и маркеров идентификаторов, и выберите Настроить. Узнайте больше о URI перенаправления в настольном приложении, которое вызывает веб-API.
-
Настройте делегированные разрешения для приложения.
-
Предоставьте приложению доступ к базе данных.
- На вкладке "Обзор " скопируйте идентификатор приложения (клиента).
Примеры в следующих руководствах используют клиентскую библиотеку Kusto для выполнения аутентификации.
Замечание
Если вы принадлежите организации, ограничения на основе конфигураций организации могут препятствовать проверке подлинности. Попросите предоставить доступ администратору организации или повторите попытку в личной учетной записи.
- JDK 8 или более поздней версии
- Убедитесь, что исполняемый
java файл находится в вашем PATH
- Проверьте установку: в командной оболочке выполните команду
java -version , чтобы убедиться, что версия 8 или более поздняя.
- Maven 3.6.3 или более поздней версии
- Убедитесь, что исполняемый
mvn файл находится в вашем PATH
- Проверьте установку: в командной оболочке выполните команду
mvn -version , чтобы убедиться, что версия 3.6.3 или более поздняя
Установите пакет
В этом разделе описывается установка клиентской библиотеки Kusto в вашей среде.
В следующей таблице перечислены клиентские библиотеки и соответствующие имена пакетов.
| Имя библиотеки |
Description |
| Библиотека данных Kusto |
Предоставляет клиент для подключения к кластерам. Используйте клиентская библиотека для запроса данных или выполнения команд управления. |
| Библиотека Ингестии Kusto |
Предоставляет клиент для приема данных в кластеры. Для получения дополнительной информации см. обзор библиотеки Kusto Ingest в вашем кластере. |
Добавьте клиентские библиотеки Kusto для предпочитаемого языка в проект. Используйте диспетчер пакетов, соответствующий вашему языку, чтобы установить клиентские библиотеки.
dotnet add package Microsoft.Azure.Kusto.Data --version 11.2.2
dotnet add package Microsoft.Azure.Kusto.Ingest --version 11.2.2
python -m pip install azure-kusto-data
python -m pip install azure-kusto-ingest
npm install azure-kusto-data
npm install azure-kusto-ingest
Используйте шаблон Maven-archetype-quickstart Maven для создания приложений, как показано ниже.
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. Используйте их в качестве отправной точки для приложения, изменив код или включив в проект определенные разделы.
Узнайте, как создавать приложения, использующие клиентские библиотеки
В следующих статьях описывается создание приложений, использующих клиентские библиотеки Kusto.
Связанный контент