Kusto.Explorer の使用

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

Kusto.Explorer は、使いやすいユーザー インターフェイスで Kusto 照会言語を使用してデータを探索できる、デスクトップ アプリケーションです。 この記事では、検索とクエリのモードを使用する方法、クエリを共有する方法、およびクラスター、データベース、およびテーブルを管理する方法について説明します。

Search++ モード

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

1. Query Home タブのドロップダウンで、Search++ を選択します。

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

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

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

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

   

5. グリッド内のセルを選択し、[詳細の表示] を選択すると、結果ペインに関連するエントリが表示されます。

   

クエリ モード

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

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

基本的なクエリ

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

StormEvents | count 

カーソルがこの行にある場合は、灰色で色付けされます。 F5 キーを押して、クエリを実行します。

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

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

// Filter by EventType == 'Flood' and State == 'California' (=~ means case insensitive) 
// and take 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. 承認されたプリンシパルの一覧を表示するには、Connections パネルでターゲット エンティティを右クリックし[データベースの承認されたプリンシパルの管理]を選択します。 (管理メニューからこのオプションを選択することもできます)

   

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

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

   

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

   

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

関連するコンテンツ

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