Compartir a través de


Escritura de consultas del lenguaje de consulta Kusto en la interfaz de usuario web de Azure Data Explorer

El editor de consultas de la interfaz web de usuario de Azure Data Explorer ofrece varias características que le ayudarán a escribir consultas del Lenguaje de consultas Kusto (KQL). Algunas de estas características incluyen IntelliSense de KQL integrado y autocompletar, documentación en línea y ventanas emergentes de corrección rápida. En este artículo, aprenderá lo que debe saber al escribir consultas KQL en la interfaz de usuario web.

KQL IntelliSense y autocompletar

El editor de consultas tiene integrado IntelliSense de KQL, que ofrece sugerencias contextuales para funciones y operadores, además de la función de autocompletado que completa las consultas para ahorrar tiempo y esfuerzo.

Para usar KQL IntelliSense y autocompletar:

  1. Comience a escribir una consulta en el editor de consultas.

  2. KQL IntelliSense se activa, presentando opciones desplegables para entidades, operadores, funciones, entre otros. Mueva entre estas opciones mediante las teclas de dirección del teclado y seleccione una presionando Entrar o seleccione la opción mediante el mouse.

  3. Si observa palabras clave subrayadas, mantenga el puntero sobre ellas para mostrar errores o sugerencias que desencadenaron el resaltado.

Captura de pantalla en movimiento mostrando cómo funcionan IntelliSense y autocompletar.

Ver documentación en línea

El editor de consultas proporciona acceso en línea a la documentación de los operadores, funciones y comandos de administración de KQL.

Para ver la documentación en línea:

  1. Mantenga el puntero sobre el operador, la función o el comando en IntelliSense.

  2. Seleccione el icono de flecha derecha para abrir una vista previa integrada de la documentación.

    Captura de pantalla de la documentación del operador KQL en línea.

    Nota:

    La versión preliminar permanece activa hasta que se cierra o finaliza la sesión, incluso para otros operadores y funciones.

  3. Seleccione Ver en línea para abrir la documentación completa en el explorador.

Corrección rápida: Sugerencia de consulta o advertencia

En el editor de consultas se proporcionan sugerencias y advertencias a medida que escribe las consultas. Use la característica de corrección rápida para ajustar la consulta en función de estas sugerencias y advertencias.

Para corregir una consulta basada en una sugerencia o advertencia:

  1. Mantenga el puntero sobre el término para ver la sugerencia o la advertencia.

  2. Seleccione Corrección rápida para mostrar las opciones de corrección rápida disponibles.

  3. Seleccione la opción de corrección rápida deseada.

Captura de pantalla de la corrección rápida basada en la sugerencia de rendimiento.

Sugerencia

Para personalizar las sugerencias y advertencias que recibe, consulte Personalización de la configuración en la interfaz de usuario web de Azure Data Explorer.

Corrección rápida: Extraer valor en una variable

También puede usar la característica de corrección rápida para extraer un valor en una variable:

  1. Seleccione el valor que se va a extraer.

  2. Seleccione el icono de bombilla o presione Ctrl + . para abrir las opciones de corrección rápida.

  3. Seleccione Extraer valor.

Captura de pantalla de la corrección rápida para extraer el valor en la variable.

Corrección rápida: Definir funciones in situ

También puede usar la función de corrección rápida para definir una función existente en línea antes de su uso. Agregar una definición de función en línea puede mejorar la legibilidad y la mantenibilidad de las consultas.

Para mostrar una definición de función:

  1. Escriba y seleccione el nombre de la función.

  2. Seleccione el icono de bombilla o presione Ctrl + . para abrir las opciones de corrección rápida.

  3. Para definir la función inline, seleccione Inline (Función insertada) o Inline Recursive (Función recursiva insertada).

Captura de pantalla móvil de la funcionalidad de corrección rápida de la función 'definir'.

Uso de herramientas de KQL

Las herramientas de KQL de la barra de herramientas le ayudan a duplicar rápidamente una consulta, abrir la paleta de comandos o acceder a la documentación.

Para usar herramientas de KQL:

  1. En la barra de herramientas, seleccione Herramientas de KQL.

  2. Elija entre opciones como Consulta duplicada, Abrir paleta de comandos, o mantenga el puntero sobre Recursos para acceder a los vínculos de documentación. Esta lista incluye recursos como la hoja de trucos de KQL to SQL, los atajos de teclado y la documentación de referencia rápida de KQL.

Captura de pantalla de la opción herramientas de KQL en la barra de herramientas de la interfaz de usuario web.