クイック スタート: Azure Data Explorer Web UI でデータのクエリを実行する

Azure Data Explorer は、大量のデータのリアルタイム分析を実現するフル マネージドの高速データ分析サービスです。 Azure Data Explorer の Web エクスペリエンスを使用すると、Azure Data Explorer クラスターに接続して、Kusto クエリ言語のコマンドとクエリを作成、実行、共有できます。 Web エクスペリエンスは、Azure portal で利用でき、スタンドアロン Web アプリケーション (Azure Data Explorer Web UI) としても使用できます。 Azure Data Explorer Web UI は、他の Web ポータルの HTML iframe 内でホストすることもできます。 Azure Data Explorer Web UI および使用される Monaco エディターをホストする方法の詳細については、Monaco IDE の統合に関するページを参照してください。 このクイックスタートでは、スタンドアロンの Azure Data Explorer Web UI を使用します。

Azure Data Explorer Web UI での Kusto Web Explorer エクスペリエンスのチュートリアル。

前提条件

  • Microsoft アカウントまたは Azure Active Directory のユーザー ID。 Azure サブスクリプションは不要です。
  • クラスターとデータベースを作成するか、Azure Data Explorer のヘルプ クラスターを使用します。

アプリケーションにサインインする

アプリケーションにサインインします。

クラスターを追加する

最初にアプリケーションを開いたときには、クラスターには接続していません。

クラスターを追加する場所を示すクエリ エディターのスクリーンショット。

クエリの実行を始める前に、クラスターへの接続を追加する必要があります。 このセクションでは、Azure Data Explorer ヘルプ クラスターと、前提条件で作成したテスト クラスター (省略可能) への接続を追加します。

ヘルプ クラスターを追加する

  1. 左側のメニューで [クエリ] を選択します。

  2. アプリケーションの左上にある [クラスターの追加] を選択します。

  3. [クラスターの追加] ダイアログ ボックスで URI https://help.kusto.windows.net を入力して、 [追加] を選択します。

  4. [クラスター接続] ウィンドウに、help クラスターが表示されます。 Samples データベースを展開し、Tables フォルダーを開いて、アクセスできるサンプル テーブルを表示します。

    Azure Data Explorer Web UI で help クラスターのテーブルを検索する。

このクイック スタートでこの後、および他の Azure Data Explorer 記事では、StormEvents テーブルを使用します。

クラスターを追加する

作成したテスト クラスターを追加します。

  1. [クラスターの追加] を選択します。

  2. [クラスターの追加] ダイアログ ボックスで、テスト クラスターの URL を https://<ClusterName>.<Region>.kusto.windows.net/ の形式で入力して、 [追加] を選択します。 たとえば、次の図のように、https://mydataexplorercluster.westus.kusto.windows.net と指定します。

    Azure Data Explorer Web UI でテスト クラスターの URL を入力する。

  3. 次の例では、help クラスターと、新しいクラスター docscluster.westus (完全な URL は https://docscluster.westus.kusto.windows.net/) が表示されています。

    テスト クラスターの情報を入力する [クラスターの追加] ダイアログ ボックスのスクリーンショット。

クエリを実行する

これで、両方のクラスターでクエリを実行できるようになりました (テスト クラスターにデータがあるものとします)。 この記事では、help クラスターに焦点を当てます。

  1. [クラスター接続] ウィンドウの help クラスターの下の Samples データベースを選択します。

  2. 次のクエリをコピーしてクエリ ウィンドウに貼り付けます。 ウィンドウの上部にある [Run](実行) を選択します。

    StormEvents
    | sort by StartTime desc
    | take 10
    

    このクエリを実行すると、StormEvents テーブルから最新の 10 レコードが返されます。 結果は次のテーブルのようになります。

    Azure Data Explorer Web UI で 10 個の嵐イベントのデータの一覧が表示されているテーブルのスクリーンショット。

    次の図には、クラスターが追加されたアプリケーションの状態、およびクエリと結果が示されています。

    Azure Data Explorer Web UI のクエリ エディター ウィンドウのスクリーンショット。

  3. 次のクエリをコピーし、クエリ ウィンドウの最初のクエリの下に貼り付けます。 最初のクエリのように異なる行に書式設定されていないことに注意してください。

    StormEvents | sort by StartTime desc 
    | project StartTime, EndTime, State, EventType, DamageProperty, EpisodeNarrative | take 10
    
  4. 新しいクエリを選択します。 Shift + Alt + F キーを押して、クエリを次のように書式設定します。

    正しい書式設定のクエリのスクリーンショット。

  5. [実行] を選択するか、Shift + Enter キーを押して、クエリを実行します。 このクエリでは 1 番目と同じレコードが返されますが、project ステートメントで指定されている列のみが含まれます。 結果は次のテーブルのようになります。

    Azure Data Explorer Web UI で 10 個の嵐イベントの開始時刻、終了時刻、州、イベントの種類、被害の特性、体験談のエピソードの一覧が表示されているテーブルのスクリーンショット。

    ヒント

    クエリを再実行する必要なしに、最初のクエリの結果セットを表示するには、クエリ ウィンドウの上部の [Recall](リコール) を選択します。 分析では複数のクエリを実行することがよくあり、 [Recall](リコール) を使用すると前のクエリの結果を取得できます。

  6. もう 1 つクエリを実行し、異なる種類の出力を見てみましょう。

    StormEvents
    | summarize event_count=count(), mid = avg(BeginLat) by State
    | sort by mid
    | where event_count > 1800
    | project State, event_count
    | render columnchart
    

    結果は次のグラフのようになります。

    クエリからの出力としての列グラフのスクリーンショット。

    注意

    クエリ式の空白行は、クエリのどの部分が実行されるかに影響を与える可能性があります。

    • テキストが選択されていない場合は、クエリまたはコマンドが空白行で区切られていると想定されます。
    • テキストが選択されている場合は、選択したテキストが実行されます。

結果グリッドの操作

基本的なクエリの動作を確認したので、次に結果グリッドを使用して結果をカスタマイズし、さらに分析を行うことができます。

セルを展開する

長い文字列や JSON などの動的フィールドを表示する場合に、セルを展開すると便利です。

  1. セルをダブルクリックすると、展開されたビューが開きます。 このビューでは、長い文字列を読み取ることができ、動的データの JSON 形式が提供されます。

    長い文字列を表示するために Azure Data Explorer WebUI でセルを展開するスクリーンショット。

  2. 読み取りペインのモードを切り替えるには、結果グリッドの右上にあるアイコンを選択します。 展開ビューの読み取りペインのモードは、[インライン]、[下] ペイン、および [右] ペインから選択します。

    Azure Data Explorer Web UI のクエリ結果で、読み取りペインを展開ビュー モードに変更するアイコンを示すスクリーンショット。

Expand a row

数十の列を含むテーブルを操作する場合は、行全体を展開して、さまざまな列とその内容の概要を簡単に確認できるようにします。

  1. 展開する行の左側の矢印 > をクリックします。

    Azure Data Explorer Web UI での展開された行のスクリーンショット。

  2. 展開された行では、一部の列は展開され (下向きの矢印)、一部の列は折りたたまれています (右向きの矢印)。 これらの矢印をクリックすると、これらの 2 つのモードが切り替わります。

結果ごとに列をグループ化する

結果内において、任意の列で結果をグループ化できます。

  1. 次のクエリを実行します。

    StormEvents
    | sort by StartTime desc
    | take 10
    
  2. State 列をマウスでポイントし、メニューを選択して、 [Group by State](State でグループ化) を選択します。

    州にグループ化されたクエリ結果のテーブルのスクリーンショット。

  3. グリッドで California をダブルクリックして展開し、その州のレコードを表示します。 この種類のグループ化は、探索的分析を行うときに役に立ちます。

    Azure Data Explorer Web UI で、California グループが展開されたクエリ結果グリッドのスクリーンショット。

  4. [Group](グループ) 列をマウスでポイントし、 [Reset columns](列のリセット) を選択します。 この設定により、グリッドは元の状態に戻ります。

    列ドロップダウン メニューで列のリセット設定が強調表示されているスクリーンショット。

値の集計を使用する

列でグループ化した後、値の集計関数を使用して、グループごとの単純な統計を計算できます。

  1. 評価する列のメニューを選択します。

  2. [Value Aggregation](値の集計) を選択し、この列に対して実行する関数の種類を選択します。

    Azure Data Explorer Web UI で結果ごとに列をグループ化したときの集計結果のスクリーンショット。

空の列を非表示にする

結果グリッドメニューの [目] アイコンを切り替えると、空の列を表示または非表示にすることができます。

Azure Data Explorer Web UI で結果グリッドを非表示にする目のアイコンのスクリーンショット。

列をフィルター処理する

1 つまたは複数の演算子を使用して、列の結果をフィルター処理できます。

  1. 特定の列をフィルター処理するには、その列のメニューを選択します。

  2. フィルター アイコンを選択します。

  3. フィルター ビルダーで、目的の演算子を選択します。

  4. 列をフィルターする式を入力します。 入力するにつれて結果がフィルター処理されます。

    注意

    フィルターでは大文字と小文字は区別されません。

  5. 複数条件フィルターを作成するには、ブール演算子を選択して別の条件を追加します

  6. フィルターを削除するには、最初のフィルター条件からテキストを削除します。

    Azure Data Explorer Web UI で列に対してフィルター処理を行う方法を示す GIF。

セルの統計を実行する

  1. 次のクエリを実行します。

    StormEvents
    | sort by StartTime desc
    | where DamageProperty > 5000
    | project StartTime, State, EventType, DamageProperty, Source
    | take 10
    
  2. 結果グリッドで、いくつかの数値セルを選択します。 テーブル グリッドを使用して、複数の行、列、セルを選択し、それらの集計を計算することができます。 現在、Azure Data Explorer Web UI でサポートされている数値関数は次のとおりです: AverageCountMinMaxSum

    関数が選択されたテーブルのスクリーンショット。

グリッドからのクエリへのフィルター処理

グリッドをフィルター処理するもう 1 つの簡単な方法は、グリッドから直接、クエリにフィルター演算子を追加することです。

  1. クエリ フィルターを作成する対象の内容が含まれているセルを選択します。

  2. 右クリックしてセル アクション メニューを開きます。 [Add selection as filter](選択内容をフィルターとして追加) を選択します。

    グリッドからクエリを直接実行するための [Add selection as filter] (選択内容をフィルターとして追加) オプションを示すドロップダウン メニューのスクリーンショット。

  3. クエリ エディターでクエリにクエリ句が追加されます。

    Azure Data Explorer Web UI でグリッド上のフィルターから追加されたクエリ句を示すクエリ エディターのスクリーンショット。

ピボット

ピボット モード機能は Excel のピボット テーブルに似ており、グリッド自体で高度な分析を行うことができます。

ピボットを使用すると、列の値を取得して、列に変換することができます。 たとえば、State でピボットして、フロリダ、ミズーリ、アラバマなどの列を作成できます。

  1. グリッドの右側にある [列] を選択して、テーブル ツール パネルを表示します。

    ピボット モード機能にアクセスする方法を示すスクリーンショット。

  2. [Pivot Mode](ピボット モード) を選択し、EventType 列を [Row groups](行グループ) に、DamageProperty 列を [Values](値) に、State 列を [Column labels](列ラベル) に、それぞれドラッグします。

    ピボット テーブルを作成するために選択された列名を強調表示したスクリーンショット。

    結果は次のピボット テーブルのようになります。

    ピボット テーブルの結果のスクリーンショット。

結果グリッドで検索する

結果テーブル内で特定の式を検索できます。

  1. 次のクエリを実行します。

    StormEvents
    | where DamageProperty > 5000
    | take 1000
    
  2. 右側の [検索] ボタンをクリックし、「Wabash」と入力します

    テーブルの検索バーが強調表示されたスクリーンショット。

  3. 検索した式のすべてのメンションが、テーブルで強調表示されます。 これらの間を移動するには、Enter キーを押すと前方に移動し、Shift + Enter キーを押すと後方に移動します。検索ボックスの横にある "上向き" と "下向き" のボタンを使用することもできます。

    検索結果からの強調表示された式を含むテーブルのスクリーンショット。

クエリを共有する

作成したクエリを共有したいことがよくあります。

  1. クエリ ウィンドウで、最初にコピーしたクエリを選択します。

  2. クエリ ウィンドウの上部にある [Share](共有) を選択します。

    共有ドロップダウン メニューを示すクエリ エディターのスクリーンショット。

ドロップダウンでは、次のオプションを使用できます。

ディープ リンクを提供して、クラスターにアクセスできる他のユーザーがクエリを実行できるようにすることができます。

  1. [共有] で、 [Link, query to clipboard](リンク、クエリをクリップボードに) を選択します。

  2. リンクとクエリをテキスト ファイルにコピーします。

  3. リンクを新しいブラウザー ウィンドウに貼り付けます。 結果は次のようになります

    共有クエリのディープ リンクのスクリーンショット。

[ダッシュボードにピン留めする]

Azure Data Explorer Web UI でクエリを使用してデータ探索を完了し、必要なデータを見つけたら、それをダッシュボードにピン留めして継続的な監視を行うことができます。

クエリをピン留めするには:

  1. [共有] で、 [ダッシュボードにピン留めする] を選択します。

  2. [ダッシュボードにピン留めする] ペインで、次のようにします。

    1. [クエリ名] を入力します。
    2. [既存のものを使用] または [新規作成] を選択します。
    3. [ダッシュボード名] を入力します。
    4. [View dashboard after creation](作成後にダッシュボードを表示する) チェックボックスをオンにします (新しいダッシュボードの場合)。
    5. [ピン留め] の選択

    [ダッシュボードにピン留めする] ウィンドウのスクリーンショット。

注意

[ダッシュボードにピン留めする] では、選択したクエリのみがピン留めされます。 ダッシュボードのデータ ソースを作成し、レンダリング コマンドをダッシュボードでビジュアルに変換するには、データベースの一覧で、関連するデータベースを選択する必要があります。

クエリ結果をエクスポートする

クエリ結果を CSV ファイルにエクスポートするには、 [ファイル]>[CSV にエクスポート] を選択します。

結果を CSV にエクスポートするオプションを示すために強調表示されたファイル ドロップダウン メニューとクエリ エディターのスクリーンショット。

設定

[設定] タブでは、次のことができます。

右上にある設定アイコン を選択して、 [設定] ウィンドウを開きます。

[設定] ウィンドウのスクリーンショット。

環境の設定をエクスポートおよびインポートする

エクスポートとインポートの操作は、作業環境を保護し、他のブラウザーやデバイスに再配置するのに役立ちます。 エクスポート操作を使用すると、すべての設定、クラスター接続、およびクエリ タブが、別のブラウザーまたはデバイスにインポートできる JSON ファイルにエクスポートされます。

環境の設定をエクスポートする

  1. [設定]>[全般] ウィンドウで、 [エクスポート] を選択します。
  2. adx-export.json ファイルがローカル ストレージにダウンロードされます。
  3. 環境を元の状態に戻すには、 [Clear local state](ローカル状態のクリア) を選択します。 これを設定すると、すべてのクラスター接続が削除され、開いているタブが閉じられます。

注意

[エクスポート] を使用すると、クエリ関連のデータのみがエクスポートされます。 adx-export.json ファイルには、ダッシュボードのデータはエクスポートされません。

環境の設定をインポートする

  1. [設定]>[全般] ウィンドウで、 [インポート] を選択します。 その後、 [警告] ポップアップで、 [インポート] を選択します。

    インポートの警告ダイアログ ボックスのスクリーンショット。

  2. ローカル ストレージから adx-export.json ファイルを見つけて開きます。

  3. 以前のクラスター接続と開いていたタブが使用できるようになります。

注意

[インポート] を使用すると、既存の環境設定とデータが上書きされます。

エラーのレベルで強調表示する

Kusto では、結果パネルの各行の重大度または詳細レベルを解釈し、それに応じて色の設定を試みます。 これは、各列の個別の値を一連の既知のパターン ("警告"、"エラー" など) と照合することによって行われます。

エラーのレベルでの強調表示を有効にする

エラーのレベルでの強調表示を有効にするには、以下を行います。

  1. ユーザー名の隣にある [設定] アイコンを選択します。

  2. [表示] タブを選択し、 [エラーのレベルでの強調表示を有効にする] オプションを右に切り替えます。

    設定でエラーのレベルでの強調表示を有効にする方法を示しているアニメーション GIF。

ライト モードでのエラー レベルの配色 ダーク モードでのエラー レベルの配色
ライト モードでの色の凡例のスクリーンショット。 ダーク モードでの色の凡例のスクリーンショット。

強調表示のため列の要件

強調表示のエラーのレベルの場合、列の型は int、long、または string である必要があります。

  • 列の型が long または int の場合は、次のようになります。
    • 列名は Level である必要があります。
    • 値には 1 から 5 までの数字のみを含めることができます。
  • 列の型が string の場合は、次のようになります。
    • パフォーマンスを向上させるために、必要に応じて列名を Level にすることができます。
    • 列には、次の値のみを含めることができます。
      • critical、crit、fatal、assert、high
      • error、e
      • warning、w、monitor
      • 情報
      • verbose、verb、d

Datetime を特定のタイム ゾーンに変更する

表示される datetime 値を変更して、特定のタイム ゾーンを反映することができます。 この変更は、表示のみに影響し、Azure Data Explorer の基になるデータは変更されません。

  1. ユーザー名の隣にある [設定] アイコンを選択します。

  2. [全般] タブを選択し、ドロップダウン メニューからタイム ゾーンを選択します。

    Azure Data Explorer Web UI でタイム ゾーンを変更するための [設定] ブレードの [全般] タブのスクリーンショット。

選択したタイム ゾーンが結果グリッドのメニュー バーに表示されます。

結果グリッド メニューで UTC に変更されたクエリ時間のスクリーンショット。

フィードバックの提供

  1. アプリケーションの右上にあるフィードバック アイコン を選択します。

  2. フィードバックを入力し、 [Submit](送信) を選択してください。

リソースをクリーンアップする

このクイック スタートではリソースは何も作成しませんでしたが、アプリケーションから一方または両方のクラスターを削除したい場合は、クラスターを右クリックして、 [Remove connection](接続を削除) を選択します。 もう 1 つのオプションとしては、 [設定]>[全般] タブから、 [Clear local state](ローカル状態のクリア) を選択します。この操作を行うと、すべてのクラスター接続が削除され、開いているすべてのクエリ タブが閉じられます。

次のステップ

Azure Data Explorer のクエリを記述する