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

2024/12/20

適用於：✅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
- 確認安裝：在命令提示字元中，執行 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 用戶端連結庫來提示驗證。
  
  注意
  
  如果您屬於組織，則根據組織設定的限制可能會讓您無法進行驗證。請求組織系統管理員授予存取權限，或使用個人帳戶再次嘗試。

安裝套件

本節將逐步引導您在環境中安裝 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>

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