Creazione di query nella console

Puoi eseguire query e visualizzare i dati di Bigtable utilizzando il generatore di query di Bigtable Studio. Il generatore di query è un modulo interattivo nella console Google Cloud che ti consente di creare una query, eseguirla su una tabella, e visualizzare i risultati nella console.

Il generatore di query di Bigtable Studio ti consente di utilizzare i selettori a discesa per specificare una combinazione di clausole di query senza dover scrivere un'applicazione o utilizzare una CLI. Quando esegui la query, la console effettua una chiamata all'API Bigtable Data, che restituisce i dati che corrispondono alla query.

Questo documento descrive come utilizzare il generatore di query e offre suggerimenti per ottimizzare le query. Prima di leggere questa pagina, dovresti acquisire familiarità con la panoramica di Bigtable .

Le query eseguite nel generatore di query sono soggette agli stessi prezzi e quote di qualsiasi altra query inviata a una tabella.

Quando utilizzare il generatore di query

La possibilità di eseguire query sui dati di Bigtable nella Google Cloud console è utile quando devi eseguire le seguenti operazioni:

  • Ottenere rapidamente una rappresentazione visiva dello schema della tabella.
  • Verificare che determinati dati siano stati scritti correttamente.
  • Convalidare l'integrità dei dati durante una migrazione.
  • Eseguire il debug di possibili problemi relativi ai dati.
  • Visualizzare l'anteprima dei risultati restituiti da una combinazione specifica di clausole prima di utilizzarli nel codice. Questo può essere particolarmente utile per i nuovi utenti di Bigtable, nonché per gli utenti esperti che non vogliono utilizzare la cbt CLI .

Prima di iniziare

Per ottenere le autorizzazioni necessarie per utilizzare il generatore di query, chiedi all'amministratore di concederti il ruolo IAM Bigtable Reader (roles/bigtable.reader) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito include le autorizzazioni necessarie per utilizzare il generatore di query. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per utilizzare il generatore di query sono necessarie le seguenti autorizzazioni:

  • bigtable.tables.get
  • bigtable.instances.get
  • bigtable.appProfiles.list
  • bigtable.tables.list
  • bigtable.tables.readRows

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Se non hai una tabella su cui eseguire query, puoi creare una piccola tabella di test ed eseguire le query su di essa.

Aprire il generatore di query

Quando apri il generatore di query, viene eseguita e visualizzata una query predefinita per la prima tabella in ordine alfabetico nell'istanza. La query predefinita viene eseguita utilizzando il profilo dell'app predefinito e vengono restituite fino a 100 righe.

  1. Apri l'elenco delle istanze Bigtable nella Google Cloud console.

    Apri l'elenco delle istanze

  2. Fai clic sul nome dell'istanza che contiene la tabella su cui vuoi eseguire query.

  3. Nel riquadro di navigazione, fai clic su Bigtable Studio. La pagina Bigtable Studio si apre in modalità generatore di query. Il riquadro Esplora fornisce un elenco di tabelle nell'istanza, mentre il riquadro Risultati query mostra i risultati della query predefinita.

  4. (Facoltativo) Comprimi il riquadro Esplora per ingrandire il riquadro del generatore di query.

Formato di visualizzazione dei dati

I risultati del generatore di query vengono visualizzati in una tabella. La prima intestazione e colonna è Chiave di riga. Le intestazioni rimanenti rappresentano ciascuna una colonna nella tabella Bigtable, espressa come famiglia di colonne e qualificatore di colonna separati da due punti. Ad esempio, l'intestazione cell_plan: data_plan_01gb indica che i valori in quella colonna provengono dalla colonna data_plan_01gb nella famiglia di colonne cell_plan.

a discesa

Viene restituito solo il valore più recente per una colonna. I timestamp sono nascosti per impostazione predefinita, ma puoi fare clic sul pulsante di attivazione/disattivazione per visualizzarli.

Selezionare una tabella

Utilizza l'elenco a discesa Tabella per selezionare l'ID della tabella su cui vuoi eseguire query.

(Facoltativo) Specificare un profilo dell'app

Puoi utilizzare un profilo dell'app creato appositamente per l'utilizzo con il generatore di query. Questo può essere utile, ad esempio, quando vuoi isolare il traffico delle query utilizzando un cluster diverso da quello utilizzato dall'applicazione principale.

Per utilizzare un profilo dell'app diverso per eseguire la query successiva, segui questi passaggi.

  1. Fai clic su Aggiungi alla query.
  2. Fai clic su Modifica profilo dell'app (predefinito). Viene visualizzato un nuovo elenco a discesa.
  3. Utilizza l'elenco a discesa Profilo dell'app e scegli dall'elenco dei profili dell'app dell'istanza.

Per saperne di più sui vantaggi dell'utilizzo di profili dell'app diversi per carichi di lavoro diversi, consulta Informazioni sui profili dell'app . Per scoprire come creare un profilo dell'app, consulta Creare e configurare profili dell'app .

Se la tabella si trova in un'istanza che utilizza la replica, configura il profilo dell'app in modo che legga dal cluster geograficamente più vicino a te.

Aggiungere clausole alla query ed eseguirla

  1. Dopo aver selezionato la tabella e il profilo dell'app, aggiungi le clausole alla query. Per i dettagli sulle clausole disponibili, consulta la sezione successiva.
  2. Dopo aver aggiunto tutte le clausole, fai clic su Esegui.
  3. Visualizza i risultati.

Clausole di query

Utilizza il generatore di query per aggiungere clausole alla query. Quando esegui la query, il generatore di query crea e invia una richiesta di lettura alla tabella. Per saperne di più sulle richieste di lettura, consulta Letture.

Le clausole relative alla chiave di riga, all'intervallo di chiavi di riga e al prefisso della chiave di riga determinano le righe recuperate dallo spazio di archiviazione. Le clausole relative all'espressione regolare della chiave di riga, alle colonne e all'intervallo di tempo aggiungono un filtro alla richiesta di lettura generata. I filtri utilizzati nel generatore di query funzionano come quando li utilizzi nelle librerie client. Per i dettagli sui filtri di Bigtable e su come il loro utilizzo può influire sul rendimento, consulta Filtri e Utilizzare i filtri .

Specificare la chiave di riga

Per recuperare una singola riga dalla tabella, fornisci un valore della chiave di riga. Puoi aggiungere più clausole relative alla chiave di riga.

  1. Fai clic su Aggiungi alla query.
  2. Nell'elenco a discesa, seleziona Chiave di riga.
  3. Inserisci il valore esatto della chiave di riga per cui vuoi visualizzare i valori.

Specificare un intervallo di chiave di riga

Per recuperare un intervallo di righe dalla tabella, specifica una chiave di riga iniziale e finale. Bigtable archivia i dati in ordine lessicografico per chiave di riga.

  1. Fai clic su Aggiungi alla query.
  2. Nell'elenco a discesa, seleziona Intervallo chiavi di riga.
  3. Inserisci la chiave di riga iniziale completa.
  4. Inserisci la chiave di riga finale completa.

Specificare un prefisso della chiave di riga

Per recuperare solo le righe le cui chiavi di riga iniziano con un insieme specifico di caratteri, filtra per prefisso della chiave di riga. Un prefisso della chiave di riga è costituito dai primi N caratteri di una chiave di riga. Per convenzione, spesso è presente un simbolo di cancelletto, una barra verticale o un altro simbolo tra il prefisso e il resto della chiave di riga.

  1. Fai clic su Aggiungi alla query.
  2. Nell'elenco a discesa, seleziona Prefisso chiave di riga.
  3. Inserisci un prefisso della chiave di riga. Non è necessario inserire simboli con caratteri jolly.

Filtrare per espressione regolare della chiave di riga

Per ottenere solo le righe i cui valori della chiave di riga corrispondono a un'espressione regolare specificata, utilizza un filtro per espressione regolare della chiave di riga. Per un rendimento migliore, aggiungi una clausola relativa all'intervallo di chiavi di riga o al prefisso della chiave di riga alla query prima di aggiungere il filtro per espressione regolare della chiave di riga. Per indicazioni sulla composizione dell'espressione regolare, consulta Espressione regolare della chiave di riga .

  1. Fai clic su Aggiungi alla query.
  2. Nell'elenco a discesa, seleziona Espressione regolare della chiave di riga.
  3. Inserisci un'espressione regolare che utilizza la sintassi re2

Filtrare per colonna

Per specificare una o più colonne da includere nella query, aggiungi una clausola columns, scegliendo la famiglia di colonne e il qualificatore di colonna per ogni colonna in base alla quale vuoi filtrare. La richiesta di lettura generata quando aggiungi questa clausola include il filtro per espressione regolare della famiglia di colonne e il filtro per intervallo di colonne .

  1. Fai clic su Aggiungi alla query.
  2. Nell'elenco a discesa, seleziona Colonne.
  3. Fai clic nel campo Colonne. Viene visualizzato un elenco di famiglie di colonne.
  4. Fai clic su un ID famiglia di colonne. Viene visualizzato un elenco di qualificatori di colonna.
  5. Fai clic su un qualificatore di colonna.

Filtrare per intervallo di tempo

Per recuperare solo le celle con un timestamp in un determinato intervallo, aggiungi una clausola relativa all'intervallo di tempo, che utilizza il filtro per intervallo di timestamp .

  1. Fai clic su Aggiungi alla query.
  2. Nell'elenco a discesa, seleziona Intervallo di tempo.
  3. Inserisci un timestamp iniziale.
  4. Inserisci un timestamp finale.

Fornisci un timestamp in uno dei seguenti formati:

  • Un timestamp Unix in microsecondi, ad esempio 3023483279876000
  • YYYY-MM-DDThh:mm:ss:ss[z]
  • YYYY/MM/DD-hh:mm:ss.sss[z]
  • MM/GG/AAAA
  • AAAA/MM/GG

T è un valore letterale facoltativo che indica l'ora, mentre z indica l'ora UTC anziché l'ora locale. Per saperne di più sui formati dei timestamp, consulta ISO 8601 .

Specificare un limite

Per specificare un numero massimo di righe restituite, aggiungi una clausola limit.

  1. Fai clic su Aggiungi alla query.
  2. Nell'elenco a discesa, seleziona Limite.
  3. Inserisci un numero compreso tra 1 e 1000.

Limitazioni

Al generatore di query si applicano le seguenti limitazioni.

  • 1000 caratteri per cella : Bigtable restituisce un massimo di 1000 caratteri per cella. Se una cella contiene più di 1000 caratteri, viene visualizzato un risultato troncato, annotato con il numero di caratteri non visualizzati.
  • Massimo 100 colonne : Bigtable restituisce le prime 100 colonne di ogni riga che corrispondono alla query. Le famiglie di colonne non vengono archiviate in un ordine particolare, ma le colonne vengono ordinate lessicograficamente all'interno della famiglia di colonne.
  • Massimo 1000 righe : il generatore di query restituisce un massimo delle prime 1000 righe di dati che corrispondono alla query.
  • Base64 : Bigtable fa del suo meglio per visualizzare con precisione i dati con codifica Base64, ma i risultati non sono garantiti. Se Bigtable non è in grado di visualizzare i dati in una cella, visualizza invece le dimensioni in byte del valore della cella.

  • Dati precedenti : puoi recuperare solo la cella (o la versione) più recente nelle colonne su cui esegui query. Per i dettagli su questo concetto, consulta Modello di archiviazione di Bigtable e Concetti generali

  • Dati serializzati : i dati archiviati come buffer di protocollo non vengono visualizzati correttamente nei risultati della query. I dati JSON sono supportati meglio, ma non è garantito che vengano visualizzati correttamente.

  • Timestamp artificiali : se la tua applicazione assegna numeri non timestamp alla proprietà timestamp delle celle quando scrive i dati nella tabella, puoi utilizzare i filtri per intervallo di tempo nella query per ottenere un intervallo dei valori che utilizzi al posto dei timestamp, a condizione che li specifichi come microsecondi. Per capire perché i dati della tabella potrebbero utilizzare timestamp artificiali, consulta Timestamp

Passaggi successivi