Share via

Azure Data Explorer Web UI でKusto 照会言語クエリを記述する

  • [アーティクル]

Azure Data Explorer Web UI クエリ エディターには、Kusto 照会言語 (KQL) クエリの記述に役立つさまざまな機能が用意されています。 これらの機能には、組み込みの KQL Intellisense とオートコンプリート、インライン ドキュメント、クイック修正ポップアップなどがあります。 この記事では、Web UI で KQL クエリを記述するときに知っておくべきことを取り上げます。

KQL Intellisense とオートコンプリート

クエリ エディターには、関数と演算子のコンテキストに応じた提案を提供する KQL Intellisense が組み込まれており、時間と労力を節約するためにクエリを完了するオートコンプリートが用意されています。

KQL Intellisense とオートコンプリートを使用するには:

  1. クエリ エディターでクエリの入力を開始します。

  2. KQL Intellisense がアクティブになり、エンティティ、演算子、関数などのドロップダウン オプションが表示されます。 キーボードの方向キーを使用してこれらのオプション間を移動し、 Enter キーを押すか、マウスでオプションを選択して選択します。

  3. 下線が引かれたキーワードに気付いた場合は、それらのキーワードにカーソルを合わせると、強調表示をトリガーしたエラーや提案が表示されます。

IntelliSense とオートコンプリートの動作を示すスクリーンショットの移動。

ドキュメントをインラインで表示する

クエリ エディターは、KQL 演算子、関数、および管理コマンドのドキュメントへのインライン アクセスを提供します。

インライン ドキュメントを表示するには:

  1. Intellisense の演算子、関数、またはコマンドにカーソルを合わせます。

  2. 右矢印アイコンを選択して、ドキュメントのインライン プレビューを開きます。

    インライン KQL 演算子のドキュメントのスクリーンショット。

    注意

    プレビューは、他の演算子や関数であっても、閉じるかセッションを終了するまでアクティブなままになります。

  3. ブラウザーで完全なドキュメントを開く場合は、[ オンラインで表示] を選択します。

クイック修正: クエリの提案または警告

クエリ エディターでは、クエリを記述するときに提案と警告が表示されます。 クイック修正機能を使用すると、これらの提案と警告に基づいてクエリを調整できます。

提案または警告に基づいてクエリを修正するには:

  1. 用語の上にマウス ポインターを合わせると、候補または警告が表示されます。

  2. [ クイック修正 ] を選択して、使用可能なクイック修正オプションを表示します。

  3. 目的のクイック修正オプションを選択します。

パフォーマンスの提案に基づくクイック修正のスクリーンショット。

ヒント

表示される提案と警告をカスタマイズするには、「Azure Data Explorer Web UI で設定をカスタマイズする」を参照してください。

クイック修正: 変数に値を抽出する

クイック修正機能を使用して、変数に値を抽出することもできます。

  1. 抽出する値を選択します。

  2. 電球アイコンを選択するか、 Ctrl + を 押してクイック修正オプションを開きます。

  3. [ 値の抽出] を選択します。

変数に値を抽出するためのクイック修正のスクリーンショット。

クイック修正: 関数をインラインで定義する

クイック修正機能を使用して、使用する前に既存の関数をインラインで定義することもできます。 インライン関数定義を追加すると、クエリの読みやすさと保守性を向上させるのに役立つ場合があります。

関数定義を表示するには:

  1. 関数名を書き込んで選択します。

  2. 電球アイコンを選択するか、 Ctrl + を 押してクイック修正オプションを開きます。

  3. 関数をインラインで定義するには、[ インライン (インライン関数)] または [ インライン再帰 (インライン関数)] を選択します。

関数クイック修正の定義機能のスクリーンショットを移動しました。

KQL ツールを使用する

ツール バーの KQL ツール を使用すると、クエリをすばやく複製したり、コマンド パレットを開いたり、ドキュメントにアクセスしたりできます。

KQL ツールを使用するには:

  1. ツール バーの [ KQL ツール] を選択します。

  2. [クエリの複製]、[コマンド パレットを開く]、または [リソース] の上にマウス ポインターを置いてドキュメント リンクにアクセスするなどのオプションから選択します。 この一覧には、 KQL から SQL へのチート シート、 キーボード ショートカット、 KQL クイック リファレンス ドキュメントなどのリソースが含まれています。

Web UI ツール バーの [KQL ツール] オプションのスクリーンショット。

関連コンテンツ