Creare e aggiornare i contatori in Bigtable

Creare e aggiornare i contatori in Bigtable

Scopri come creare e aggiornare i contatori in Bigtable utilizzando gli aggregati, ovvero le celle della tabella che aggregano i valori al momento della scrittura. Questa guida rapida utilizza Google Cloud CLI e cbt CLI per creare tre contatori:

• Un contatore che mantiene una somma in esecuzione
• Un contatore che tiene traccia del minimo di tutti i valori aggiunti
• Un contatore che tiene traccia del massimo di tutti i valori aggiunti

Prima di iniziare

Accedi al tuo Account Google.

Se non ne hai già uno, registrati per un nuovo account.

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Dopo aver inizializzato gcloud CLI, aggiornala e installa i componenti richiesti:

gcloud components update
gcloud components install cbt

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto su cui ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l' resourcemanager.projects.create autorizzazione. Scopri come concedere i ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

• Crea un Google Cloud progetto:

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID con un nome per il Google Cloud progetto che stai creando.

• Seleziona il Google Cloud progetto che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del Google Cloud progetto.

Verifica che la fatturazione sia abilitata per il tuo Google Cloud progetto.

Abilita le API Cloud Bigtable API e Cloud Bigtable Admin API:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), che contiene l' serviceusage.services.enable autorizzazione. Scopri come concedere i ruoli.

gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Dopo aver inizializzato gcloud CLI, aggiornala e installa i componenti richiesti:

gcloud components update
gcloud components install cbt

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto su cui ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l' resourcemanager.projects.create autorizzazione. Scopri come concedere i ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

• Crea un Google Cloud progetto:

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID con un nome per il Google Cloud progetto che stai creando.

• Seleziona il Google Cloud progetto che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del Google Cloud progetto.

Verifica che la fatturazione sia abilitata per il tuo Google Cloud progetto.

Abilita le API Cloud Bigtable API e Cloud Bigtable Admin API:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), che contiene l' serviceusage.services.enable autorizzazione. Scopri come concedere i ruoli.

gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com

1. Esegui i seguenti comandi per assicurarti che gcloud CLI sia aggiornata e includa la CLI cbt:

   gcloud components update

   gcloud components install cbt

Creare un'istanza Bigtable

1. Utilizza il bigtable instances create comando per creare un'istanza.

   gcloud bigtable instances create counters-quickstart-instance \
       --display-name="Counters quickstart instance" \
       --cluster-config=id="counters-quickstart-cluster",zone="us-east1-c"
   

Connettiti all'istanza

1. Configura cbt CLI per utilizzare il tuo progetto e istanza creando un file .cbtrc.

   echo project = PROJECT_ID >> ~/.cbtrc && echo instance = counters-quickstart-instance >> ~/.cbtrc
   

   Sostituisci PROJECT_ID con l'ID del progetto che stai utilizzando.

2. Verifica di aver configurato correttamente il file .cbtrc.

   cat ~/.cbtrc
   

   Il terminale mostra i contenuti del file .cbtrc, che è simile al seguente:

   project = PROJECT_ID
   instance = counters-quickstart-instance

   Ora puoi utilizzare cbt CLI con la tua istanza.

Creare una tabella con famiglie di colonne aggregate

1. Utilizza il cbt createtable comando per creare una tabella denominata counters_quickstart_table con tre famiglie di colonne aggregate. Configura ogni famiglia di colonne con un tipo di aggregazione diverso:

   • La famiglia di colonne max_family è di tipo Max con un tipo di input Integer.
   • La famiglia di colonne min_family è di tipo Min con un tipo di input Integer.
   • La famiglia di colonne sum_family è di tipo Sum con un tipo di input Integer.

   cbt createtable counters_quickstart_table families=sum_family:never:intsum,min_family:never:intmin,max_family:never:intmax
   

2. Elenca le famiglie di colonne eseguendo il cbt ls comando.

   cbt ls counters_quickstart_table
   

   La shell mostra un output simile al seguente:

   Family Name     GC Policy
   -----------     ---------
   max_family      <never>
   min_family      <never>
   sum_family      <never>
   

Creare contatori nella tabella

1. Utilizza il cbt addtocell comando per scrivere un valore iniziale di 5 in una nuova colonna in ciascuna delle tre famiglie di colonne, utilizzando una chiave di riga row-key1 e un timestamp di 0. Questa operazione crea celle aggregate, che utilizzi come contatori.

   cbt addtocell counters_quickstart_table row-key1 sum_family:sum_column=5@0
   cbt addtocell counters_quickstart_table row-key1 min_family:min_column=5@0
   cbt addtocell counters_quickstart_table row-key1 max_family:max_column=5@0
   

Leggere i dati

1. Per visualizzare i valori dei contatori come numeri interi anziché byte, definisci un yaml file che cbt CLI può utilizzare per formattare l'output. Esegui questo comando:

   echo "families:" > cbtformat.yaml
   echo "  max_family:" >> cbtformat.yaml
   echo "    default_encoding: BigEndian" >> cbtformat.yaml
   echo "    default_type: INT64" >> cbtformat.yaml
   echo "  min_family:" >> cbtformat.yaml
   echo "    default_encoding: BigEndian" >> cbtformat.yaml
   echo "    default_type: INT64" >> cbtformat.yaml
   echo "  sum_family:" >> cbtformat.yaml
   echo "    default_encoding: BigEndian" >> cbtformat.yaml
   echo "    default_type: INT64" >> cbtformat.yaml
   

2. Verifica di aver configurato correttamente il file cbtformat.yaml.

   cat ~/cbtformat.yaml
   

   Il terminale mostra i contenuti del file cbtformat.yaml, che è simile al seguente:

   families:
     max_family:
       default_encoding: BigEndian
       default_type: INT64
     min_family:
       default_encoding: BigEndian
       default_type: INT64
     sum_family:
       default_encoding: BigEndian
       default_type: INT64
   

3. Utilizza il cbt read comando per passare il yaml file e leggere i dati che hai aggiunto alla tabella. La tabella ora ha tre colonne, ognuna con un tipo di aggregazione diverso.

   cbt read counters_quickstart_table format-file=$HOME/cbtformat.yaml
   

   La shell mostra un output simile al seguente. I valori sono formattati come numeri interi e i timestamp sono in formato UTC.

   row-key1
     max_family:max_column                    @ 1970/01/01-00:00:00.000000
       5
     min_family:min_column                    @ 1970/01/01-00:00:00.000000
       5
     sum_family:sum_column                    @ 1970/01/01-00:00:00.000000
       5
   

Aggiornare i contatori

1. Aggiungi un valore di 3 a ogni colonna della tabella, utilizzando gli stessi timestamp utilizzati quando hai creato le celle. In ogni colonna, il valore della cella viene unito al valore esistente in base al tipo di aggregazione della cella.

   cbt addtocell counters_quickstart_table row-key1 sum_family:sum_column=3@0
   cbt addtocell counters_quickstart_table row-key1 min_family:min_column=3@0
   cbt addtocell counters_quickstart_table row-key1 max_family:max_column=3@0
   

2. Utilizza di nuovo il comando cbt read per leggere i dati nella tabella. Ogni cella ora contiene un valore aggregato.

   cbt read counters_quickstart_table format-file=$HOME/cbtformat.yaml
   

   sum_column contiene la somma di 5 e 3 (8), min_column contiene il minimo dei due valori scritti (3) e max_column contiene il massimo dei due valori scritti (5).

   row-key1
       max_family:max_column                    @ 1970/01/01-00:00:00.000000
           5
       min_family:min_column                    @ 1970/01/01-00:00:00.000000
           3
       sum_family:sum_column                    @ 1970/01/01-00:00:00.000000
           8
   

3. (Facoltativo) Esegui una query sulla tabella nella Google Cloud console con SQL.

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

      Vai all'elenco delle istanze

   2. Seleziona counters-quickstart-instance dall'elenco.

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

   4. Fai clic sulla scheda Editor.

   5. Incolla questa query nell'editor:

      SELECT * FROM `counters_quickstart_table`
      

   6. Fai clic su Esegui. I risultati della query vengono visualizzati nella tabella Risultati e sono simili ai seguenti:

   _key	max_family	min_family	sum_family
   row-key1	{ "max_column": 5 }	{ "min_column": 5 }	{ "sum_column": 8 }

Libera spazio

Per evitare che al tuo Google Cloud account vengano addebitati costi relativi alle risorse utilizzate in questa pagina, elimina il Google Cloud progetto con le risorse.

1. Nel terminale, elimina la tabella counters_quickstart_table:

   cbt deletetable counters_quickstart_table
   

2. Elimina l'istanza:

   cbt deleteinstance counters-quickstart-instance
   

3. Elimina il file .cbtrc:

   rm ~/.cbtrc
   

4. Elimina il file di formattazione:

   rm ~/cbtformat.yaml
   

5. (Facoltativo) Revoca le credenziali da gcloud CLI:

   gcloud auth revoke
   

Passaggi successivi

• Scopri di più sugli aggregati.
• Utilizza SQL per eseguire query sui dati Bigtable.