次の方法で共有

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 演算子のドキュメントのスクリーンショット。

    Note

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

  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 ツール] オプションのスクリーンショット。

関連するコンテンツ