设置开发环境以使用 Kusto 客户端库

以下一个或多个 .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 或更高版本

• 使用 ES6 构建的 Node 16 或更高版本

  • 确保 node 可执行文件位于 PATH 中
  • 验证安装：在命令行界面中，运行 node --version 以检查版本是否为 3.7 或更高版本

• Node.js 应用或基于浏览器的 Web 应用，例如 React 应用。

• 对于基于浏览器的 Web 应用：

  • 如果你的应用具有登录体验，你可以使用 @auzre/identity 库来颁发授权令牌，并使用 withTokenProvider 将此令牌馈送到 Kusto 客户端：

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

  • 如果你的应用没有登录体验，或者你希望使用 Kusto 客户端库来提示身份验证，则需要为应用程序注册设置必要的权限：

    1. 创建 Microsoft Entra 应用程序注册。
    2. 在“身份验证”选项卡中，选择“+ 添加平台”。 然后，选择“单页应用程序”。
    3. 输入所需的“重定向 URI”，选择“访问令牌”框和“ID 令牌”框，然后选择“配置”。 有关重定向 URI 的详细信息，请参阅调用 Web API 的桌面应用。
    4. 为应用程序配置委托的权限。
    5. 授予应用程序对 Azure 数据资源管理器数据库的访问权限。
    6. 在概览选项卡中，复制应用程序（客户端）ID。

    以下教程中的示例使用 Kusto 客户端库来提示身份验证。

    注意

    如果你属于某个组织，则基于组织配置的限制可能会阻止你进行身份验证。 请向组织管理员请求访问权限，或在个人帐户上重试。

• JDK 8 或更高版本
  • 确保 java 可执行文件位于 PATH 中
  • 验证安装：在命令行界面中，运行 java -version 以检查版本是否为 8 或更高版本
• Maven 3.6.3 或更高版本
  • 确保 mvn 可执行文件位于 PATH 中
  • 验证安装：在命令行界面中，运行 mvn -version 以检查版本是否为 3.6.3 或更高版本

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>

还需要在 pom.xml 中添加 maven-compiler-plugin 和 exec-maven-plugin 插件。 如果它们尚不存在，请按如下所示添加它们。

<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>

C# 快速入门应用

Python 快速入门应用

• Node.js 快速入门应用
• 浏览器快速入门应用

Java 快速入门应用