Gestire i dati utilizzando Bigtable Studio

Questa pagina spiega come esplorare e gestire i dati di Bigtable utilizzando Bigtable Studio nella Google Cloud console.

Bigtable Studio include un riquadro Explorer che si integra con quanto segue:

• Query Builder, un modulo interattivo che consente di creare ed eseguire una query senza scrivere codice
• Editor di query, in cui puoi creare ed eseguire comandi SQL
• Tabella dei risultati delle query SQL

Se non hai familiarità con Bigtable, scopri come creare un'istanza e scrivere dati con l'interfaccia a riga di comando cbt CLI .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per eseguire query su una tabella, chiedi all'amministratore di concederti i seguenti ruoli IAM sull'istanza che contiene la tabella:

• Tutti: Bigtable Reader (roles/bigtable.reader)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Esplora i tuoi dati

Puoi utilizzare Explorer per eseguire le seguenti azioni sulle risorse Bigtable:

Risorsa Bigtable	Azioni di Explorer
Tabella	crea una nuova tabella Crea backup Impedisci eliminazione Modifica Elimina Visualizza una query di esempio Visualizza backup Monitora visualizzando gli insight sul sistema Esporta in Cloud Storage
Famiglie di colonne	Aggiungi una famiglia di colonne a una tabella
Famiglia di colonne specifica	Modifica una policy di garbage collection
Vista autorizzata	Apri in Query Builder Concedi l'accesso Elimina
Visualizza	Visualizza la definizione nell'editor di query
Vista materializzata	Visualizza la definizione nell'editor di query Attiva o disattiva la protezione da eliminazione

Per accedere a Explorer:

1. Nella Google Cloud console, apri la pagina Istanze Bigtable.

   Vai all'elenco di istanze

2. Seleziona un'istanza dall'elenco.

3. Nel menu di navigazione, fai clic su Bigtable Studio. Il riquadro Explorer mostra un elenco di tabelle e viste autorizzate nell'istanza.

Eseguire query sui dati in Query Builder

Query Builder è un modulo interattivo che consente di inviare richieste di lettura all' API Bigtable Data dalla Google Cloud console senza dover scrivere codice o istruzioni SQL. Per saperne di più, consulta Creare query nella console.

Eseguire query sui dati con SQL nell'editor di query

Utilizzando l'editor di query, puoi eseguire qualsiasi combinazione di istruzioni SQL SELECT. Le istruzioni devono essere separate da un punto e virgola.

Le istruzioni vengono eseguite in base all'ordine in cui le inserisci nell'editor di query.

Nota: non puoi utilizzare un profilo di app Data Boost con l'editor di query.

Per eseguire query sui dati:

1. Nella Google Cloud console, apri la pagina Istanze Bigtable.

   Vai all'elenco di istanze

2. Seleziona un'istanza dall'elenco.

3. Nel menu di navigazione, fai clic su Bigtable Studio.

4. Componi una query:

   1. Apri una nuova scheda facendo clic su e poi scegli Editor.
   2. Quando viene visualizzato l'editor di query, scrivi la query. Se la query è SQL valido, viene visualizzato un messaggio Valido.
   3. (Facoltativo) Per restituire tutte le celle nelle colonne sottoposte a query anziché solo la cella più recente, aggiungi l'ID della tabella con (with_history => TRUE).

5. (Facoltativo) Per formattare l'istruzione in stile SQL, fai clic su Formatta.

6. Fai clic su Esegui. I risultati della query vengono visualizzati nella tabella Risultati.

7. Per visualizzare una visualizzazione formattata dei dati di una riga, fai clic sulla riga nella tabella dei risultati. Si apre il riquadro Dettagli riga. Ogni qualificatore di colonna e il relativo valore vengono visualizzati su una nuova riga. Se esegui la query utilizzando (with_history => TRUE), ogni cella di una colonna viene presentata come una struttura che include il valore e il timestamp della cella.

8. (Facoltativo) Per eseguire solo una parte selezionata del testo nell'editor, evidenziala e poi fai clic su Esegui selezione. I risultati della query evidenziata vengono visualizzati nella tabella Risultati.

Per rimuovere tutto il testo dall'editor di query, fai clic su Cancella.

Per ulteriori informazioni, inclusi esempi, sulla creazione di istruzioni SQL per eseguire query sui dati di Bigtable, consulta la panoramica di GoogleSQL per Bigtable.

Nota: puoi utilizzare un profilo di app configurato per il routing multi-cluster per eseguire query nell'editor di query, ma se la richiesta non va a buon fine, non esegue il failover su un altro cluster e devi eseguirla di nuovo.

Esportare i risultati delle query

Puoi esportare i risultati della query in uno dei seguenti modi:

• Scarica un file locale in formato CSV o JSON.
• Esporta in Fogli Google.
• Copia negli appunti in formato di file CSV, TSV o JSON.

Per esportare i risultati delle query dall'editor di query o da Query Builder:

1. Nella Google Cloud console, apri la pagina Istanze Bigtable.

   Vai all'elenco di istanze

2. Seleziona un'istanza dall'elenco.

3. Nel menu di navigazione, fai clic su Bigtable Studio.

   Il riquadro Explorer mostra un elenco di tabelle, viste e query nell'istanza.

4. Esegui la query dalla scheda Generatore o Editor.

   I risultati vengono visualizzati nella tabella Risultati.

5. Nella barra degli strumenti Risultati, fai clic su Esporta.

6. Dal menu, seleziona una delle opzioni di esportazione.

   Se hai selezionato Esporta in Fogli Google, viene visualizzata una finestra di dialogo. Fai clic su Apri per visualizzare i risultati in Fogli Google.

Creare viste

Bigtable Studio consente di creare e salvare le viste delle tabelle Bigtable. Per i dettagli, consulta la documentazione relativa a ogni tipo di vista.

Viste autorizzate

Puoi utilizzare Query Builder per creare e salvare viste autorizzate, ovvero sottoinsiemi di tabelle a cui concedi l'accesso separatamente dall'accesso alla tabella. Puoi anche concedere l'accesso ed eliminare le viste autorizzate in Bigtable Studio utilizzando il menu Azione in Explorer.

Per saperne di più, consulta Creare e gestire viste autorizzate.

Viste materializzate continue

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Puoi utilizzare l'editor di query per creare una vista materializzata continua, un risultato precalcolato di una query SQL in esecuzione continua che si sincronizza con la tabella di origine con aggiornamenti incrementali. Le viste materializzate continue spesso contengono dati aggregati basati sui valori delle tabelle di origine.

Per ulteriori informazioni, consulta la seguente documentazione:

• Viste materializzate continue
• Creare e gestire viste materializzate continue
• Query di vista materializzata continue

Viste logiche

Puoi anche utilizzare l'editor di query per creare una vista logica, una query salvata su cui è possibile eseguire query come su una tabella. Le operazioni di visualizzazione logica richiedono autorizzazioni aggiuntive rispetto a quelle concesse in roles/bigtable.reader. Per saperne di più, consulta Creare e gestire viste logiche.

Query salvate

Anteprima — Query salvate

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Puoi utilizzare Bigtable Studio per creare, salvare e gestire script SQL come query salvate. Per ulteriori informazioni, consulta la seguente documentazione:

• Panoramica delle query salvate
• Creare e gestire query salvate

Passaggi successivi

• Scopri altri modi per utilizzare SQL con Bigtable.
• Segui una guida rapida utilizzando l'interfaccia a riga di comando cbt CLI .