Kusto.Explorer は無料の Windows デスクトップ ツールです。 これを使用して、わかりやすいインターフェイスで Kusto クエリ言語 (KQL) を使用してデータのクエリと分析を行います。 この記事では、Kusto.Explorer とそのユーザー インターフェイスを設定する方法について説明します。
Kusto.Explorer を使用して次の操作を行ってください。
- データのクエリを実行する
- テーブル間でデータを検索する。
- グラフでデータを視覚化します 。
- 電子メールまたはディープ リンクでクエリと結果を共有します。
Kusto.Explorer のインストール
次の場所から Kusto.Explorer をダウンロードしてインストールします。
または、ClickOnce 対応ブラウザーを使用して、Kusto クラスターにアクセスします。
https://<your_cluster>/?web=0<your_cluster>プレースホルダーをクラスター URI (たとえば、help.kusto.windows.net) に置き換えます。
Kusto.Explorer で Google Chrome を使用する
Google Chrome が既定のブラウザーである場合は、ClickOnce 拡張機能をインストールします。 Chrome 用 ClickOnce 拡張機能
Microsoft Edge が既定のブラウザーである場合、この拡張機能は必要ありません。 Microsoft Edge フラグの ClickOnce 設定を確認します。
ユーザー インターフェイスの概要
Kusto.Explorer では、タブとパネルが使用されます。
接続パネル
![ヘルプ クラスターのデータベースを示す [接続] パネルのスクリーンショット。](media/kusto-explorer/connections-panel.png?view=azure-data-explorer#lightbox)
[ 接続] パネルには、構成されているすべてのクラスター接続が一覧表示されます。 クラスターごとに、データベース、テーブル、列が一覧表示されます。 メイン パネルで検索またはクエリのコンテキストを設定する項目を選択します。 検索またはクエリ パネルに名前をコピーするには、項目をダブルクリックします。
スキーマが大きい場合 (数百のテーブルを含むデータベースなど)、 Ctrl+F を選択し、検索するエンティティ名の大文字と小文字を区別しない部分を入力します。
スクリプト化されたワークフローをサポートするには、クエリ ウィンドウから [接続] パネルを制御します。 スクリプトがクエリを実行するクラスターとデータベースに接続するように Kusto.Explorer に指示するコマンドを使用してスクリプトを開始します。
#connect cluster('help').database('Samples')
StormEvents | count
F5 キーを使用して各行を実行します。
[作業ドキュメント] ウィンドウ
![[未保存の作業] フォルダーと [追跡済み] フォルダーを示す [作業ドキュメント] ウィンドウのスクリーンショット。](media/kusto-explorer/work-folders-pane.png?view=azure-data-explorer#lightbox)
[ワーク フォルダー] ウィンドウには、クイック ナビゲーション用のワーク フォルダーが整理されています。 これには、次の 2 つの種類が含まれます。
- 保存されていない作業: まだ編集中の開いているクエリ タブのフォルダー
- 追跡フォルダー: アクセスと管理を容易にするために KQL ライブラリとして追加するデバイス フォルダー
メニュー パネル
ホーム タブ
![[ホーム] タブの 5 つのセクションを示す [ホーム] タブのスクリーンショット。](media/kusto-explorer/home-tab.png?view=azure-data-explorer#lightbox)
[ホーム] タブには、最も頻繁に使用される操作が表示されます。 次の情報が含まれます。
[クエリ] セクション
![クエリの新しいタブを作成するためのオプションを示す [タブ] というタイトルの [ホーム] タブ セクションのスクリーンショット。](media/kusto-explorer/home-query-menu.png?view=azure-data-explorer#lightbox)
| メニュー | Behavior |
|---|---|
| モードのドロップダウン |
|
| 新しいタブ | Kusto クエリ言語 (KQL) の新しいクエリ タブを開きます。 |
[共有] セクション
![3 つのオプションを示す [共有] というタイトルの [ホーム] タブ セクションのスクリーンショット。](media/kusto-explorer/home-share-menu.png?view=azure-data-explorer)
| メニュー | Behavior |
|---|---|
| Data To Clipboard\(データをクリップボードに\) | クエリとデータセットをクリップボードにコピーします。 グラフが表示されている場合は、グラフもビットマップとしてコピーします。 |
| Result To Clipboard\(結果をクリップボードに\) | データセットをクリップボードにコピーします。 グラフが表示されている場合は、グラフもビットマップとしてコピーします。 |
| Query to Clipboard\(クエリをクリップボードに\) | クエリをクリップボードにコピーします。 |
[視覚化] セクション
![データを視覚化するためのさまざまなオプションを示す [視覚化] というタイトルの [ホーム] タブ セクションのスクリーンショット。](media/kusto-explorer/home-visualizations-menu.png?view=azure-data-explorer)
視覚化オプションの詳細については、 render 演算子を参照してください。
| メニュー | Behavior |
|---|---|
| 面グラフ | 最初の列 (数値) が X 軸である面グラフを示します。 各数値列を個別の Y 軸系列にマップします。 |
| 縦棒グラフ | すべての数値列が異なる系列 (Y 軸) にマップされている縦棒グラフを表示します。 数値の前のテキスト列は X 軸です (UI で制御できます)。 |
| 横棒グラフ | すべての数値列が異なる系列 (X 軸) にマップされている横棒グラフを示します。 数値の前のテキスト列は Y 軸です (UI で制御できます)。 |
| 積み上げ面グラフ | X 軸が最初の列 (数値である必要があります) である積み上げ面グラフを表示します。 すべての数値列が異なる系列 (Y 軸) にマップされます。 |
| 時間グラフ | X 軸が最初の列である時間グラフを表示します (datetime である必要があります)。 すべての数値列が異なる系列 (Y 軸) にマップされます。 |
| 折れ線グラフ | X 軸が最初の列である折れ線グラフを表示します (数値にする必要があります)。 すべての数値列が異なる系列 (Y 軸) にマップされます。 |
| 異常グラフ | タイム チャートに似ていますが、機械学習アルゴリズムを使用して時系列データの異常を検出します。 データには固定間隔バケットを使用する必要があります。 異常を検出するため、Kusto.Explorer では series_decompose_anomalies 関数が使用されます。 |
| 円グラフ | 色軸が最初の列である円グラフを表示します。 2番目の列は、θ軸で、計測値をパーセントに変換したものです。 |
| Time Ladder\(時間ラダー\) | X 軸が最後の 2 つの列 (datetime である必要があります) であるラダー グラフを表示します。 Y 軸は、他の列の複合です。 |
| 散布図 | X 軸が最初の列 (数値である必要があります) であるポイント グラフを表示します。 すべての数値列が異なる系列 (Y 軸) にマップされます。 |
| ピボット グラフ | データ、列、行、グラフの種類を選択できるピボット テーブルとグラフを表示します。 |
| Time Pivot\(時間ピボット\) | イベント タイムラインを対話形式で移動できます (時間軸上のピボット)。 |
[表示] セクション
![データ ビューを変更するためのオプションを示す [ビュー] というタイトルの [ホーム] タブ セクションのスクリーンショット。](media/kusto-explorer/home-view-menu.png?view=azure-data-explorer)
| メニュー | Behavior |
|---|---|
| Full View Mode\(全画面表示モード\) | リボン メニューと接続パネルを非表示にして、ワークスペースを最大化します。 全画面表示モードを終了するには、[ホーム]>[Full View Mode]\(全画面表示モード\) を選択するか、F11 キーを押します。 |
| Hide Empty Columns\(空の列を非表示にする\) | データ グリッドから空の列を削除します。 |
| Collapse Singular Columns\(特異値の列を折りたたむ\) | 単数形の値を持つ列を折りたたみます。 |
| Explore Column Values\(列の値を調べる\) | 列値の分布を表示します。 |
| フォントを増やす | クエリ タブと結果グリッドのフォント サイズを増やします。 |
| フォントの縮小 | クエリ タブと結果グリッドのフォント サイズを小さくします。 |
Note
データ ビューの設定:
Kusto.Explorer では、列の一意のセットごとに設定が追跡されます。 列の順序を変更または削除すると、データ ビューが保存され、同じ列を持つデータを取得するときに再利用されます。 ビューを既定値にリセットするには、[ 表示 ] タブで [ ビューのリセット] を選択します。
[ファイル] タブ
![[ファイル] タブの 5 つのセクションを示す [ファイル] タブのスクリーンショット。](media/kusto-explorer/file-tab.png?view=azure-data-explorer)
| メニュー | Behavior |
|---|---|
| クエリ スクリプト | |
| 新しいタブ | Kusto に対してクエリを実行するための新しいタブ ウィンドウを開きます。 |
| [ファイルを開く] | アクティブなクエリ ウィンドウに .kql スクリプトを読み込みます。 |
| ファイルに保存 | アクティブなスクリプトを .kql ファイルに保存します。 |
| タブを閉じる | 現在のタブを閉じます。 |
| Profiles | |
| インポート プロファイル | Kusto.Explorer プロファイルをインポートします。 |
| エクスポート ファイル | Kusto.Explorer プロファイルをエクスポートします。 |
| データを保存する | |
| Data To CSV\(データを CSV に\) | CSV (コンマ区切り値) ファイルにデータをエクスポートします。 |
| Data To JSON\(データを JSON に\) | JSON 形式のファイルにデータをエクスポートします。 |
| Data To Excel\(データを Excel に\) | XLSX (Excel) ファイルにデータをエクスポートします。 |
| Data To Text\(データをテキストに\) | TXT (テキスト) ファイルにデータをエクスポートします。 |
| Data To KQL Script\(データを KQL スクリプトに\) | クエリをスクリプト ファイルにエクスポートします。 |
| Data To Results\(データを結果に\) | クエリとデータを結果 (QRES) ファイルにエクスポートします。 |
| Run Query Into CSV\(クエリを実行して CSV に\) | クエリを実行し、結果をローカル CSV ファイルに保存します。 |
| データの読み込み | |
| From Results\(結果から\) | 結果 (QRES) ファイルからクエリとデータを読み込みます。 |
| クリップボード | |
| Query and Results To Clipboard\(クエリと結果をクリップボードに\) | クエリとデータセットをクリップボードにコピーします。 グラフが表示されている場合は、グラフをビットマップとしてコピーします。 |
| Result To Clipboard\(結果をクリップボードに\) | データセットをクリップボードにコピーします。 グラフが表示されている場合は、グラフをビットマップとしてコピーします。 |
| クリップボードへのクエリ | クエリをクリップボードにコピーします。 |
| クリップボードへの結果 (datatable()) | クエリ結果をクリップボードにコピーします。 許可されるセルの最大値は 30,000 です。 |
| Results | |
| Clear results cache\(結果のキャッシュをクリア\) | 以前に実行されたクエリのキャッシュされた結果をクリアします。 |
[接続] タブ
![[接続] タブの 5 つのセクションを示す [接続] タブのスクリーンショット。](media/kusto-explorer/connections-tab.png?view=azure-data-explorer)
| メニュー | Behavior |
|---|---|
| グループ | |
| グループの追加 | Kusto サーバー グループを追加します。 |
| クラスター | |
| Import Connections\(接続のインポート\) | ファイルから接続をインポートします。 |
| Export Connections\(接続のエクスポート\) | 接続をファイルにエクスポートします。 |
| 接続の追加 | Kusto サーバー接続を追加します。 |
| 接続の編集 | [接続プロパティ] ダイアログを開きます。 |
| つながりを削除する | Kusto サーバー接続を削除します。 |
| 最新のステータスに更新 | 接続プロパティを更新します。 |
| Profiles | |
| インポート プロファイル | Kusto.Explorer プロファイルをインポートします。 |
| エクスポート ファイル | Kusto.Explorer プロファイルをエクスポートします。 |
| Security | |
| Inspect Your ADD Principal\(ADD プリンシパルを検査する\) | 現在サインインしているユーザーの詳細を表示します。 |
| サインアウト | Microsoft Entra ID から現在のユーザーをサインアウトします。 |
| データ スコープ | |
| Caching scope\(キャッシュ スコープ\) |
|
| DateTime 列 | タイム プレフィルターに使用できる列の名前。 |
| 時間フィルター | タイムプリフィルターの値 |
[表示] タブ
![[表示] タブのスクリーンショット。[外観]、[データ ビュー]、[データ フィルター]、[視覚化] の 4 つのセクションが表示されています。](media/kusto-explorer/view-tab.png?view=azure-data-explorer)
| メニュー | Behavior |
|---|---|
| 外観 | |
| Full View Mode\(全画面表示モード\) | リボン メニューと接続パネルを非表示にして、ワークスペースを最大化します。 ホーム>フルビューモードを選択するか、**F11キーを押してフルビューモードを終了します。 |
| フォントの拡大 | クエリ タブと結果データ グリッドのフォント サイズを増やします。 |
| フォントの縮小 | クエリ タブと結果データ グリッドのフォント サイズを小さくします。 |
| レイアウトのリセット | ドッキング レイアウトとウィンドウをリセットします。 |
| Rename Document Tab\([ドキュメント] タブの名前変更\) | 選択したタブの名前を変更します。 |
| データ ビュー | |
| ビューのリセット | データ ビューの設定を既定値にリセットします。 |
| Explore Column Values\(列の値を調べる\) | 列値の分布を表示します。 |
| Focus on Query Statistics\(クエリ統計にフォーカスする\) | クエリの終了時に、結果ではなくクエリ統計を表示します。 |
| 重複データ非表示 | 結果から重複する行の削除を切り替えます。 |
| Hide Empty Columns\(空の列を非表示にする\) | 結果から空の列を削除します。 |
| Collapse Singular Columns\(特異値の列を折りたたむ\) | 1 つの値を含む列を折りたたみます。 |
| 行の選択 | 結果パネルで特定の行を選択できるようにします。 |
| 列別の色 | 最初の列で同じ値を色付けします。 |
| 折り返して全体を表示する | 列の幅に合わせてセルの内容を折り返します。 |
| データ フィルター処理 | |
| Filter Rows In Search\(検索で行をフィルター処理する\) | 検索時に一致する行のみを表示する切り替え ( Ctrl + F キー)。 |
| 視覚化 | |
| 視覚化 | 「視覚化」をご覧ください。 |
Note
Kusto.Explorer は、一意の列セットごとの設定を追跡します。 列の順序を変更または削除すると、データ ビューが保存され、同じ列を持つデータを取得するときに再利用されます。 既定値にリセットするには、[ 表示 ] タブで [ビューの リセット] を選択します。
[ツール] タブ
![6 つのセクションを示す [ツール] タブのスクリーンショット。](media/kusto-explorer/tools-tab.png?view=azure-data-explorer)
| メニュー | Behavior |
|---|---|
| IntelliSense | |
| [IntelliSense を有効にする] | [スクリプト] パネルで IntelliSense を有効または無効にします。 |
| 問題リスト | [スクリプト] パネルの問題を一覧表示します。 |
| Automation | |
| 新しいオートメーションの追加 | クエリ分析情報を含むレポートを生成します。 |
| 公共サービス | |
| コマンド ライン ツール | コマンド プロンプトを開きます。 |
| LZ4 ファイルの圧縮 | LZ4 アルゴリズムを使用してファイルを圧縮します。 |
| LZ4 ファイルの展開 | LZ4 アルゴリズムを使用してファイルを展開します。 |
| Analytics | |
| 分析レポート | 事前構築済みのデータ分析レポートを含むダッシュボードを開きます。 |
| Translate | |
| Power BI へのクエリ | クエリを Power BI 形式に変換します。 |
| WPA へのクエリ | クエリを WPA 形式に変換します。 |
| WPA へのクエリ (クリップボード) | クエリを WPA 形式に変換し、クリップボードにコピーします。 |
| オプション | |
| オプションのリセット | アプリ設定を既定値にリセットします。 |
| オプション | アプリ設定を構成するためのオプション ツールを開きます。 詳細については、「 Kusto.Explorer のオプション」を参照してください。 |
テーブルの行の色
Kusto.Explorer は、結果パネルで各行の重大度または詳細レベルを解釈し、それに応じて行に色を付けます。 個別の列値を既知のパターン ("警告"、"エラー" など) と一致させます。
出力の配色パターンを変更するか、この動作をオフにするには、[ ツール>オプション>Results Viewer>Verbosity 配色を選択します。
| [Excel] 配色の凡例 | [鮮やか] 配色の凡例 |
|---|---|
|
|
[監視] タブ
![データを監視するための 2 つのオプションがある [監視] タブのスクリーンショット。](media/kusto-explorer/monitoring-tab.png?view=azure-data-explorer)
| メニュー | Behavior |
|---|---|
| モニター | |
| クラスターの診断 | [接続] パネルで現在選択されているサーバー グループの正常性の概要を表示します。 |
| 最新のデータ: すべてのテーブル | 現在選択されているデータベースのすべてのテーブルの最新データの概要を表示します。 |
| 最新のデータ: 選択したテーブル | 選択したテーブルの最新のデータをステータス バーに表示します。 |
[管理] タブ
![承認されたプリンシパルを管理するためのオプションを示す [管理] タブのスクリーンショット。](media/kusto-explorer/management-tab.png?view=azure-data-explorer)
| メニュー | Behavior |
|---|---|
| 承認された主体 | |
| Manage Database Authorized Principals\(データベースの承認されたプリンシパルを管理する\) | 承認されたユーザーがデータベース プリンシパルを管理できるようにします。 |
| Manage Table Authorized Principals\(テーブルの承認されたプリンシパルを管理する\) | 承認されたユーザーがテーブル プリンシパルを管理できるようにします。 |
| Manage Function Authorized Principals\(関数の承認されたプリンシパルを管理する\) | 承認されたユーザーが関数プリンシパルを管理できるようにします。 |
[ヘルプ] タブ
![ドキュメントのオプションを示す [ヘルプ] タブのスクリーンショット。](media/kusto-explorer/help-tab.png?view=azure-data-explorer)
| メニュー | Behavior |
|---|---|
| ドキュメンテーション | |
| Help | Kusto オンライン ドキュメントを開きます。 |
| 新機能 | Kusto.Explorer のリリース ノートを開きます。 |
| キーボード ショートカット | Kusto.Explorer のキーボード ショートカットを開きます。 |
| EULA を表示する | Microsoft Azure の法的情報に関する記事を開きます。 |
| サポートとフィードバック | |
| 問題レポート | 次の 2 つのオプションを含むダイアログを開きます。 |
| 機能の提案 | アイデアを共有するページを開きます。 |
| Kusto サポート (KAI ボット) | セルフサービス、プロアクティブ なガイダンス、自律的なトラブルシューティングのために KAI を開きます。 |
Kusto.Explorer に接続するユーザー ID を制御する
新しい接続の既定のセキュリティ モデルは、Microsoft Entra ID フェデレーション セキュリティです。 認証では、既定の Microsoft Entra サインイン エクスペリエンスで Microsoft Entra ID が使用されます。
認証パラメーターを細かく制御するには、[ 詳細設定: 接続文字列 ] ボックスを展開し、有効な Kusto 接続文字列を入力します。
たとえば、複数の Microsoft Entra テナントのユーザーは、ターゲット テナント内の特定の ID を選択する必要がある場合があります。 接続文字列を使用して指定します。 山括弧内の仮の値を、あなた自身の値に置き換えてください。
Data Source=https://<ClusterName>.kusto.windows.net;Initial Catalog=<DatabaseName>;AAD Federated Security=True;Authority Id=<TenantId>;User=<UserIdentity>
-
<TenantId>は、クラスターをホストするテナントのドメイン名または Microsoft Entra テナント ID (GUID) です (たとえば、contoso.com)。 -
<UserIdentity>は、そのテナントに招待されたユーザー ID です (たとえば、 user@example.com)。
Note
ユーザーのドメイン名は、クラスターをホストするテナントと異なる場合があります。
![[接続の追加] ウィンドウのスクリーンショット。[高度な接続文字列] というタイトルのオプションが表示されています。](media/kusto-explorer/advanced-connection-string.png?view=azure-data-explorer)