設定開發環境以使用 Kusto 用戶端程式庫

瞭解如何設定環境以使用 Kusto 用戶端程式庫。 您可以使用這些程式庫來建立應用程式，以連線到叢集並執行查詢或內嵌資料。

在本文中，您將瞭解如何安裝慣用語言的用戶端程式庫套件。

必要條件

選取用來建立應用程式之程式設計語言的必要條件。

注意

Kusto 用戶端程式庫與 JavaScript 和 TypeScript 相容。 若要將 TypeScript 範例轉換成 JavaScript，只需移除用於變數、參數和傳回值的型別批註。

C#

下列一或多個 .NET SDK 架構：

• .NET 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

• 使用 ES6 建置的節點 16 或更新版本

  • node確定可執行檔位於您的PATH
  • 確認安裝：在命令殼層中，執行 node --version 以檢查版本是否為 3.7 或更新版本

• Node.js 應用程式或瀏覽器型 Web 應用程式，例如React應用程式。

• 針對瀏覽器型 Web 應用程式：

  • 如果您的應用程式有登入體驗，您可以使用 @auzre/身分識別程式庫 來發出授權權杖，並使用 withTokenProvider 將此權杖饋送至 Kusto 用戶端：

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

  • 如果您的應用程式沒有登入體驗，或您想要使用 Kusto 用戶端程式庫來提示驗證，您必須以必要的許可權設定應用程式註冊：

    1. 建立Microsoft Entra應用程式註冊。
    2. 在 [ 驗證] 索引 標籤中，選取 [+ 新增平臺]。 然後，選取 [單頁應用程式]。
    3. 輸入所需的 重新導向 URI、選取 [存取權杖 和 識別碼權杖] 的方塊，然後選取 [ 設定]。 如需重新導向 URI 的詳細資訊，請參閱 呼叫 Web 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 用戶端程式庫。

下表列出用戶端程式庫和對應的套件名稱。

程式庫名稱	Description
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 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>

Kusto SDK 包含快速入門範例應用程式。 這些應用程式示範如何使用 Kusto 用戶端程式庫來驗證、管理、查詢和內嵌資料。 您可以藉由修改程式碼，或將特定區段併入專案中，以使用它們作為您自己的應用程式的起點。

C#

C# 快速入門應用程式

Python

Python 快速入門應用程式

Typescript

• Node.js 快速入門應用程式
• 瀏覽器快速入門應用程式

Java

JAVA 快速入門應用程式

瞭解如何建立使用用戶端程式庫的應用程式

下列文章將逐步引導您建立使用 Kusto 用戶端程式庫的應用程式。

• 建立您的第一個應用程式
• 建立應用程式以執行基本查詢
• 建立應用程式以執行管理命令
• 使用佇列擷取建立應用程式以取得資料

相關內容

• KQL 快速參考
• 範例應用程式產生器精靈