Crea query nella console

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

Query Builder di Bigtable Studio consente di utilizzare i selettori a discesa per specificare una combinazione di clausole di query senza dover scrivere un un'applicazione o usa un'interfaccia a riga di comando. Quando esegui la query, la console effettua una chiamata all'API Bigtable Data, che restituisce i dati corrispondenti alla query.

Questo documento descrive come utilizzare Query Builder e offre suggerimenti per ottimizzare le query. Prima di leggere questa pagina, dovresti conoscere il Bigtable panoramica di Google.

Le query eseguite in Query Builder sono soggette agli stessi prezzi e alle stesse quote dei qualsiasi altra query inviata a una tabella.

Quando utilizzare Query Builder

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

  • Ottieni rapidamente una rappresentazione visiva dello schema della tabella.
  • Verifica che alcuni dati siano stati scritti correttamente.
  • Convalida l'integrità dei dati durante una migrazione.
  • Eseguire il debug di possibili problemi relativi ai dati.
  • Visualizza l'anteprima dei risultati restituiti da una combinazione specifica di clausole prima nel tuo codice. Questo può essere particolarmente utile per i nuovi utenti di Bigtable e per gli utenti esperti che non vogliono utilizzare la cbt CLI .

Prima di iniziare

Per ottenere le autorizzazioni necessarie per utilizzare Query Builder, chiedi all'amministratore di concederti Ruolo IAM Lettore Bigtable (roles/bigtable.reader) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per utilizzare lo strumento per la creazione di query. Per vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per utilizzare Query Builder sono necessarie le seguenti autorizzazioni:

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

Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati e altri ruoli predefiniti.

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

Apri Query Builder

Quando apri Query Builder, viene eseguita una query predefinita che viene visualizzata della prima tabella in ordine alfabetico. La query predefinita viene eseguita utilizzando profilo dell'app predefinito e vengono restituite fino a 100 righe.

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

    Apri l'elenco delle istanze .

  2. Fai clic sul nome dell'istanza che contiene la tabella da query.

  3. Nel riquadro di navigazione, fai clic su Bigtable Studio. Bigtable Studio si apre in modalità Query Builder. Il riquadro Explorer fornisce un elenco tabelle nell'istanza e il riquadro Risultati delle query mostra i risultati la query predefinita.

  4. (Facoltativo) Comprimi il riquadro Explorer per visualizzare il riquadro Query Builder più grande.

Formato di visualizzazione dei dati

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

menu a discesa

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

Seleziona una tabella

Utilizza il menu a discesa Tabella per selezionare l'ID della tabella che vuoi usare query.

(Facoltativo) Specifica un profilo dell'app

Puoi usare un profilo dell'app creato appositamente per la query Builder. Ciò può essere utile, ad esempio, quando vuoi isolare la query usando un cluster diverso da quello utilizzata dalla tua applicazione principale.

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

  1. Fai clic su Aggiungi alla query.
  2. Fai clic su Cambia profilo app (impostazione predefinita). Viene visualizzato un nuovo menu a discesa.
  3. Usa il menu a discesa Profilo app e scegli un'opzione dall'elenco profili delle app.

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

Se la tabella si trova in un'istanza che utilizza la replica, configura l'app per leggere dal cluster geograficamente più vicino a te.

Aggiungi clausole alla query ed eseguila

  1. Dopo aver selezionato la tabella e il profilo dell'app, aggiungi clausole alla query. Consulta la prossima sezione per maggiori dettagli sulle clausole disponibili.
  2. Dopo aver aggiunto tutte le clausole, fai clic su Esegui.
  3. Visualizzare i risultati.

Clausole di query

Per aggiungere clausole alla query, puoi utilizzare Query Builder. Quando esegui la query, Query Builder crea e invia una richiesta di lettura alla tabella. Per ulteriori informazioni sulle richieste di lettura, consulta Letture.

Le clausole della chiave di riga, dell'intervallo di chiavi di riga e del prefisso della chiave di riga determinano le righe che vengono recuperati dallo spazio di archiviazione. L'espressione regolare della chiave di riga, le colonne e le clausole relative all'intervallo di tempo aggiungono un filtro alla richiesta di lettura generata. Filtri utilizzati nella query funzionano come quando li utilizzi nelle librerie client. Per maggiori dettagli sui filtri Bigtable e su come il loro utilizzo può influire sulle prestazioni, vedi Filtri e utilizza filtri di Google.

Specifica la chiave di riga

Per recuperare una singola riga dalla tabella, fornisci un valore chiave di riga. Puoi aggiungere più clausole 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 di cui vuoi visualizzare i valori.

Specifica 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 di chiavi riga.
  3. Inserisci la chiave di riga iniziale completa.
  4. Inserisci la chiave completa della riga finale.

Specifica un prefisso della chiave di riga

Per recuperare solo le righe le cui chiavi iniziano con un insieme specifico di caratteri, filtra in base al prefisso della chiave di riga. Un prefisso chiave di riga è costituito dai primi N caratteri di una chiave di riga. Per convenzione, spesso c'è un hashtag, una barra verticale o un altro simbolo tra 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 devi inserire caratteri jolly.

Filtra 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 regex della chiave di riga. Per migliorare le prestazioni, aggiungi un intervallo di chiavi di riga o una chiave di riga di prefisso alla query prima di aggiungere il filtro regex della chiave di riga. Per indicazioni sulla composizione di un'espressione regolare, consulta Chiave di riga espressione regolare di Google.

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

Filtra per colonna

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

  1. Fai clic su Aggiungi alla query.
  2. Nell'elenco a discesa, seleziona Colonne.
  3. Fai clic sul 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.

Filtra per intervallo di tempo

Per recuperare solo le celle con un timestamp compreso in un determinato intervallo, aggiungi un intervallo di tempo che utilizza l'attributo timestamp range filtro di Google.

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

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

Il valore facoltativo T è un valore letterale che indica l'ora, mentre il valore facoltativo z indica l'ora UTC anziché l'ora locale. Per ulteriori informazioni sul timestamp formati, consulta ISO 8601 di Google.

Specifica un limite

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

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

Limitazioni

Le seguenti limitazioni si applicano a Query Builder.

  • 1000 caratteri per cella: Bigtable restituisce un può contenere al massimo 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 e colonne di ogni riga che corrispondono alla query. Le famiglie di colonne non sono archiviate in particolare, ma le colonne sono ordinate lessicograficamente all'interno del loro famiglia di colonne.
  • Massimo 1000 righe: Query Builder restituisce un massimo di le 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, ma li visualizza la dimensione del valore della cella in byte.

  • Dati meno recenti: puoi recuperare solo la cella più recente (o versione) nelle colonne su cui esegui la query. Per ulteriori dettagli su questo concetto, consulta Spazio di archiviazione Bigtable modello 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 avere un aspetto corretto.

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

Passaggi successivi