Kusto.Explorer のインストールとユーザー インターフェイス
Kusto。エクスプローラーは、Windowsデスクトップでダウンロードして使用するためのフリーソフトウェアです。 Kusto。エクスプローラーを使用すると、使いやすいインターフェイスで Kusto 照会言語 (KQL) を使用してデータのクエリと分析を行えます。 この概要では、Kusto を設定する方法について説明します。エクスプローラーし、使用するユーザー インターフェイスについて説明します。
Kusto.Explorer を使用すると、次のことができます。
- データのクエリを実行する。
- テーブル間でデータを検索する。
- さまざまなグラフでデータを視覚化する。
- メールまたはディープ リンクを使用してクエリと結果を共有する。
Kusto.Explorer のインストール
以下から Kusto.Explorer ツールをダウンロードしてインストールします。
または、ClickOnce 対応ブラウザーを使用して Kusto クラスターにアクセスします。
https://<your_cluster>/?web=0
your_cluster>をクラスター URI に置き換えます <(例:help.kusto.windows.net
)。
Google Chrome と Kusto.Explorer の使用
Google Chrome が既定のブラウザーの場合は、Chrome 用 ClickOnce 拡張機能をインストールする必要があります。 https://chrome.google.com/webstore/detail/clickonce-for-google-chro/kekahkplibinaibelipdcikofmedafmb/related?hl=en-US
既定のブラウザーが Microsoft Edge の場合、この拡張機能をインストール する必要はありません 。 Microsoft Edge フラグ設定で ClickOnce 設定を検証します。
ユーザー インターフェイスの概要
Kusto.Explorer のユーザー インターフェイスは、他の Microsoft 製品と同様に、タブとパネルに基づくレイアウトで設計されています。
接続パネル
[接続] ペインには、構成されているすべてのクラスター接続が表示されます。 クラスターごとに、データベース、テーブル、およびそれらに格納されている属性 (列) が表示されます。 項目を選択します (これによりメイン パネルの検索またはクエリに対して暗黙的なコンテキストが設定されます)。または、項目をダブルクリックして、検索またはクエリ パネルに名前をコピーします。
実際のスキーマが大きい場合 (数百のテーブルが含まれているデータベースなど)、CTRL+F キーを押して、検索対象のエンティティ名の部分文字列 (大文字と小文字を区別しない) を入力することで検索できます。
Kusto.Explorer では、クエリ ウィンドウからの接続パネルの制御がサポートされています。これは、スクリプトに便利です。 たとえば、Kusto に指示するコマンドを使用してスクリプト ファイルを開始できます。次の構文を使用して、クラスターまたはデータベースにスクリプトクエリを接続エクスプローラー。
#connect cluster('help').database('Samples')
StormEvents | count
F5
などを使用して各行を実行します。
[作業ドキュメント] パネル
[ワーク フォルダー] ウィンドウでは、作業フォルダーが 1 か所に整理され、作業の移動が容易になります。 ワーク フォルダーには次の 2 種類があります。
- 未保存の作業: 作業中の可能性がある開いているクエリ タブのフォルダーが一覧表示されます。
- 追跡フォルダー: アクセスと管理を容易にするために KQL ライブラリとして追加できるローカル デバイスのフォルダーが一覧表示されます。
メニュー パネル
[ホーム] タブ
[ホーム] タブには、最もよく使用される操作が表示されます。 次の情報が含まれます。
[クエリ] セクション
メニュー | 動作 |
---|---|
モードのドロップダウン | |
新しいタブ | Kusto 照会言語のクエリを実行するための新しいタブを開きます。 |
[共有] セクション
メニュー | 動作 |
---|---|
Data To Clipboard(データをクリップボードに) | クエリとデータセットをクリップボードにエクスポートします。 グラフが表示されている場合は、グラフをビットマップとしてエクスポートします |
Result To Clipboard(結果をクリップボードに) | データセットをクリップボードにエクスポートします。 グラフが表示されている場合は、グラフをビットマップとしてエクスポートします |
Query to Clipboard(クエリをクリップボードに) | クエリをクリップボードにエクスポートします |
[視覚化] セクション
変数の視覚化については、 render 演算子を参照してください。
メニュー | 動作 |
---|---|
面グラフ | X 軸 (数値である必要があります) が最初の列である面グラフを表示します。 すべての数値列が異なる系列 (Y 軸) にマップされます。 |
Column Chart | すべての数値列が異なる系列 (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(時間ピボット) | イベントのタイムラインでの対話型ナビゲーション (時間軸でのピボット) |
[表示] セクション
メニュー | 動作 |
---|---|
Full View Mode(全画面表示モード) | リボン メニューと接続パネルを非表示にして、ワークスペースを最大化します。 全画面表示モードを終了するには、[ホーム]>[Full View Mode](全画面表示モード) を選択するか、F11 キーを押します。 |
Hide Empty Columns(空の列を非表示にする) | データ グリッドから空の列を削除します。 |
Collapse Singular Columns(特異値の列を折りたたむ) | 単数形の値を持つ列を折りたたみます。 |
Explore Column Values(列の値を調べる) | 列の値の分布を表示します |
フォントの拡大 | クエリ タブと結果データ グリッドのフォント サイズを大きくします。 |
フォントの縮小 | クエリ タブと結果データ グリッドのフォント サイズを小さくします。 |
Note
データ ビューの設定:
Kusto.Explorer では、一意の列セットごとにどの設定が使用されているかが追跡されます。 列が並べ替えられるか削除されると、データ ビューが保存され、同じ列を持つデータが取得されるたびに再利用されます。 表示を既定値にリセットするには、 [表示] タブで、 [表示のリセット] を選択します。
[ファイル] タブ
メニュー | 動作 |
---|---|
---------クエリ* スクリプト*--------- | |
新しいタブ | Kusto に対してクエリを実行するための新しいタブ ウィンドウを開きます。 |
[ファイルを開く] | *.kql ファイルからアクティブなスクリプト パネルにデータを読み込みます。 |
ファイルに保存 | アクティブなスクリプト パネルの内容を *.kql ファイルに保存します。 |
タブを閉じる | 現在のタブ ウィンドウを閉じます |
---------プロファイル--------- | |
インポート プロファイル | Kusto をインポートします。プロファイルをエクスプローラーします。 |
プロファイルのエクスポート | Kusto をエクスポートします。プロファイルをエクスプローラーします。 |
---------データの保存--------- | |
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()) | クエリ結果をクリップボードにエクスポートします。 最大許容セル値は 30000 です。 |
---------結果*--------- | |
Clear results cache(結果のキャッシュをクリア) | 以前に実行されたクエリのキャッシュされた結果をクリアします。 |
[接続] タブ
メニュー | 動作 |
---|---|
---------グループ*--------- | |
グループの追加 | 新しい Kusto Server グループを追加します。 |
---------クラスター*--------- | |
Import Connections(接続のインポート) | 接続を指定するファイルから接続をインポートします。 |
Export Connections(接続のエクスポート) | ファイルへの接続をエクスポートします。 |
接続の追加 | 新しい Kusto Server 接続を追加します。 |
接続の編集 | Kusto Server 接続プロパティの編集に関するダイアログを開きます。 |
接続の削除 | Kusto Server への既存の接続を削除します。 |
更新 | Kusto サーバー接続のプロパティを更新します。 |
---------プロファイル--------- | |
インポート プロファイル | Kusto をインポートします。プロファイルをエクスプローラーします。 |
プロファイルのエクスポート | Kusto をエクスポートします。プロファイルをエクスプローラーします。 |
---------セキュリティ*--------- | |
Inspect Your ADD Principal(ADD プリンシパルを検査する) | 現在のアクティブなユーザーの詳細を表示します。 |
サインアウト | 現在のユーザーを接続から Microsoft Entra ID にサインアウトします。 |
---------データ* スコープ*--------- | |
Caching scope(キャッシュ スコープ) |
|
DateTime Column(DateTime 列) | 時間の事前フィルターに使用できる列の名前。 |
時間フィルター | time pre-filter の値。 |
[表示] タブ
メニュー | 動作 |
---|---|
---------表示--------- | |
Full View Mode(全画面表示モード) | リボン メニューと接続パネルを非表示にして、ワークスペースを最大化します。 全画面表示モードを終了するには、[ホーム]>[Full View Mode](全画面表示モード) を選択するか、F11 キーを押します。 |
フォントの拡大 | クエリ タブと結果データ グリッドのフォント サイズを大きくします。 |
フォントの縮小 | クエリ タブと結果データ グリッドのフォント サイズを小さくします。 |
レイアウトのリセット | ツールのドッキング コントロールとウィンドウのレイアウトをリセットします。 |
Rename Document Tab([ドキュメント] タブの名前変更) | 選択したタブの名前を変更します。 |
---------データ* ビュー*--------- | |
ビューのリセット | データ ビューの設定を既定値にリセットします。 |
Explore Column Values(列の値を調べる) | 列の値の分布を表示します。 |
Focus on Query Statistics(クエリ統計にフォーカスする) | クエリの完了時にクエリ結果ではなくクエリ統計にフォーカスを変更します。 |
重複データ非表示 | クエリ結果から重複する行の削除を切り替えます。 |
Hide Empty Columns(空の列を非表示にする) | クエリ結果から空の列を削除します。 |
Collapse Singular Columns(特異値の列を折りたたむ) | 単数形の値を持つ列を折りたたみます。 |
行の選択 | [結果] パネルで特定の行を選択できるようにします |
列別の色 | 最初の列の同一のレコードを色別にグループ化します。 |
文字列を折り返して全体を表示する | 列の幅に合わせてデータを折り返すセルの書式を設定します。 |
---------データ* フィルタリング--------- | |
Filter Rows In Search(検索で行をフィルター処理する) | クエリ結果の検索で一致する行のみを表示するオプションを切り替えます (Ctrl + F キー)。 |
---------視覚化*--------- | |
視覚化 | 「視覚化」をご覧ください。 |
Note
Kusto.Explorer では、使用されている設定が一意の列セットごとに追跡されます。 列が並べ替えられるか削除されると、データ ビューが保存され、同じ列を持つデータが取得されるたびに再利用されます。 表示を既定値にリセットするには、 [表示] タブで、 [表示のリセット] を選択します。
[ツール] タブ
メニュー | 動作 |
---|---|
---------IntelliSense*--------- | |
[IntelliSense を有効にする] | スクリプト パネルで IntelliSense を有効または無効にします。 |
懸案事項リスト | [スクリプト] パネルの問題を一覧表示します。 |
---------オートメーション--------- | |
新しいオートメーションの追加 | クエリに関する分析情報を提供する分析レポートを生成します。 |
---------ユーティリティ--------- | |
コマンドライン ツール | コンピューターでコマンド プロンプトを開きます。 |
LZ4 ファイルを圧縮する | LZ4 アルゴリズムを使用してファイルを圧縮します。 |
LZ4 ファイルの圧縮解除 | LZ4 アルゴリズムを使用してファイルを圧縮解除します。 |
---------分析*--------- | |
分析レポート | データ分析用の複数の事前構築済みレポートを含むダッシュボードを開きます。 |
---------変換--------- | |
Power BI へのクエリ | クエリを Power BI での 使用に適した形式に変換します。 |
---------オプション--------- | |
オプションのリセット | アプリケーション設定を既定値に設定します。 |
オプション | アプリケーション設定を構成するためのツールを開きます。 詳細については、「Kusto.エクスプローラー オプション」を参照してください。 |
テーブルの行の色
Kusto.Explorer では、結果パネルの各行の重大度または詳細レベルを解釈し、それに応じて色の設定を試みます。 これは、各列の個別の値を一連の既知のパターン ("警告"、"エラー"など) と照合することによって行われます。
出力の配色を変更するか、この動作をオフにするには、[ ツール ] メニューの [オプション>結果ビューアー>の詳細] 配色を選択します。
[Excel] 配色の凡例 | [鮮やか] 配色の凡例 |
---|---|
[監視] タブ
メニュー | 動作 |
---|---|
---------モニター*--------- | |
クラスターの診断 | [接続] パネルで現在選択されているサーバー グループの正常性の概要を表示します。 |
最新データ:すべてのテーブル | 現在選択されているデータベースのすべてのテーブルの最新データの概要を表示します。 |
最新データ:選択したテーブル | ステータス バーに、選択したテーブルの最新データが表示されます。 |
[管理] タブ
メニュー | 動作 |
---|---|
---------承認されたプリンシパル*--------- | |
Manage Database Authorized Principals(データベースの承認されたプリンシパルを管理する) | 承認されたユーザーのデータベースのプリンシパルを管理できるようにします。 |
Manage Table Authorized Principals(テーブルの承認されたプリンシパルを管理する) | 承認されたユーザーのテーブルのプリンシパルの管理を有効にします。 |
Manage Function Authorized Principals(関数の承認されたプリンシパルを管理する) | 承認されたユーザーの関数のプリンシパルを管理できるようにします。 |
[ヘルプ] タブ
メニュー | 動作 |
---|---|
---------ドキュメント*--------- | |
Help | Kusto オンライン ドキュメントへのリンクを開きます。 |
新着情報 | すべての Kusto を一覧表示するドキュメントを開きます。エクスプローラー変更。 |
Report Issue (問題の報告) | 次の 2 つのオプションがあるダイアログを開きます
|
キーボード ショートカット | Kusto.エクスプローラー キーボード ショートカットの一覧へのリンクを開きます。 |
EULA を表示する | Microsoft Azure の法的情報に関する記事へのリンクを開きます。 |
Kusto.Explorer に接続するユーザー ID を制御する
新しい接続の既定のセキュリティ モデルは、セキュリティMicrosoft Entra ID-Federatedです。 認証は、既定の Microsoft Entra ユーザー エクスペリエンスを使用して、Microsoft Entra ID を使用して行われます。
認証パラメーターをより細かく制御する必要がある場合は、[詳細:接続文字列] 編集ボックスを展開し、有効な Kusto 接続文字列値を指定します。
たとえば、複数のMicrosoft Entra テナントに存在するユーザーは、特定のMicrosoft Entra テナントへの ID の特定の "プロジェクション" を使用する必要がある場合があります。これは、接続文字列を通じて実行できます (IN CAPITALS という単語を特定の値に置き換えます)。
Data Source=https://CLUSTER_NAME.kusto.windows.net;Initial Catalog=DATABASE_NAME;AAD Federated Security=True;Authority Id=AAD_TENANT_OF_CLUSTER;User=USER_DOMAIN
AAD_TENANT_OF_CLUSTER
は、クラスターがホストされているテナントのドメイン名またはMicrosoft Entraテナント ID (GUID) です。 たとえば、「contoso.com
」のように入力します。- USER_DOMAIN は、そのテナントに招待されたユーザーの ID (
user@example.com
など) です。
Note
ユーザーのドメイン名は、クラスターをホストしているテナントの名前と同じである必要はありません。
関連コンテンツ
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示