Esecuzione di query sui dati da Azure Time Series Insights Gen2

  • Articolo

Nota

Il servizio Time Series Insights (TSI) non sarà più supportato dopo marzo 2025. Valutare la possibilità di eseguire la migrazione di ambienti TSI esistenti a soluzioni alternative il prima possibile. Per altre informazioni sulla deprecazione e la migrazione, vedere la documentazione.

Azure Time Series Insights Gen2 consente l'esecuzione di query sui dati su eventi e metadati archiviati nell'ambiente tramite API di superficie pubblica. Queste API vengono usate anche dal Azure Time Series Insights TSI Explorer.

In Azure Time Series Insights Gen2 sono disponibili tre categorie di API primarie:

  • API di ambiente: queste API abilitano le query sull'ambiente Azure Time Series Insights Gen2 stesso. Questi possono essere usati per raccogliere l'elenco di ambienti a cui il chiamante ha accesso e metadati dell'ambiente.
  • API di time series Model-Query (TSM-Q): abilita le operazioni di creazione, lettura, aggiornamento ed eliminazione (CRUD) sui metadati archiviati nel modello Time Series dell'ambiente. Possono essere usati per accedere e modificare istanze, tipi e gerarchie.
  • API TSQ (Time Series Query): consente il recupero di dati di telemetria o eventi durante la registrazione dal provider di origine e consente calcoli e aggregazioni efficienti sui dati usando funzioni scalari e di aggregazione avanzate.

Azure Time Series Insights Gen2 usa un linguaggio di espressioni avanzato basato su stringhe, Time Series Expression (TSX) per esprimere i calcoli nelle variabili Time Series.

Panoramica delle API di Azure Time Series Insights Gen2

Sono supportate le API principali seguenti.

Panoramica delle query time series

API di ambiente

  • API Get Environments: restituisce l'elenco di ambienti a cui il chiamante è autorizzato ad accedere.
  • API Di disponibilità Get Environments: restituisce la distribuzione del conteggio degli eventi sul timestamp $tsdell'evento . Questa API consente di determinare se sono presenti eventi nell'ambiente restituendo il numero di eventi suddivisi in intervalli di tempo, se presenti.
  • API Get Event Schema: restituisce i metadati dello schema eventi per un determinato intervallo di ricerca. Tale API consente di recuperare tutti i metadati e le proprietà disponibili nello schema per l'intervallo di ricerca specificato.

API TSM-Q (Time Series Model-Query)

La maggior parte di queste API supporta l'operazione di esecuzione batch per abilitare operazioni CRUD batch su più entità del modello Time Series:

  • API Impostazioni modello: abilita GET e PATCH per il tipo predefinito e il nome del modello dell'ambiente.
  • API Tipi: abilita CRUD sui tipi Time Series e sulle variabili associate.
  • API gerarchie: abilita CRUD nelle gerarchie time series e nei percorsi dei campi associati.
  • API istanze: abilita CRUD nelle istanze di Time Series e nei relativi campi di istanza associati. Inoltre, l'API Istanze supporta le operazioni seguenti:
    • Ricerca: recupera un elenco parziale di riscontri nella ricerca di istanze di serie temporali in base agli attributi dell'istanza.
    • Suggerimento: cerca e suggerisce un elenco parziale di riscontri nella ricerca di istanze di serie temporali basate sugli attributi dell'istanza.

API TSQ (Time Series Query)

Queste API sono disponibili in entrambi gli archivi (ad accesso frequente e sporadico) nella soluzione di archiviazione multilivello.

  • API Recupera eventi: abilita la query e il recupero di eventi non elaborati e i timestamp degli eventi associati durante la registrazione in Azure Time Series Insights Gen2 dal provider di origine. Questa API consente il recupero di eventi non elaborati per un determinato ID serie temporale e intervallo di ricerca. Questa API supporta la paginazione per recuperare il set di dati di risposta completo per l'input selezionato.

    Importante

    Come parte delle prossime modifiche apportate alle regole di flating e escape JSON, le matrici verranno archiviate come tipo dinamico . Le proprietà del payload archiviate come questo tipo sono accessibili SOLO tramite l'API Get Events.

  • API Get Series: abilita la query e il recupero di valori calcolati e i timestamp dell'evento associati applicando calcoli definiti dalle variabili negli eventi non elaborati. Queste variabili possono essere definite nel modello Time Series o fornite inline nella query. Questa API supporta la paginazione per recuperare il set di dati di risposta completo per l'input selezionato.

  • API Della serie di aggregazioni: abilita la query e il recupero di valori aggregati e i timestamp di intervallo associati applicando calcoli definiti dalle variabili negli eventi non elaborati. Queste variabili possono essere definite nel modello Time Series o fornite inline nella query. Questa API supporta la paginazione per recuperare il set di dati di risposta completo per l'input selezionato.

    Per un intervallo di ricerca e un intervallo di ricerca specificati, questa API restituisce una risposta aggregata per intervallo per variabile per un ID serie temporale. Il numero di intervalli nel set di dati di risposta viene calcolato contando i tick dei periodi (il numero di millisecondi trascorsi dall'epoca Unix - 1° gennaio 1970) e dividendo i tick in base alle dimensioni dell'intervallo specificato nella query.

    I timestamp restituiti nel set di risposte sono dei limiti dell'intervallo di sinistra, non degli eventi campionati dall'intervallo.

Selezione del tipo di archivio

Le API precedenti possono essere eseguite solo su uno dei due tipi di archiviazione (cold o warm) in una singola chiamata. I parametri DELL'URL di query vengono usati per specificare il tipo di archivio su cui deve essere eseguita la query.

Se non viene specificato alcun parametro, la query verrà eseguita nell'archivio ad accesso sporadico, per impostazione predefinita. Se una query si estende su un intervallo di tempo sovrapposto sia ad archivio ad accesso sporadico che ad archivio ad accesso frequente, è consigliabile instradare la query all'archivio ad accesso sporadico per un'esperienza ottimale perché l'archivio ad accesso frequente conterrà solo dati parziali.

Il connettore Azure Time Series Insights Explorer e Power BI effettua chiamate alle API precedenti e seleziona automaticamente il parametro storeType corretto, dove pertinente.

Passaggi successivi