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

適用於：✅Microsoft Fabric✅Azure 數據總管

瞭解如何設定環境以使用 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，勾選[存取令牌] 和 [ID 令牌]方框，然後選取[設定] 。 如需重新導向 URI 的詳細資訊，請參閱 呼叫 Web API 的桌面應用程式。
    4. 設定應用程式的委派許可權。
    5. 授與應用程式對資料庫的存取權。
    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 資料引入庫概觀 到您的叢集。

將慣用語言的 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，將 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>

您也需要在 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 快速入門應用程式
• Browser 快速入門應用程式

Java

Java 快速啟動應用程式

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

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

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

相關內容

• KQL 快速參考指南

• 範例應用程式產生器精靈