Kusto.explorer の使用

適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー

Kusto.Explorer は、直感的なインターフェイスで Kusto クエリ言語 (KQL) を使用してデータを探索できるデスクトップ アプリケーションです。 このガイドでは、効率的なデータ分析のために、検索モードとクエリ モードを使用する方法、クエリを共有する方法、クラスター、データベース、テーブルを管理する方法について説明します。

Search++ モード

Search ++ モードは、1 つ以上のテーブルで検索構文を使用して用語を検索することができます。

1. [ ホーム ] タブの [ クエリ ] ドロップダウンで、[ 検索] を選択します。

2. [複数のテーブル] を選択します。

3. [ テーブルの選択] で、検索するテーブルを指定し、[ OK] を選択します。

4. 編集ボックスに検索語句を入力し、[移動] を選択 します。

   テーブルとタイム スロット グリッドのヒート マップには、用語が表示される場所が表示されます。

   

5. グリッド内のセルを選択し、[詳細の 表示 ] を選択して、結果ウィンドウに関連するエントリを表示します。

   

クエリ モード

Kusto.Explorer には、インライン クエリを記述、編集、実行できる強力なクエリ モードが含まれています。 クエリ モードには構文の強調表示と IntelliSense が含まれているため、Kusto クエリ言語に関する知識をすばやく向上させることができます。

このセクションでは、Kusto.Explorer で基本的なクエリを実行し、クエリにパラメーターを追加する方法について説明します。

基本的なクエリ

テーブル ログがある場合は、次のことを試してみることができます。

StormEvents | count 

カーソルがこの行にあると、灰色になります。 F5 キーを押してクエリを実行します。

以下に、他のクエリの例をいくつか紹介します。

// Take 10 lines from the table. This is useful to get familiar with the data.
StormEvents | take 10 

// Filter by EventType == 'Flood' and State == 'California' (where =~ means case insensitive). 
// Take a sample of 10 lines.
StormEvents 
| where EventType == 'Flood' and State =~ 'California'
| take 10

Kusto クエリ言語での Kusto クエリ言語の詳細について説明します。

クライアント側のクエリのパラメーター化

複数のクエリまたはタブで同じ値を使用する場合、使用されるすべての場所でその値を変更するのは不便です。 Kusto.Explorer を使用すると、便利なクエリ パラメーターを使用できます。 クエリ パラメーターはタブ間で共有されるため、簡単に再利用できます。 パラメーターは中かっこ ({}) で示されます。 たとえば、{parameter1} のようにします。

クエリ パラメーターを定義および編集します。

[パラメーター セット] コンボ ボックスに一覧表示されている複数の パラメーター セット を使用できます。 パラメーター セットを管理するには 、[新規追加] または [ 現在の削除] を選択します。

クエリと結果を共有する

Kusto.Explorer で、電子メールでクエリと結果を共有します。 ブラウザーでクエリを開いて実行するためのディープ リンクを作成します。

電子メールでクエリと結果を共有する

Kusto.Explorer で電子メールでクエリとクエリ結果を共有します。

ディープ リンク クエリ

ブラウザーで開いたときに Kusto.Explorer をローカルで開き、指定した Kusto データベースに対して特定のクエリを実行する URI を作成できます。

ディープリンクの作成

ディープ リンクを作成する最も簡単な方法は、Kusto.Explorer でクエリを記述し、 Query and results to Clipboard を使用して、ディープ リンクや結果を含むクエリをクリップボードにコピーすることです。 その後、電子メールで共有できます。

メールにコピーすると、実行するリンクが小さなフォントで表示されます。 次に例を示します。

Web リンクを使用すると、Azure Data Explorer でクエリが開きます。 Desktop リンクはディープリンクです。 Kusto.Explorer でクエリが開き、コンテキストが適切に設定されます。

リンクを電子メール メッセージに移動し、Ctrl キーを押しながら K キーを押すと、実際の URL が表示されます。

ディープ リンクとパラメーター化されたクエリ

ディープリンクでパラメーター化クエリを使用できます。

1. パラメーター化クエリとして形成されるクエリを作成する (たとえば、KustoLogs | where Timestamp > ago({Period}) | count )

制限事項

ブラウザーの制限、HTTP プロキシ、Microsoft Outlook などのリンクを検証するツールにより、クエリは最大 2,000 文字に制限されます。 この制限はクラスターとデータベース名の長さに依存するため、2000 字はおおよその数です。 詳細については、https://support.microsoft.com/kb/208427を参照してください。

文字制限に到達する可能性を減らすには、短いリンクを取得するに関する記事を参照してください。

短いリンクの取得

クエリは長くなる場合があります。 最大長を超える可能性を減らすには、Kusto クライアント ライブラリの String Kusto.Data.Common.CslCommandGenerator.EncodeQueryAsBase64Url(string query) メソッドを使用します。 この方法では、よりコンパクトな形式のクエリが生成されます。 短い形式は、Kusto.Explorer でも認識されます。

次の変換を適用して、クエリをよりコンパクトにします。

 UrlEncode(Base64Encode(gzip(original query)))

Kusto.Explorer のコマンドライン引数

コマンド ライン引数を使用すると、スクリプトの読み込みやクラスターへの接続など、起動時により多くの関数を実行できます。 ただし、コマンド ライン引数では、Kusto.Explorer の機能は置き換えられません。

コマンド ライン引数は、 ディープ リンクのクエリと同様に、アプリケーションを開くために使用される URL の一部です。

コマンドライン引数の構文

Kusto.Explorer では、次の構文を使用した複数のコマンド ライン引数がサポートされています (順序は重要です)。

[LocalScriptFile][QueryString]

コマンド ライン引数

Querystring 引数

例

Kusto.Explorer.exe c:\temp\script.kql "uri=https://help.kusto.windows.net/Samples;Fed=true&name=Samples"

Kusto.Explorer.exe c:\temp\script.kql "uri=https://<baseaddress>/groups/<GroupID>/databases/<DatabaseID>"

データベース、テーブル、または関数に対する権限を有するプリンシパルを管理する

1. 承認されたプリンシパルの一覧を表示するには、[接続] パネルを開き、ターゲット エンティティを右クリックして、[ データベースの承認されたプリンシパルの管理] を選択します。 このオプションは、[管理] メニューから選択することもできます。

   

2. プリンシパルの追加を選択して、承認されたプリンシパルを追加します。

3. プリンシパルの詳細を入力し、[ プリンシパルの追加] を選択します。

   

4. 承認されたプリンシパルの追加を確認します。

   

承認されたプリンシパルを削除するには、[プリンシパルの 削除 ] を選択し、アクションを確認します。

関連するコンテンツ

• Kusto.Explorer のキーボード ショートカット
• Kusto.Explorer のオプション
• Kusto.Explorer のトラブルシューティング
• Kusto.Explorer コード機能
• Kusto クエリ言語 (KQL) の詳細を確認する