Azure Data Explorer Web UI でKusto 照会言語クエリを記述する
Azure Data Explorer Web UI クエリ エディターには、Kusto 照会言語 (KQL) クエリの記述に役立つさまざまな機能が用意されています。 これらの機能には、組み込みの KQL Intellisense とオートコンプリート、インライン ドキュメント、クイック修正ポップアップなどがあります。 この記事では、Web UI で KQL クエリを記述するときに知っておくべきことを説明します。
KQL Intellisense とオートコンプリート
クエリ エディターには、関数と演算子のコンテキストに応じた提案を提供する組み込みの KQL Intellisense と、時間と労力を節約するためにクエリを完了するオートコンプリートが用意されています。
KQL Intellisense とオートコンプリートを使用するには:
クエリ エディターでクエリの入力を開始します。
KQL Intellisense がアクティブになり、エンティティ、演算子、関数などのドロップダウン オプションが表示されます。 キーボードの方向キーを使用してこれらのオプション間を移動し、Enter キーを押すか、マウスでオプションを選択して選択します。
下線が引いたキーワードに気付いた場合は、それらのキーワードにカーソルを合わせると、強調表示をトリガーしたエラーや提案が表示されます。
ドキュメントをインラインで表示する
クエリ エディターは、KQL 演算子、関数、および管理コマンドのドキュメントへのインライン アクセスを提供します。
インライン ドキュメントを表示するには:
Intellisense の演算子、関数、またはコマンドにカーソルを合わせます。
右矢印アイコンを選択して、ドキュメントのインライン プレビューを開きます。
Note
プレビューは、他の演算子や関数であっても、閉じるかセッションを終了するまでアクティブなままです。
ブラウザーで完全なドキュメントを開く場合は、[オンラインで表示] を選択します。
クイック修正: クエリ候補または警告
クエリ エディターでは、クエリを記述するときに提案と警告が表示されます。 クイック修正機能を使用すると、これらの提案と警告に基づいてクエリを調整できます。
提案または警告に基づいてクエリを修正するには:
用語にカーソルを合わせると、候補または警告が表示されます。
[クイック修正] を選択すると、使用可能なクイック修正オプションが表示されます。
必要なクイック修正オプションを選択します。
ヒント
表示される提案と警告をカスタマイズするには、「Azure Data Explorer Web UI の設定をカスタマイズする」を参照してください。
クイック修正: 変数に値を抽出する
クイック修正機能を使用して、変数に値を抽出することもできます。
抽出する値を選択します。
電球アイコンを選択するか、Ctrl キーを押しながら . キーを押してクイック修正オプションを開きます。
[値の抽出] を選択 します。
クイック修正: 関数をインラインで定義する
クイック修正機能を使用して、使用する前に既存の関数をインラインで定義することもできます。 インライン関数定義を追加すると、クエリの読みやすさと保守性が向上する場合があります。
関数定義を表示するには:
関数名を書き込んで選択します。
電球アイコンを選択するか、Ctrl キーを押しながら . キーを押してクイック修正オプションを開きます。
関数をインラインで定義するには、インライン (インライン関数) またはインライン再帰 (インライン関数) を選択します。
KQL ツールを使用する
ツール バーの KQL ツールを使用すると、クエリをすばやく複製したり、コマンド パレットを開いたり、ドキュメントにアクセスしたりできます。
KQL ツールを使用するには:
ツール バーで、KQL ツールを選択します。
[クエリの複製]、[コマンド パレットを開く]、または [リソース] の上にマウス ポインターを移動してドキュメント リンクにアクセスするなどのオプションから選択します。 この一覧には、KQL から SQL へのチート シート、キーボード ショートカット、KQL クイック リファレンス ドキュメントなどのリソースが含まれています。