Consulta i dati in Lakewatch

La pagina di query è un punto centrale per la ricerca, il filtro e l'analisi dei dati di sicurezza utilizzando SQL. L'interfaccia ti permette di scrivere query personalizzate, applicare filtri in tempo reale e visualizzare i risultati nel tempo.

Genie Code può aiutarti a esplorare dati, affinare i risultati, ottimizzare le query e interpretare i risultati. Per idee, consulta i prompt di esempio di Genie Code.

Come iniziare

Quando apri Query senza schede di query aperte, arrivi alla pagina delle query, che elenca le tue query salvate e le bozze non salvate con i controlli di ricerca e filtro:

• Cerca query per nome, oppure filtra per Creato da o Magazzino.
• L'elenco mostra, per ogni query, Nome, Creato da, Magazzino e i timestamp Creato e Aggiornato. Clicca sul nome di una query per aprirla.

Inizia una nuova query per aprire una scheda di query. Le tue schede aperte per le query persistono durante la navigazione: se lasci una scheda aperta e poi ti sposti in un'altra pagina, è ancora presente quando torni alla pagina delle query. Per tornare alla lista delle richieste, chiudi le schede aperte. Chiudendo l'ultimo, lo riporta indietro.

Usare le schede di query

Le schede delle query ti permettono di lavorare con più query contemporaneamente, rendendo facile confrontare i risultati o mantenere diversi flussi di lavoro analitici.

Lavorare con le schede

• Crea nuova scheda: clicca sul pulsante + accanto alle schede aperte per aprire una query nuova, esistente o recente
• Rinomina scheda: Clicca direttamente sul nome della scheda attiva per modificarla (non sono ammessi nomi duplicati)
• Chiudi la scheda: Clicca sulla X a destra del nome della query per chiudere una scheda. Le query che hai eseguito vengono salvate in Recenti. Una query che non hai mai eseguito è memorizzata solo nel browser e non può essere aperta da un'altra macchina finché non la esegui una sola volta.
• Riapri query chiuse: Riapri una query recentemente chiusa da Accesso rapido nella homepage delle query oppure, se hai una scheda aperta, usa il + pulsante per aprire una query esistente o recente.
• Monitorare i progressi: Le icone delle schede mostrano lo stato della query con un indicatore circolare o un segno di spunta al termine

controlli a schede

Ogni scheda di query aperta ha una barra degli strumenti con questi controlli:

• Preferito (stella): Segna la query come preferita per un accesso rapido più avanti.
• Condividi (blocco): Gestisci chi può aprire la query e il loro livello di autorizzazione.
• Cronologia delle query: Visualizza la cronologia delle esecuzioni della query, disponibile sia dalla barra delle schede che dal menu di overflow.
• Menu di overflow (⋮): Copia un link alla query, spostalo o cancellalo.

Scrittura ed esecuzione di query

Le query sono scritte in SQL all'interno delle schede di query.

Requisiti per le query

Per risultati rapidi e stabili, includere entrambi questi componenti in ogni query:

• Un filtro per intervallo di tempo. Usalo WHERE IN_TIMERANGE(time) per definire la query nell'intervallo che selezioni nel selettore data/ora. Non scrivi tu stesso gli orari di inizio e fine nella query. La colonna passata a IN_TIMERANGE() deve essere di tipo TIMESTAMP o DATE; a ogni tabella Lakewatch è garantita una colonna time, quindi IN_TIMERANGE(time) funziona sempre. L'intervallo è semi-aperto: una riga il cui timestamp è uguale all'inizio del picker è inclusa, ma una che corrisponde alla fine è esclusa. (IN_TIMERANGE() sostituisce il vecchio inRange(), che filtra su un intervallo inclusivo.)
• ORDER BY time - Consente un comportamento stabile di paging e timeline

Se ometti una delle due clausole, Lakewatch ti chiede di aggiungerla prima che la query venga eseguita, ma puoi comunque eseguire la query.

IN_TIMERANGE() è anche il modo raccomandato per limitare l'ambito delle regole di rilevamento alla relativa finestra di esecuzione. Vedi le regole di ambito per un intervallo di tempo.

Esecuzione di query

• Imposta i parametri temporali usando il selettore data/ora. La tua query viene eseguita sui dati di questi intervalli di tempo
  • Opzioni di fuso orario: Scegli tra UTC o ora locale (rilevata automaticamente dal tuo dispositivo)
  • Intervalli preimpostati: Seleziona tra opzioni predefinite (ad esempio "Ultime 24 ore")
  • Intervalli personalizzati: Usa il selezionatore del calendario per impostare date e orari specifici di inizio/fine
• Scrivi la tua query SQL nell'editor, incluse le clausole SQL elencate sopra per rendere la query veloce
• Scegli il SQL warehouse su cui eseguire la query dal selettore di calcolo nella barra delle query. È necessario un warehouse: se non ne selezioni uno, la query non viene eseguita e Lakewatch ti invita a selezionare un SQL warehouse.
• Clicca sul pulsante Esegui query per avviare l'esecuzione
• Clicca su Annulla per fermare una query in esecuzione

Affinamenti: Filtraggio e analisi

I perfezionamenti ti permettono di filtrare, ordinare e raggruppare dinamicamente i risultati delle query senza modificare o rieseguire la query originale, offrendo un modo rapido per esplorare diverse prospettive di dati risparmiando sui costi di calcolo. Puoi concatenare più affinamenti per filtri complessi.

Gestione delle modifiche

Dalla barra dei filtri:

• Aggiungi espressioni filtro direttamente usando la sintassi SQL pipe, e premi invio per eseguire
• Per applicare gli affinamenti alla tua query SQL principale, clicca sul pulsante freccia verso l'alto nell'angolo in alto a destra dell'editor di affinamento.
• Per rimuovere un filtro, passa il mouse sopra il filtro per visualizzare il pulsante Elimina (X).

Dalla tabella dei risultati:

• Fai clic con il pulsante destro sulle intestazioni delle colonne per ordinare ascendente/discendente o Raggruppare per.
• Clicca con il tasto destro sui valori delle celle per filtrare o escludere in base a quel valore specifico.
• Per i campi JSON, puoi anche filtrare per campi annidati.

Visualizzazione della linea temporale

L'istogramma della timeline fornisce una panoramica visiva dei risultati della tua query distribuiti nel tempo, rendendo facile identificare schemi, anomalie e periodi di interesse in grandi dataset. La timeline appare automaticamente quando la tua query include colonne basate sul tempo.

Uso della timeline

• Passa il mouse sulle barre per vedere il conteggio degli eventi e i timestamp per intervalli specifici
• Clicca su qualsiasi barra per saltare ai risultati di quel momento specifico
• Clicca e trascina per zoomare su una finestra temporale per un'analisi dettagliata
• Usa il pulsante zoom in o zoom out (in alto a destra) per regolare l'intervallo che stai visualizzando

Visualizzazione ed esplorazione dei risultati nella tabella

L'interfaccia dei risultati è progettata per un'esplorazione efficiente di grandi dataset, con gestione flessibile delle colonne e capacità di ispezione dettagliata delle righe.

Spostamento tra tabelle

• I risultati si caricano automaticamente mentre scorri grandi dataset.
• Usa la colonna Campi per mostrare/nascondere, riordinare o fissare le colonne.
• Clicca per espandere oggetti e array JSON per una lettura comoda.

Dettagli della riga

• Clicca su qualsiasi riga per aprire il pannello dei dettagli a destra
• Aprire da una cella specifica evidenzia quella proprietà nel riquadro

Azioni rapide

I menu contestuali del clic destro forniscono accesso istantaneo alle operazioni comuni:

• Celle dati: Copia i valori, filtra/escludi per valore o rimuovi le colonne
• Intestazioni di colonna: Ordina i dati o raggruppali per valori di colonna
• Intere righe: Copia i dati completi delle righe in formato JSON

Troubleshooting

• Nessun risultato restituito: Verifica l'intervallo di data/ora e i filtri. Prova ad ampliare i parametri
• Linea temporale mancante: assicurati che la tua query includa colonne basate sul tempo nei risultati
• Errori di interrogazione: Rivedi i dettagli degli errori mostrati sulla pagina e regola la sintassi o le impostazioni SQL
• Cancellazione ritardata: Concedere un momento per completare i processi di pulizia quando si cancellano le query
• Lavoro perso: Riapri le query chiuse da Accesso rapido nella homepage delle query