Kusto クライアント ライブラリを使用するように開発環境を設定する

Kusto クライアント ライブラリを使用するように環境を設定する方法について説明します。 これらのライブラリを使用して、クラスターに接続し、クエリを実行したりデータを取り込んだりするアプリを作成できます。

この記事では、優先言語用のクライアント ライブラリ パッケージをインストールする方法について説明します。

前提条件

アプリの作成に使用するプログラミング言語の前提条件を選択します。

注意

Kusto クライアント ライブラリは、JavaScript および TypeScript と互換性があります。 TypeScript の例を JavaScript に変換するには、変数、パラメーター、および戻り値に使用される型注釈を削除するだけです。

C#

次の .NET SDK フレームワークの 1 つ以上:

• .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/ID ライブラリ を使用して承認トークンを発行し、 を使用 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 Data Explorer データベースへのアクセス権を付与します。
    6. [ 概要 ] タブで、 アプリケーション (クライアント) ID をコピーします。

    次のチュートリアルの例では、Kusto クライアント ライブラリを使用して認証を求めます。

    注意

    organizationに属している場合、organization構成に基づく制限によって認証が妨げる可能性があります。 organization管理者からアクセスを求めるか、個人用アカウントでもう一度やり直してください。

Java

• JDK 8 以降
  • 実行可能ファイルが java に含まれているか確認します。 PATH
  • インストールの確認: コマンド シェルで を実行java -versionして、バージョンが 8 以降であることをチェックします
• Maven 3.6.3 以降
  • 実行可能ファイルが mvn に含まれているか確認します。 PATH
  • インストールの確認: コマンド シェルで を実行mvn -versionして、バージョンが 3.6.3 以降であることをチェックします

パッケージをインストールする

このセクションでは、Kusto クライアント ライブラリを環境にインストールする手順について説明します。

次の表に、クライアント ライブラリと、対応するパッケージ名を示します。

ライブラリ名	説明
Kusto データ ライブラリ	クラスターに接続するためのクライアントを提供します。 クライアント ライブラリを使用して 、データのクエリを実行 するか 、管理コマンドを実行します。
Kusto Ingest ライブラリ	クラスターにデータを取り込むためのクライアントを提供します。 詳細については、「クラスターへの データの取り込み 」を参照してください。

任意の言語の 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>

また、 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#

C# クイック スタート アプリ

Python

Python クイック スタート アプリ

Typescript

• Node.js クイック スタート アプリ
• ブラウザー クイック スタート アプリ

Java

Java クイック スタート アプリ

クライアント ライブラリを使用するアプリを作成する方法について説明します

次の記事では、Kusto クライアント ライブラリを使用するアプリの作成について説明します。

• 初めてのアプリの作成
• 基本的なクエリを実行するアプリを作成する
• 管理コマンドを実行するアプリを作成する
• キューに登録されたインジェストを使用してデータを取得するアプリを作成する

関連コンテンツ

• KQL クイック リファレンス
• サンプル アプリ ジェネレーター ウィザード