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

適用於：✅Microsoft Fabric✅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 以確認已安裝的版本符合最低要求。

使用ES6建置的節點16或更新版本
- 確定 node 可執行檔位於您的 PATH
- 驗證安裝：在命令 shell 中，執行 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 令牌]方框，然後選取[設定] 。進一步了解具備呼叫 Web API 功能的桌面應用程式中的重新導向 URI。
  4. 設定應用程式的委派許可權。
  5. 授與應用程式對資料庫的存取權。
  6. 在 [概觀] 索引標籤中，複製 [應用程式（用戶端）識別碼。
下列教學課程中的範例會使用 Kusto 用戶端連結庫來提示驗證。

注意

如果您屬於組織，則根據組織設定的限制可能會讓您無法進行驗證。請求組織系統管理員授予存取權限，或使用個人帳戶再次嘗試。

安裝套件

本節將逐步引導您在環境中安裝 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 用戶端程式庫進行驗證、管理、查詢及擷取資料。透過修改程式碼或將特定部分合併到專案中，將它們用作應用程式的起點。

C# 快速入門應用程式