Azure Data Explorer Kusto エミュレーターをインストールする

[アーティクル]
12/08/2023

Azure Data Explorer Kusto エミュレーターは、次の方法でインストールできます。

独自のデバイス: ローカル開発環境をプロビジョニングする必要がある場合は、このオプションの使用を検討してください
CI/CD エージェント仮想マシン (VM): 自動テストを実行するために CI/CD パイプラインが必要な場合は、このオプションを使用します

エミュレーターは、 Windows または Linux Docker コンテナーイメージとして使用できます。

この記事では、次の方法について学習します。

Kusto エミュレーターをインストールする
エミュレーターに接続する
データベースの作成
データの取り込み
クエリデータ

前提条件

ホストオペレーティングシステムは、次のいずれかである必要があります。
- Windows Server 2022
- Windows Server 2019 バージョン 10.0.17763.2928 以降
- Windows 11
- Docker Client for Linux をサポートする Linux ディストリビューション
  
  重要
  
  Linux ディストリビューションでは、Linux コンテナーイメージのみがサポートされます。
最小 2 ギガバイト (GB) の RAM。4 GB 以上を使用することをお勧めします
Docker Client for Windows または Linux

Kusto エミュレーターをインストールする

次の手順は、PowerShell を使用して Kusto エミュレーターコンテナーイメージを使用してエミュレーターを起動するための手順です。その他のオプションについては、「エミュレーターオプションを実行する」を参照してください。

Windows の場合のみ、Windows コンテナーで実行するように Docker を切り替えます。 Docker 設定でこの機能を有効にする必要がある場合があります。
次のコマンドを実行してエミュレーターを起動します。

重要

Kusto エミュレーターコンテナーイメージは、 Microsoft ソフトウェアライセンス条項に基づく無料のオファリングです。エミュレーターはコンテナーで実行されるため、環境変数をコンテナーに渡 ACCEPT_EULA し、その値をを示す値に設定して、ライセンス条項に同意する Y 必要があります。
注意
- このコマンドを初めて実行すると、Docker はサイズが数 GB のコンテナーイメージをプルし、ダウンロードに数分かかる場合があります。ダウンロードされると、イメージはキャッシュされ、再度ダウンロードしなくても後続の実行に使用できます。
- (Windows コンテナーの場合のみ)コンテナーはプロセス分離モードで実行する必要があります。これは、一部のバージョンの Docker の既定値です。他のバージョンの場合は、run コマンドにを追加 --isolation=hyperv することで、Hyper-V 分離モードでコンテナーを開始できます。
- Windows Server オペレーティングシステムで Windows コンテナーを起動するには、または stable タグをlatest使用していることを確認します。
```
docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest
```
- Windows 11で Windows コンテナーを起動するには、タグをwindows11使用していることを確認します。
```
docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:windows11
```
- Linux コンテナーを起動するには:
```
docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest
```
次のコマンドを実行して、コンテナーが実行されていることを確認します。
```
docker ps
```
コマンドは、実行中のコンテナーインスタンスの一覧を返します。エミュレーターイメージ mcr.microsoft.com/azuredataexplorer/kustainer:latest が一覧に表示されることを確認します。
```
CONTAINER ID   IMAGE                                                  COMMAND                  CREATED          STATUS          PORTS                    NAMES
a8b51bce21ad   mcr.microsoft.com/azuredataexplorer/kustainer:latest   "powershell -Command¦"   11 minutes ago   Up 10 minutes   0.0.0.0:8080->8080/tcp   contoso
```

次のコマンドを実行して、Kusto エミュレーターが実行されていることを確認します。このコマンドは、管理 API に.show cluster対してクエリを実行し、値 200 の StatusCode を返す必要があります。

Invoke-WebRequest -Method post -ContentType 'application/json' -Body '{"csl":".show cluster"}' http://localhost:8080/v1/rest/mgmt

コマンドは次のように返されます。

StatusCode        : 200
StatusDescription : OK
Content           : {"Tables":[{"TableName":"Table_0","Columns":[{"ColumnName":"NodeId","DataType":"String","ColumnType":"string"},{"ColumnName":"Address","DataType":"St
                    ring","ColumnType":"string"},{"ColumnName":"Name","...
RawContent        : HTTP/1.1 200 OK
                    Transfer-Encoding: chunked
                    x-ms-client-request-id: unspecified;d239f3aa-7df0-4e46-af0a-edd7139d0511
                    x-ms-activity-id: a0ac8941-7e4c-4176-98fa-b7ebe14fae90
                    Content-Type: application...
Forms             : {}
Headers           : {[Transfer-Encoding, chunked], [x-ms-client-request-id, unspecified;d239f3aa-7df0-4e46-af0a-edd7139d0511], [x-ms-activity-id,
                    a0ac8941-7e4c-4176-98fa-b7ebe14fae90], [Content-Type, application/json]...}
Images            : {}
InputFields       : {}
Links             : {}
ParsedHtml        : System.__ComObject
RawContentLength  : 988

エミュレーターオプションを実行する

エミュレーターを実行するときは、次のいずれかのオプションを使用できます。

コンテナーにローカルフォルダーをマウントする: ホスト環境のフォルダーをコンテナーにマウントするには、このオプションを使用します。ホストフォルダーをマウントすると、クエリでローカルファイルを操作できます。これは、コンテナーの実行とデータの取り込みの間に永続的なデータベースを作成するのに役立ちます。

たとえば、ホスト上のフォルダー "D:\host\local" をコンテナー内のフォルダー "c:\kustodatadata" にマウントするには、Windows Server で次のコマンドを使用します。
```
docker run -v d:\host\local:c:\kustodata -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest
```
別のポートで実行する: Kusto エミュレーターは、ポート 8080 の Kusto クエリエンジンへのアクセスを公開します。そのため、他の例では、ホストポート 8080 をエミュレーターポート 8080 にマップしました。このオプションを使用すると、別のホストをエンジンにマップできます。

たとえば、ホスト上のポート 9000 をエンジンにマップするには、Windows Server で次のコマンドを使用します。
```
docker run -e ACCEPT_EULA=Y -m 4G -d -p 9000:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest
```

エミュレーターに接続する

次のいずれかのツールを使用して、エミュレーターに接続して操作できます。

次のセクションでは、Kusto を使用します。データベースの作成、データの取り込み、クエリの実行をエクスプローラーします。詳細については、「Kusto.エクスプローラーの使用」を参照してください。

重要

Kusto Emulator では、HTTPS またはMicrosoft Entra認証はサポートされていません。

最初に、[ツール>] [オプション][接続] [安全でない接続を許可する]>> で安全でない接続を許可する必要があります。

Kusto エクスプローラー接続オプションのスクリーンショット。

次の図では、[ 接続の追加] プロパティの影響を受けるフィールドが強調表示されています。

クラスター接続は、ではなく https://でhttp://始まる必要があります。
[セキュリティ>の詳細設定: 接続文字列] で、Microsoft Entra認証をAAD Federated Security=True無効にするには、接続文字列の部分を削除する必要があります。

Kusto エクスプローラー単一接続のセットアップのスクリーンショット。

データベースを作成する

データを格納してクエリを実行するには、データベースを作成するか、エミュレーターを既存のデータベースにアタッチします。

データベースは、コンテナーフォルダーまたはマウントされたフォルダーに保存できます。前者の有効期間はコンテナーにバインドされているため、コンテナーを再起動すると変更は失われます。また、コンテナー仮想ストレージは、ネイティブストレージよりも効率が低くなります。マウントされたフォルダーを使用すると、コンテナーの実行間でデータを保持できます。

この例では、データをコンテナーに保持します。

Kusto.エクスプローラークエリモードで、次のコマンドを実行して、Windows コンテナーイメージを使用する場合は永続的なデータベースを作成します。

.create database <YourDatabaseName> persist (
  @"c:\kustodata\dbs\<YourDatabaseName>\md",
  @"c:\kustodata\dbs\<YourDatabaseName>\data"
  )

Linux コンテナーイメージの同等のコマンドは次のとおりです。

.create database <YourDatabaseName> persist (
  @"/kustodata/dbs/<YourDatabaseName>/md",
  @"/kustodata/dbs/<YourDatabaseName>/data"
  )

このコマンドでは、既存の情報を過剰に書き込むのを防ぐために、フォルダーがまだ存在していない必要があります。既存のデータベースにアタッチするには、代わりに次のコマンドを使用して、で md終わるパスを指定します。

.attach database <YourDatabaseName> from @"<PathToMdFolder>"

エミュレーターからデータベースをデタッチすることもできます。これにより、すべてのデータベースメタデータとデータはそのまま保持されます (将来、再アタッチできます)。

.detach database <YourDatabaseName>

データの取り込み

データを取り込むには、まずファイルにリンクされた外部テーブルを作成してから、データベース内のテーブルにデータを取り込む必要があります。

次の例の手順を使用して、外部テーブルを作成し、そのテーブルにデータを取り込みます。この例では、ローカルフォルダー c:\kustodata に、次のデータを含むという sample.csv ファイルを作成します。

Alice, 1
Bob, 2
Carl, 3

次のコマンドを実行して、データを受信するテーブルを作成します。
```
.create table MyIngestedSample(Name:string, Id:int)
```
次のコマンドを実行して、ファイルをテーブルに取り込みます。
```
.ingest into table MyIngestedSample(@"c:\kustodata\sample.csv")
```

クエリデータ

次のクエリを使用して、テーブル内のデータを表示できます。

MyIngestedSample
| summarize sum(Id), avg(Id)

コンテナーの停止

コンテナー ID を取得するには、次のコマンドを実行してコンテナーを停止できます。
```
docker ps
```
コンテナー ID で次のコマンドを実行します。
```
docker stop <containerID>
```

Kusto クエリ言語 (KQL) の概要

次の方法で共有

Azure Data Explorer Kusto エミュレーターをインストールする

前提条件

Kusto エミュレーターをインストールする

エミュレーターオプションを実行する

エミュレーターに接続する

データベースを作成する

データの取り込み

クエリデータ

コンテナーの停止

フィードバック

その他のリソース

次の方法で共有

Azure Data Explorer Kusto エミュレーターをインストールする

前提条件

Kusto エミュレーターをインストールする

エミュレーター オプションを実行する

エミュレーターに接続する

データベースを作成する

データの取り込み

クエリ データ

コンテナーの停止

関連コンテンツ

フィードバック

その他のリソース

エミュレーターオプションを実行する

クエリデータ