Condividi tramite


Connettore azure Esplora dati per MicrosoftPower Automate

Importante

Questo connettore può essere usato in Intelligenza in tempo reale in Microsoft Fabric. Usare le istruzioni in questo articolo con le eccezioni seguenti:

  • Se necessario, creare database usando le istruzioni riportate in Creare un database KQL.
  • Se necessario, creare tabelle usando le istruzioni riportate in Creare una tabella vuota.
  • Ottenere URI di query o inserimento usando le istruzioni in URI di copia.
  • Eseguire query in un set di query KQL.

Il connettore azure Esplora dati per Power Automate (in precedenza Microsoft Flow) consente di orchestrare e pianificare flussi, inviare notifiche e avvisi come parte di un'attività pianificata o attivata.

È possibile:

  • Inviare notifiche e avvisi in base ai risultati della query, ad esempio quando le soglie superano determinati limiti.
  • Inviare report regolari, ad esempio giornalieri o settimanali, contenenti tabelle e grafici.
  • Pianificare processi regolari usando i comandi di gestione nei cluster. Ad esempio, copiare dati da una tabella a un'altra usando il .set-or-append comando .
  • Esportare e importare dati tra azure Esplora dati e altri database.

Per altre informazioni, vedere Esempi di utilizzo del connettore Esplora dati Power Automate di Azure.

Nota

Per consentire a un Power Automate connettore di accedere a un cluster protetto da rete, è necessario aggiungere gli indirizzi IP in uscita associati all'area del connettore all'elenco degli elementi consentiti del firewall. Per altre informazioni, vedere Gestire l'accesso pubblico al cluster di Azure Esplora dati.

Creare un nuovo flusso usando il connettore azure Esplora dati

Per usare il connettore, è prima necessario aggiungere un trigger. È possibile definire un trigger in base a un periodo di tempo ricorrente o come risposta a un'azione del flusso precedente.

  1. Accedere a Power Automate.

  2. Creare un nuovo flusso o, nella Power Automate home page, selezionare il flusso Flussi personali>+ Nuovo.

    Screenshot della Power Automate home page, che mostra Flussi personali e Nuovo evidenziato.

  3. Selezionare Flusso cloud pianificato.

    Screenshot della finestra di dialogo Nuovo, che mostra l'opzione Scheduled from blank evidenziata.

  4. In Compilare un flusso cloud pianificato immettere le informazioni necessarie.

    Screenshot della pagina Compila un flusso pianificato, che mostra le opzioni del nome del flusso evidenziate.

  5. Selezionare Crea>+ Nuovo passaggio.

  6. Nella casella di ricerca immettere Kusto o Azure Esplora dati e selezionare Azure Esplora dati.

    Screenshot della finestra Scegliere un'operazione, che mostra la casella di ricerca e Azure Esplora dati evidenziata.

  7. Selezionare un'azione dall'elenco. Per una spiegazione di ogni azione e su come configurarle, vedere Azioni del flusso.

    Importante

    È necessario disporre di una connessione Esplora dati di Azure valida per l'esecuzione del flusso. Per informazioni sulla creazione di una connessione, vedere Creare una connessione Esplora dati di Azure in Power Automate.

    Screenshot dell'elenco Scegli un'azione, che mostra l'elenco delle azioni evidenziate.

Azioni di flusso

Quando si seleziona il connettore azure Esplora dati, è possibile scegliere una delle azioni seguenti da aggiungere al flusso:

Questa sezione descrive le funzionalità e i parametri per ogni azione e fornisce un esempio che illustra come aggiungere un'azione di posta elettronica a qualsiasi flusso.

Eseguire una query KQL

Nota

Se la query inizia con un punto, si tratta di un comando di gestione. Usare il comando Esegui gestione asincrona.

Usare questa azione per eseguire query sul cluster specificato. Le azioni aggiunte successivamente eseguono l'iterazione su ogni riga dei risultati della query.

Se l'esecuzione della query richiede più di 8 minuti, l'esecuzione avrà esito negativo con un'eccezione "RequestTimeout". Per evitare questo problema, ottimizzare la query o dividerla in parti più piccole. Per altre informazioni, vedere Procedure consigliate per le query.

Esempio

Il flusso seguente attiva una query ogni minuto. La query controlla il numero di record nella tabella e quindi invia un messaggio di posta elettronica solo se il numero di record è maggiore di 0.

Screenshot del connettore azure Esplora dati che mostra l'azione Esegui query KQL.

Eseguire una query KQL ed eseguire il rendering di un grafico

Nota

Se la query inizia con un punto, si tratta di un comando di gestione. Usare il comando Esegui gestione ed eseguire il rendering di un grafico.

Usare questa azione per visualizzare un risultato della query KQL come tabella o grafico. Ad esempio, usare questo flusso per ricevere report giornalieri tramite posta elettronica.

Se l'esecuzione della query richiede più di 8 minuti, l'esecuzione avrà esito negativo con un'eccezione "RequestTimeout". Per evitare questo problema, ottimizzare la query o dividerla in parti più piccole. Per altre informazioni, vedere Procedure consigliate per le query.

Esempio

Il flusso seguente presenterà i risultati della query come grafico temporale.

Screenshot del connettore azure Esplora dati, che mostra l'azione Esegui query KQL ed esegue il rendering di un grafico.

Eseguire il comando di gestione asincrona

Usare questa azione per eseguire un comando di gestione in modo asincrono, il che significa che continuerà a essere eseguito in background. L'azione restituisce un ID, uno stato e uno stato. Per controllare lo stato e i dettagli di un comando asincrono, usare il comando .show operations con l'ID restituito da questa azione.

Se l'esecuzione del comando di gestione asincrona richiede più di 60 minuti, l'esecuzione avrà esito negativo con un'eccezione "RequestTimeout".

Esempio

Il flusso seguente attiva un comando asincrono per copiare 10 record dalla tabella 'TransformedSysLogs' alla 'TargetTable'. Si noti che la parola chiave "async" è necessaria nella query.

Screenshot del connettore azure Esplora dati che mostra l'azione Esegui comando di gestione asincrona.

Eseguire il comando di gestione ed eseguire il rendering di un grafico

Usare questa azione per eseguire un comando di gestione e visualizzare il risultato come grafico. Le opzioni del grafico includono una tabella HTML, un grafico a torta, un grafico temporale e un grafico a barre.

Se l'esecuzione del comando di gestione richiede più di 8 minuti, l'esecuzione avrà esito negativo con un'eccezione "RequestTimeout".

Screenshot del comando Esegui gestione ed esegue il rendering di un grafico nel riquadro ricorrenza.

Eseguire il comando di gestione show

Questa azione esegue il comando show management e restituisce il risultato che può essere usato nei connettori seguenti.

Se l'esecuzione del comando di gestione richiede più di 8 minuti, l'esecuzione avrà esito negativo con un'eccezione "RequestTimeout".

Esempio

Il flusso seguente esegue il comando .show operation per trovare lo stato di un comando asincrono usando un ID operazione restituito da un'esecuzione asincrona del comando.

Screenshot del connettore azure Esplora dati che mostra l'azione Esegui comando di gestione show.

Inviare un messaggio di posta elettronica ai risultati della query Kusto

È possibile includere un passaggio in qualsiasi flusso per inviare report tramite posta elettronica a qualsiasi indirizzo di posta elettronica.

  1. Selezionare + Nuovo passaggio per aggiungere un nuovo passaggio al flusso.
  2. Nella casella di ricerca immettere Office 365 e selezionare Office 365 Outlook.
  3. Selezionare Invia un messaggio di posta elettronica (V2).
  4. Immettere l'indirizzo di posta elettronica a cui si desidera inviare il report di posta elettronica.
  5. Immettere l'oggetto del messaggio di posta elettronica.
  6. Selezionare Visualizzazione codice.
  7. Posizionare il cursore nel campo Corpo e selezionare Aggiungi contenuto dinamico.
  8. Selezionare BodyHtml. Screenshot della finestra di dialogo Invia un messaggio di posta elettronica con il campo Corpo e BodyHtml evidenziato.
  9. Selezionare Mostra opzioni avanzate.
  10. In Nome allegati -1 selezionare Nome allegato.
  11. In Contenuto allegati selezionare Contenuto allegato.
  12. Se necessario, aggiungere altri allegati.
  13. Se necessario, impostare il livello di importanza.
  14. Seleziona Salva.

Screenshot della finestra di dialogo Invia un messaggio di posta elettronica con nome allegati, contenuto allegati e salva evidenziati.

Creare una connessione Esplora dati di Azure

Per eseguire un flusso che contiene un connettore di Azure Esplora dati, è necessario usare una connessione di Azure Esplora dati valida. È possibile creare ed autenticare una nuova connessione dal Power Automate riquadro sinistro, selezionare Connessioni dati>o dall'interno del flusso selezionando il menu >del connettore di azure Esplora dati Aggiungi nuova connessione.

I passaggi seguenti illustrano come creare una connessione dall'interno di un flusso.

  1. In Esegui query KQL selezionare i tre puntini in alto a destra del connettore power automate.

    Screenshot della connessione Esplora dati di Azure, che mostra l'opzione di autenticazione.

  2. Selezionare Aggiungi nuova connessione. Quando ci si connette per la prima volta, viene richiesto di accedere per autenticare la connessione.

    Screenshot della connessione Esplora dati di Azure, che mostra l'opzione di accesso.

Autenticazione

È possibile eseguire l'autenticazione con le credenziali utente o con un'applicazione Microsoft Entra. Per eseguire l'autenticazione con le credenziali, selezionare Accedi e immettere le credenziali.

Per eseguire l'autenticazione con un'entità servizio:

  1. Selezionare Connetti con l'entità servizio.

  2. Compilare il modulo con le informazioni seguenti:

    • Nome connessione: nome descrittivo e significativo per la nuova connessione. In questo esempio è stato usato "MyApplication".
    • ID client: ID applicazione.
    • Segreto client: chiave dell'applicazione.
    • Tenant: ID della directory Microsoft Entra in cui è stata creata l'applicazione.

    Nota

    Assicurarsi che l'applicazione sia un'applicazione Microsoft Entra e che sia autorizzata a eseguire query nel cluster.

    Screenshot della connessione Esplora dati di Azure che mostra la finestra di dialogo di autenticazione dell'applicazione.

    Al termine dell'autenticazione, verificare che il flusso usi la nuova connessione.

    Screenshot dell'autenticazione dell'applicazione completata.

    Dopo aver impostato la connessione, il flusso viene eseguito usando le credenziali dell'applicazione.

Testare il flusso

Per verificare se il flusso funziona, controllare la cronologia di esecuzione del flusso:

  1. Passare alla Power Automate home page.

  2. Dal menu principale selezionare Flussi personali.

    Screenshot del Power Automate menu principale, che mostra i flussi personali evidenziati.

  3. Nella riga del flusso da analizzare selezionare l'icona altri comandi e quindi selezionare Cronologia di esecuzione.

    Screenshot della scheda Flussi personali, che mostra la cronologia di esecuzione evidenziata.

    Tutte le esecuzioni del flusso sono elencate, con informazioni sull'ora di inizio, la durata e lo stato. Screenshot della pagina Dei risultati della cronologia di esecuzione.

    Per informazioni dettagliate sul flusso, in Flussi personali selezionare il flusso da analizzare.

    Screenshot della pagina Dei risultati completi della cronologia di esecuzione.

Per verificare il motivo per cui un'esecuzione non è riuscita, selezionare l'ora di inizio dell'esecuzione. Viene visualizzato il flusso e il passaggio del flusso non riuscito è indicato da un punto esclamativo rosso. Espandere il passaggio non riuscito per visualizzarne i dettagli. Il riquadro Dettagli a destra contiene informazioni sull'errore in modo da poterlo risolvere.

Screenshot dell'esecuzione del flusso, che mostra un messaggio di errore.

Limiti

  • Il numero massimo di record per richiesta è 50.000 e la dimensione massima dei dati per richiesta è 32 MB. Questi limiti non possono essere modificati.
  • Le richieste sincrone hanno un timeout di 8 minuti.
  • Le richieste asincrone hanno un timeout di 60 minuti.
  • Il connettore non supporta gli operatori non supportati dall'operatore getschema. Ad esempio, gli operatori fork, facet e evaluate non sono supportati.
  • I flussi funzionano meglio in Microsoft Edge e Google Chrome.