Condividi tramite

Esecuzione di query sui dati da Azure Time Series Insights Gen2

  • Articolo

Nota

Il servizio Time Series Insights verrà ritirato il 7 luglio 2024. Valutare la possibilità di eseguire la migrazione di ambienti esistenti a soluzioni alternative il prima possibile. Per altre informazioni sulla deprecazione e la migrazione, visitare la documentazione.

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

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

  • API di ambiente: queste API abilitano le query nell'ambiente Azure Time Series Insights Gen2 stesso. Questi possono essere usati per raccogliere l'elenco di ambienti a cui il chiamante ha accesso ai metadati dell'ambiente e .
  • API Time Series Model-Query (TSM-Q): abilita operazioni di creazione, lettura, aggiornamento ed eliminazione (CRUD) sui metadati archiviati nel modello Time Series dell'ambiente. Questi possono essere usati per accedere e modificare le istanze, i tipi e le 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 espressione basato su stringhe avanzato, 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 Recupera ambienti: restituisce l'elenco di ambienti a cui il chiamante è autorizzato ad accedere.
  • API di disponibilità Get Environments: restituisce la distribuzione del numero di eventi nel timestamp $tsdell'evento . Questa API consente di determinare se sono presenti eventi nell'ambiente restituendo il conteggio degli eventi suddivisi in intervalli di tempo, se presenti.
  • API Get Event Schema (Ottieni schema eventi): restituisce i metadati dello schema di eventi per un intervallo di ricerca specifico. 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 le 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 Dei tipi: abilita CRUD nei tipi Time Series e nelle 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 in base agli attributi dell'istanza.

API TSQ (Time Series Query)

Queste API sono disponibili in entrambi i negozi (ad accesso frequente e sporadico) nella soluzione di archiviazione a più livelli.

  • API Recupera eventi: abilita query e 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 query e recupero di valori calcolati e timestamp degli eventi 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 query e recupero di valori aggregati e 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 conteggiando 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 di intervallo specificate nella query.

    I timestamp restituiti nel set di risposte sono dei limiti dell'intervallo sinistro, 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 in 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 all'archivio ad accesso sporadico che a quello 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.

Azure Time Series Insights Explorer e Power BI Connector effettuano chiamate alle API precedenti e selezioneranno automaticamente il parametro storeType corretto, se pertinente.

Passaggi successivi