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
プレビューは、他の演算子や関数であっても、閉じるかセッションを終了するまでアクティブなままです。
ブラウザーで完全なドキュメントを開く場合は、 view onlineを選択します。
クイック修正: クエリ候補または警告
クエリ エディターでは、クエリを記述するときに提案と警告が表示されます。 クイック修正機能を使用すると、これらの提案と警告に基づいてクエリを調整できます。
提案または警告に基づいてクエリを修正するには:
用語にカーソルを合わせると、候補または警告が表示されます。
クイック修正を選択して、使用可能なクイック修正オプションを表示します。
必要なクイック修正オプションを選択します。
ヒント
表示される提案と警告をカスタマイズするには、「Azure Data Explorer Web UI で設定 カスタマイズするを参照してください。
クイック修正: 変数に値を抽出する
クイック修正機能を使用して、変数に値を抽出することもできます。
抽出する値を選択します。
電球アイコンを選択するか、 Ctrl + . キーを押してクイック修正オプションを開きます。
Extract 値を選択します。
クイック修正: 関数をインラインで定義する
クイック修正機能を使用して、使用する前に既存の関数をインラインで定義することもできます。 インライン関数定義を追加すると、クエリの読みやすさと保守性が向上する場合があります。
関数定義を表示するには:
関数名を書き込んで選択します。
電球アイコンを選択するか、 Ctrl + . キーを押してクイック修正オプションを開きます。
関数をインラインで定義するには、 Inline (インライン関数) または Inline Recursive (Inline 関数)を選択します。
KQL ツールを使用する
ツール バーの KQL ツール を使用すると、クエリをすばやく複製したり、コマンド パレットを開いたり、ドキュメントにアクセスしたりできます。
KQL ツールを使用するには:
ツール バーで、 KQL ツールを選択します。
Duplicate query、Open コマンド パレットなどのオプションから選択するか、Resources上にマウス ポインターを合わせてドキュメント リンクにアクセスします。 この一覧には、 KQL から SQL へのチート シート、 Keyboard ショートカット、 KQL クイック リファレンス ドキュメントなどのリソースが含まれます。
![Web UI ツール バーの [KQL ツール] オプションのスクリーンショット。](media/web-ui-kql/kql-tools.png#lightbox)