Leer en inglés

Compartir a través de


Conector de Azure Data Explorer para Microsoft Power Automate

Importante

Este conector se puede usar en Inteligencia en tiempo real en Microsoft Fabric. Use las instrucciones de este artículo con las siguientes excepciones:

El conector de Azure Data Explorer para Power Automate (anteriormente Microsoft Flow) le permite organizar y programar flujos, y enviar notificaciones y alertas, como parte de una tarea programada o desencadenada.

Puede:

  • Enviar notificaciones y alertas en función de los resultados de la consulta, como cuando los umbrales superan determinados límites.
  • Enviar informes con regularidad, diarios o semanales, que contienen tablas y gráficos.
  • Programe trabajos normales mediante comandos de administración en clústeres. Por ejemplo, copie datos de una tabla a otra mediante el comando .set-or-append.
  • Exportar e importar datos entre Azure Data Explorer y otras bases de datos

Para más información, consulte los ejemplos de uso del conector de Azure Data Explorer Power Automate.

Nota

Para que un conectorPower Automate pueda acceder a un clúster protegido por la red, debe agregar las direcciones IP salientes asociadas con la región de su conector a la lista de direcciones permitidas del firewall. Para más información, consulte Administración del acceso público al clúster de Azure Data Explorer.

Creación de un nuevo flujo mediante el conector de Azure Data Explorer

Para usar el conector, primero debe agregar un desencadenador. Se puede definir un desencadenador en función de un período de tiempo periódico o como respuesta a una acción de flujo anterior.

  1. Inicie sesión en Power Automate.

  2. Cree un flujo, o bien, en la página principal de Power Automate, seleccione Mis flujos>+ Nuevo flujo.

    Recorte de pantalla de la página principal Power Automate que se muestran Mis flujos y Nuevo resaltado.

  3. Seleccione Flujo de nube programado.

    Recorte de pantalla del cuadro de diálogo Nuevo, en la que se muestra Programado en blanco resaltado.

  4. En Crear un flujo de nube programado, especifique la información necesaria.

    Recorte de pantalla de la página Generar un flujo programado, en la que se muestran las opciones de nombre de flujo resaltadas.

  5. Seleccione Crear>+ Nuevo paso.

  6. En el cuadro de búsqueda, escriba Kusto o Azure Data Explorer, y seleccione Azure Data Explorer.

    Recorte de pantalla de la ventana Elegir una operación, en la que se muestra el cuadro de búsqueda y Azure Data Explorer resaltado.

  7. Seleccione una acción de la lista. Para obtener una explicación de cada acción y cómo configurarlas, consulte Acciones de flujo.

    Importante

    Debe tener una conexión válida de Azure Data Explorer para que se ejecute el flujo. Para obtener información sobre cómo crear una conexión, consulte Crear una conexión de Azure Data Explorer en Power Automate.

    Recorte de pantalla de la lista Elegir una acción, en la que se muestra la lista de acciones resaltada.

Acciones de flujo

Al seleccionar el conector de Azure Data Explorer, puede elegir una de las siguientes acciones para agregar al flujo:

En esta sección se describen las funcionalidades y los parámetros de cada acción y se proporciona un ejemplo que muestra cómo agregar una acción de correo electrónico a cualquier flujo.

Ejecutar consulta de KQL

Nota

Si la consulta comienza con un punto, es un comando de administración. Use el comando Ejecutar administración asíncrona.

Use esta acción para consultar el clúster especificado. Las acciones que se agregan después iteran por cada línea de los resultados de la consulta.

Si la consulta tarda más de 8 minutos en ejecutarse, se producirá un error con una excepción "RequestTimeout". Para evitar este problema, optimice la consulta o divídala en partes más pequeñas. Para más información, consulte Procedimientos recomendados sobre las consultas.

Ejemplo

El siguiente flujo desencadena una consulta cada minuto. La consulta comprueba el número de registros en la tabla y, a continuación, envía un correo electrónico solo si el número de registros es mayor que 0.

Recorte de pantalla del conector de Azure Data Explorer, en la que se muestra la acción Ejecutar consulta KQL.

Ejecutar consulta de KQL y representar un gráfico

Nota

Si la consulta comienza con un punto, es un comando de administración. Use el comando de administración Ejecutar y representar un gráfico.

Use esta acción para visualizar el resultado de una consulta de KQL como una tabla o un gráfico. Por ejemplo, use este flujo para recibir informes diarios por correo electrónico.

Si la consulta tarda más de 8 minutos en ejecutarse, se producirá un error con una excepción "RequestTimeout". Para evitar este problema, optimice la consulta o divídala en partes más pequeñas. Para más información, consulte Procedimientos recomendados sobre las consultas.

Ejemplo

El siguiente flujo presentará los resultados de la consulta como un gráfico de tiempo.

Recorte de pantalla del conector de Azure Data Explorer, que muestra la acción Ejecutar consulta KQL y representar un gráfico.

Ejecutar el comando de administración asincrónica

Use esta acción para ejecutar un comando de administración de forma asincrónica, lo que significa que seguirá ejecutándose en segundo plano. La acción devuelve un id., un estado y un estado. Para comprobar el estado y los detalles de un comando asincrónico, use el comando .show operations con el id. devuelto por esta acción.

Si el comando de administración asincrónica tarda más de 60 minutos en ejecutarse, se producirá un error con una excepción "RequestTimeout".

Ejemplo

El siguiente flujo desencadena un comando asincrónico para copiar 10 registros de la tabla "TransformedSysLogs" en la "TargetTable". Tenga en cuenta que la palabra clave "async" es necesaria en la consulta.

Recorte de pantalla del conector de Azure Data Explorer que muestra la acción Ejecutar comando de administración asincrónica.

Ejecutar el comando de administración y representar un gráfico

Use esta acción para ejecutar un comando de administración y mostrar el resultado como un gráfico. Las opciones del gráfico incluyen una tabla HTML, un gráfico circular, un gráfico de tiempo y un gráfico de barras.

Si el comando de administración tarda más de 8 minutos en ejecutarse, se producirá un error con una excepción "RequestTimeout".

Recorte de pantalla del comando Ejecutar administración y representar un gráfico en el panel de periodicidad.

Ejecute el comando show management

Esta acción ejecuta el comando show management y devuelve el resultado que se puede usar en los siguientes conectores.

Si el comando de administración tarda más de 8 minutos en ejecutarse, se producirá un error con una excepción "RequestTimeout".

Ejemplo

El siguiente flujo ejecuta el comando operación .show para buscar el estado de un comando asincrónico mediante un id. de operación devuelto por una ejecución de comandos asincrónica.

Recorte de pantalla del conector de Azure Data Explorer en la que se muestra la acción Ejecutar comando de administración.

Resultados de la consulta Kusto por correo electrónico

Puede incluir un paso en cualquier flujo para enviar informes por correo electrónico a cualquier dirección de correo electrónico.

  1. Seleccione + Nuevo paso para agregar un nuevo paso al flujo.
  2. En el cuadro de búsqueda, escriba Office 365 y seleccione Office 365 Outlook.
  3. Seleccione Enviar un correo electrónico (V2).
  4. Escriba la dirección de correo electrónico a la que desea enviar el informe de correo electrónico.
  5. Escriba el asunto del correo electrónico.
  6. Seleccione Vista Código.
  7. Coloque el cursor en el campo Cuerpo y seleccione Agregar contenido dinámico.
  8. Seleccione BodyHtml. Captura de pantalla del cuadro de diálogo Enviar un correo electrónico, con el campo Cuerpo y BodyHtml resaltados.
  9. Seleccione Mostrar opciones avanzadas.
  10. En Nombre de los datos adjuntos -1, seleccione Nombre de datos adjuntos.
  11. En el campo Contenido de los datos adjuntos, seleccione Contenido de los datos adjuntos.
  12. Si es necesario, agregue más datos adjuntos.
  13. Si es necesario, establezca el nivel de importancia.
  14. Seleccione Guardar.

Captura de pantalla del cuadro de diálogo Enviar un correo electrónico, con las opciones Nombre de datos adjuntos, Contenido de datos adjuntos y Guardar resaltadas.

Creación de una conexión de Azure Data Explorer

Para ejecutar un flujo que contenga un conector de Azure Data Explorer, debe usar una conexión válida de Azure Data Explorer. Para crear y autenticar una nueva conexión en el panel izquierdo Power Automate, seleccione Datos>Conexiones, o bien, en el flujo, seleccione el menú >Agregar nueva conexión del conector de Azure Data Explorer.

En los pasos siguientes se muestra cómo crear una conexión desde dentro de un flujo.

  1. En Ejecutar consulta de KQL, seleccione los tres puntos situados en la parte superior derecha del conector de Power Automate.

    Recorte de pantalla de la conexión de Azure Data Explorer, en la que se muestra la opción de autenticación.

  2. Seleccione Agregar nueva conexión. Al conectarse por primera vez, se le pedirá que inicie sesión para autenticar la conexión.

    Recorte de pantalla de la conexión de Azure Data Explorer, que muestra la opción de inicio de sesión.

Autenticación

Puede autenticarse con credenciales de usuario o con una aplicación de Microsoft Entra. Para autenticarse con credenciales, seleccione Iniciar sesión y escriba sus credenciales.

Para autenticarse con una entidad de servicio:

  1. Seleccione Connect with Service Principal (Conectarse a la entidad de servicio).

  2. Rellene el formulario con la siguiente información:

    • Nombre de la conexión: un nombre descriptivo y significativo para la nueva conexión. En este ejemplo, hemos usado el asistente "MyApplication".
    • Identificador de cliente: el identificador de la aplicación.
    • Secreto de cliente: la clave de aplicación.
    • Inquilino: El id del directorio Microsoft Entra en el que creó la aplicación.

    Nota

    Asegúrese de que la aplicación es una aplicación de Microsoft Entra y está autorizada para ejecutar consultas en el clúster.

    Recorte de pantalla de la conexión de Azure Data Explorer, en la que se muestra el cuadro de diálogo autenticación de la aplicación.

    Una vez completada la autenticación, compruebe que el flujo usa la nueva conexión.

    Recorte de pantalla de la autenticación de aplicación completada.

    Una vez establecida la conexión, el flujo se ejecuta con las credenciales de la aplicación.

Prueba del flujo

Para comprobar si el flujo funciona, compruebe el historial de ejecución del flujo:

  1. Vaya a la Power Automate página principal.

  2. En el menú principal, seleccione Mis flujos.

    Recorte de pantalla del menú principal Power Automate, en la que se muestran Mis flujos resaltados.

  3. En la fila del flujo que desea investigar, seleccione el icono Más comandos y, a continuación, Historial de ejecución.

    Recorte de pantalla de la pestaña Mis flujos, con Historial de ejecución resaltado.

    Todas las ejecuciones de flujo se muestran con información sobre la hora de inicio, la duración y el estado. Captura de pantalla de la página de resultados de Historial de ejecución.

    Para obtener detalles completos sobre el flujo, en la página Mis flujos, seleccione el flujo que desea investigar.

    Captura de pantalla de la página de resultados completos de Historial de ejecución.

Para ver por qué se produjo un error en una ejecución, seleccione la hora de inicio de la ejecución. Se muestra el flujo y el paso del flujo en el que se produjo el error se indica mediante un signo de exclamación rojo. Expanda el paso con errores para ver sus detalles. El panel Detalles situado a la derecha contiene información sobre el error para que pueda solucionarlo.

Recorte de pantalla de la ejecución del flujo, en la que se muestra un mensaje de error.

Limitaciones

  • El número máximo de registros por solicitud es de 50 000 y el tamaño máximo de datos por solicitud es de 32 MB. Estos límites no se pueden cambiar.
  • Las solicitudes sincrónicas tienen un tiempo de expiración de 8 minutos.
  • Las solicitudes asincrónicas tienen un tiempo de expiración de 60 minutos.
  • El conector no admite operadores que no sean compatibles con el operador getschema. Por ejemplo, no se admiten los operadores de bifurcación, faceta y evaluación.
  • Los flujos funcionan mejor en Microsoft Edge y Google Chrome.