适用于:✅Azure 数据资源管理器
设置环境以使用 Kusto 客户端库。 通过这些库,可以创建连接到群集、运行查询或引入数据的应用。
本文介绍如何为首选语言安装客户端库包。
先决条件
选择用于创建应用的编程语言的先决条件。
注意
Kusto 客户端库与 JavaScript 和 TypeScript 兼容。 若要将 TypeScript 示例转换为 JavaScript,请删除用于变量、参数和返回值的类型注释。
以下一个或多个 .NET SDK 框架:
- .NET SDK 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 或更高版本。
- JDK 8 或更高版本
- 确保
java 可执行文件位于 PATH
- 验证安装:在命令行界面中,运行
java -version 以确认版本为 8 或更高版本。
- Maven 3.6.3 或更高版本
- 确保
mvn 可执行文件位于 PATH 中
- 验证安装:在命令行界面中,运行
mvn -version 以检查版本是否为 3.6.3 或更高版本
安装包
本部分逐步讲解如何在环境中安装 Kusto 客户端库。
下表列出了客户端库和相应的包名称。
| 库名称 |
说明 |
| Kusto 数据库 |
提供用于连接到群集的客户端。 使用客户端库查询数据或运行管理命令。 |
| Kusto 引入库 |
提供用于将数据引入群集的客户端。 有关详细信息,请参阅群集的 Kusto 引入库概述。 |
将首选语言的 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。 将kusto-data和kusto-ingest的工件版本替换为 Maven Central 上的最新可用版本。
<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>
Kusto SDK 包括快速入门示例应用程序,这些应用程序演示如何使用 Kusto 客户端库对数据进行身份验证、管理、查询和引入数据。 通过修改代码或将特定节合并到项目中,将它们用作应用程序的起点。
了解如何创建使用客户端库的应用
以下文章将指导你创建使用 Kusto 客户端库的应用。
相关内容