Leer en inglés

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 interfaz de usuario web de Azure Data Explorer ofrece varias características que le ayudarán a escribir consultas Lenguaje de consulta Kusto (KQL). Algunas de estas características incluyen elementos emergentes integrados de KQL IntelliSense y autocompletar, documentación insertada y correcciones rápidas. En este artículo, resaltaremos lo que debe saber al escribir consultas KQL en la interfaz de usuario web.

KQL IntelliSense y autocompletar

El editor de consultas tiene KQL IntelliSense integrado que ofrece sugerencias contextuales para funciones y operadores, y autocompletar 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 activa, presenta opciones desplegables para entidades, operadores, funciones, etc. Mueva entre estas opciones mediante las teclas de dirección del teclado y seleccione una presionando Entrar o seleccionando la opción con 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 la que se muestra cómo funcionan intellisense y autocompletar.

Visualización de la documentación insertada

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

Para ver la documentación insertada:

  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 insertada de la documentación.

    Captura de pantalla de la documentación del operador KQL insertado.

    Nota

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

  3. Si desea abrir la documentación completa en el explorador, seleccione Ver en línea.

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. La característica de corrección rápida se puede usar 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: Extracción del valor en una variable

La característica de corrección rápida también se puede usar 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 insertadas

La característica de corrección rápida también se puede usar para definir una función existente insertada antes de su uso. Agregar una definición de función insertada puede ser útil para mejorar la legibilidad y el mantenimiento 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 insertada, seleccione Inline (Función insertada) o Inline Recursive (Función insertada).

Captura de pantalla de la característica definir corrección rápida de la función.

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, Paleta de comandos Abrir o mantenga el puntero sobre Recursos para acceder a los vínculos de documentación. Esta lista incluye recursos como la hoja de referencia rápida de KQL to SQL, los métodos abreviados 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.