Crea un'istanza e scrivi dati con la CLI cbt
Se stai imparando a utilizzare Bigtable, puoi seguire una guida rapida per farti un'idea delle nozioni di base che utilizzeresti su largafare lo scale inn un ambiente di produzione.
In questa guida rapida, imparerai a:
- Connettiti a un'istanza Bigtable.
- Eseguire attività amministrative di base.
- Scrivere i dati in una tabella.
- Leggi i dati da una tabella.
Prima di iniziare
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Bigtable and Cloud Bigtable Admin APIs:
gcloud services enable bigtable.googleapis.com
bigtableadmin.googleapis.com -
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/bigtable.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
- Replace
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Bigtable and Cloud Bigtable Admin APIs:
gcloud services enable bigtable.googleapis.com
bigtableadmin.googleapis.com -
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/bigtable.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
- Replace
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
- Esegui questo comando per installare la CLI
cbt
:gcloud components install cbt
Apri la pagina Crea istanza nella console Google Cloud .
In Nome istanza, inserisci
Quickstart instance
.In ID istanza, inserisci
quickstart-instance
.Fai clic su Continua.
Per Tipo di archiviazione, seleziona SSD.
Fai clic su Continua.
In ID cluster, inserisci
quickstart-instance-c1
.In Regione, seleziona una regione vicina a te.
In Zona, seleziona Qualsiasi.
Per la modalità di scalabilità dei nodi, scegli Allocazione manuale.
In Quantità, seleziona 1.
Fai clic sul pulsante Crea per creare l'istanza.
Configura la CLI
cbt
in modo da utilizzare il tuo progetto e la tua istanza creando un file.cbtrc
, sostituendoPROJECT_ID
con l'ID del progetto in cui hai creato l'istanza Bigtable:echo project = PROJECT_ID >> ~/.cbtrc && echo instance = quickstart-instance >> ~/.cbtrc
Verifica di aver configurato correttamente il file
.cbtrc
:cat ~/.cbtrc
Il terminale mostra i contenuti del file
.cbtrc
, che hanno un aspetto simile al seguente:project = PROJECT_ID instance = quickstart-instance
Ora puoi utilizzare l'
cbt
CLI con la tua istanza.Crea una tabella denominata
my-table
.cbt createtable my-table
Elenca le tue tabelle:
cbt ls
Il comando mostra un output simile al seguente:
my-table
Aggiungi una famiglia di colonne denominata
cf1
:cbt createfamily my-table cf1
Elenca le famiglie di colonne:
cbt ls my-table
Il comando mostra un output simile al seguente:
Family Name GC Policy ----------- --------- cf1 <never>
Scrivi i valori
test-value1
etest-value2
nella rigar1
, utilizzando la famiglia di colonnecf1
e il qualificatore di colonnac1
:cbt set my-table r1 cf1:c1=test-value1 cbt set my-table r1 cf1:c1=test-value2
Utilizza il comando
cbt read
per leggere i dati che hai aggiunto alla tabella:cbt read my-table
La shell mostra un output simile al seguente:
---------------------------------------- r1 cf1:c1 @ 2023/03/22-06:56:11.323000 "test-value1" cf1:c1 @ 2023/03/22-06:56:04.361000 "test-value2"
Nella riga
r1
sono memorizzati due valori con timestamp per la stessa colonna.Elimina la tabella
my-table
:cbt deletetable my-table
Elimina l'istanza:
cbt deleteinstance quickstart-instance
Elimina il file
.cbtrc
:rm ~/.cbtrc
(Facoltativo) Revoca le credenziali da gcloud CLI:
gcloud auth revoke
- Segui un codelab su Bigtable.
- Visualizza la
documentazione di riferimento
cbt
dell'interfaccia a riga di comando. - Visualizza il codice sorgente di esempio per un caso d'uso di rilevamento di frodi.
- Scrivi un'applicazione Hello World in C#, C++, Go, Java, Node.js, PHP, Python, Ruby o utilizzando il client HBase per Java.
Crea un'istanza Bigtable
Connettiti all'istanza
Leggere e scrivere dati
Bigtable archivia i dati in tabelle, che contengono righe. Ogni riga è identificata da una chiave di riga.
I dati di una riga sono organizzati in famiglie di colonne, che sono gruppi di colonne. Un qualificatore di colonna identifica una singola colonna all'interno di una famiglia di colonne.
All'intersezione di una riga e una colonna possono essere presenti più celle con timestamp.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse
utilizzate in questa guida rapida, elimina l'istanza. L'eliminazione del file .cbtrc
ti consente
di lavorare a un progetto diverso.