Crea un'istanza
Un'istanza Bigtable è un contenitore per i cluster Bigtable. Un'istanza con più di un cluster utilizza la replica. Puoi creare cluster in un massimo di 8 regioni, con un numero di cluster in ogni regione pari al numero di zone.
Questa pagina spiega come creare un'istanza. Prima di leggere questa pagina, devi conoscere la panoramica di Bigtable. Ti consigliamo inoltre di leggere la panoramica di istanze, cluster e nodi.
Prima di iniziare
Prepara l'ambiente:
-
Sign in to your Google Account.
If you don't already have one, sign up for a new account.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Bigtable API, Cloud Bigtable Admin API APIs.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Bigtable API, Cloud Bigtable Admin API APIs.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Esegui il seguente comando per installare
cbt
CLI:gcloud components install cbt
Pianifica la configurazione:
(Facoltativo) Se prevedi di attivare la replica, svolgi i seguenti passaggi:
- Dedica qualche minuto alla lettura della panoramica della replica.
- Identifica il tuo caso d'uso per la replica.
- Determina la regione o le regioni in cui deve trovarsi l'istanza in base al caso d'uso, alla posizione dell'applicazione e del traffico.
- Decidi in che modo utilizzare i profili dell'applicazione per indirizzare le richieste in entrata.
(Facoltativo) Se vuoi utilizzare le chiavi di crittografia gestite dal cliente (CMEK) anziché la crittografia gestita da Google predefinita, completa le attività descritte in Creare un'istanza abilitata per CMEK e tieni a portata di mano l'ID chiave CMEK prima di creare la nuova istanza. Non puoi aggiungere la protezione CMEK a un'istanza dopo averla creata e non puoi modificare o sostituire la chiave CMEK dopo la creazione dell'istanza.
Crea un'istanza
Per creare un'istanza Bigtable:
Console
Nella console Google Cloud, vai alla pagina Crea istanza.
Inserisci un nome per l'istanza.
La console Google Cloud mostra questo nome per identificare l'istanza.
Inserisci un ID istanza.
L'ID istanza è un identificatore permanente dell'istanza.
Fai clic su Continua.
Scegli se utilizzare un disco SSD o HDD per i tuoi cluster. Nella maggior parte dei casi, l'unità SSD è la scelta migliore. Questa scelta è definitiva. Scopri di più.
Fai clic su Continua.
Inserisci un ID cluster per il primo cluster.
L'ID cluster è un identificatore permanente del cluster.
Scegli la regione e la zona in cui verrà eseguito il primo cluster.
Scegli una modalità di scalabilità dei nodi per il cluster. Nella maggior parte dei casi, dovresti scegliere l'autoscaling. Per indicazioni sulla scalabilità, consulta Scalabilità automatica.
- In Allocazione manuale dei nodi, inserisci il numero di nodi Bigtable per il primo cluster. Se non sai con certezza quanti nodi ti occorrono, utilizza il valore predefinito. Puoi aggiungere altri nodi in un secondo momento.
- Per Scalabilità automatica, inserisci i valori per quanto segue:
- Numero minimo di nodi
- Numero massimo di nodi
- Target di utilizzo della CPU
- Target di utilizzo dello spazio di archiviazione
(Facoltativo) Per proteggere l'istanza con CMEK anziché con la crittografia gestita da Google predefinita, svolgi i seguenti passaggi:
- Fai clic su Mostra opzioni di crittografia.
- Seleziona il pulsante di opzione accanto a Chiave di crittografia gestita dal cliente (CMEK).
- Seleziona o inserisci il nome della risorsa per la chiave CMEK che vuoi utilizzare per il cluster. Non potrai aggiungerlo in un secondo momento.
- Se ti viene chiesto di concedere l'autorizzazione all'account di servizio della chiave CMEK, fai clic su Concedi. Per completare questa attività, al tuo account utente deve essere concesso il ruolo Amministratore Cloud KMS.
- Fai clic su Salva.
(Facoltativo) Per attivare subito la replica, completa i seguenti passaggi aggiuntivi:
- Fai clic su Mostra opzioni avanzate.
- Fai clic su Aggiungi cluster, inserisci le impostazioni del cluster e poi fai clic su Aggiungi. Ripeti questo passaggio per creare altri cluster nell'istanza. Puoi anche attivare la replica in un secondo momento aggiungendo un cluster.
Ogni zona di una regione può contenere un solo cluster. Se il pulsante Aggiungi cluster è disabilitato, modifica la zona del primo cluster.
Per creare un'istanza con più di sei cluster, crea prima un'istanza con sei cluster, quindi aggiungi altri cluster all'istanza.
Fai clic sul pulsante Crea per creare l'istanza.
Esamina le impostazioni di replica nel profilo dell'app predefinito per verificare se sono appropriate per il tuo caso d'uso di replica. Potresti dover aggiornare il profilo dell'app predefinito o creare profili dell'app personalizzati.
gcloud
Utilizza il comando
bigtable instances create
per creare un'istanza:gcloud bigtable instances create INSTANCE_ID \ --display-name=DISPLAY_NAME \ [--cluster-storage-type=CLUSTER_STORAGE_TYPE] \ [--cluster-config=id=CLUSTER_ID,zone=CLUSTER_ZONE, \ nodes=NODES] \ [--cluster-config=id=CLUSTER_ID,zone=CLUSTER_ZONE, \ autoscaling-min-nodes=AUTOSCALING_MIN_NODES, \ autoscaling-max-nodes=AUTOSCALING_MAX_NODES, \ autoscaling-cpu-target=AUTOSCALING_CPU_TARGET, \ autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET, \ kms-key=KMS_KEY]
Sostituisci quanto segue:
INSTANCE_ID
: l'identificatore permanente dell'istanza.DISPLAY_NAME
: un nome leggibile che identifica l'istanza nella console Google Cloud.CLUSTER_ID
: l'identificatore permanente del cluster.CLUSTER_ZONE
: la zona in cui viene eseguito il cluster.
Devi configurare almeno un cluster per l'istanza utilizzando il flag
--cluster-config
. Per creare un'istanza con più cluster, ripeti il flag--cluster-config
per ogni cluster.Per l'allocazione manuale dei nodi, l'impostazione
nodes
nel flag--cluster-config
è facoltativa. Se non viene impostato alcun valore, Bigtable alloca automaticamente i nodi al cluster in base al footprint dei dati e ottimizza per l'utilizzo del 50% dello spazio di archiviazione. Questa allocazione automatica dei nodi ha un impatto sui prezzi. Se vuoi controllare il numero di nodi in un cluster, sostituisciNODES
con il numero di nodi che vuoi nel cluster. Scopri di più sui nodi.Nella maggior parte dei casi, scegli la scalabilità automatica anziché l'allocazione manuale dei nodi. Per For_autoscaling, fornisci le opzioni
autoscaling-
nel--cluster-config
flag (autoscaling-storage-target
è facoltativo) e non utilizzarenodes
. Consulta la sezione Scalabilità automatica per indicazioni su come scegliere i valori per le impostazioni di scalabilità automatica. Sostituisci quanto segue per le chiavi di opzionecluster-config
:AUTOSCALING_MIN_NODES
: il numero minimo di nodi per il cluster.AUTOSCALING_MAX_NODES
: il numero massimo di nodi per il cluster.AUTOSCALING_CPU_TARGET
: la percentuale di utilizzo della CPU target per il cluster. Questo valore deve essere compreso tra 10 e 80.AUTOSCALING_STORAGE_TARGET
: (Facoltativo) Il target di utilizzo dello spazio di archiviazione in GiB mantenuto da Bigtable aggiungendo o rimuovendo i nodi.KMS_KEY: la chiave CMEK per il cluster.
Il valore KMS_KEY deve essere impostato nel seguente formato:
projects/PROJECT/locations/LOCATION/keyRings/KEYRING/cryptoKeys/KEY
Sostituisci quanto segue:
- PROJECT: l'identificatore permanente del progetto
- LOCATION: la posizione del cluster
- KEYRING: il nome del keyring che contiene la chiave
- KEY: il nome della chiave
Di seguito è riportato un esempio:
projects/examplestore.com:dev/locations/us-east1/keyRings/devt-cmek-2/cryptoKeys/key2
Se l'istanza è protetta da CMEK, ogni cluster deve trovarsi nella stessa regione della chiave CMEK. Puoi aggiungere cluster CMEK solo a istanze già protette da CMEK. Scopri di più.
Il comando accetta i seguenti flag facoltativi:
--cluster-storage-type=CLUSTER_STORAGE_TYPE
: il tipo di archiviazione da utilizzare per l'istanza. Il valore predefinito èSSD
. Nella maggior parte dei casi, il valore predefinito è il migliore. Questa scelta è definitiva. Scopri di più.--project=PROJECT
: il progetto in cui creare il cluster se diverso da quello corrente.
Esamina le impostazioni di replica nel profilo dell'app predefinito per verificare se sono appropriate per il tuo caso d'uso di replica. Potresti dover aggiornare il profilo dell'app predefinito o creare profili dell'app personalizzati.
cbt
Inizia creando un'istanza con un singolo cluster. Usa il comando
createinstance
per creare un'istanza:cbt createinstance INSTANCE_ID \ DISPLAY_NAME \ CLUSTER_ID \ CLUSTER_ZONE \ CLUSTER_NUM_NODES \ CLUSTER_STORAGE_TYPE
Fornisci quanto segue:
INSTANCE_ID
: l'identificatore permanente dell'istanza.DISPLAY_NAME
: un nome leggibile che identifica l'istanza nella console Google Cloud.CLUSTER_ID
: l'identificatore permanente del cluster.CLUSTER_ZONE
: la zona in cui viene eseguito il cluster.CLUSTER_NUM_NODES
: questo campo è facoltativo. Se non viene impostato alcun valore, Bigtable alloca automaticamente i nodi in base al tuo footprint dei dati e ottimizza per il 50% di utilizzo dello spazio di archiviazione. Se vuoi controllare il numero di nodi in un cluster, aggiorna il valoreCLUSTER_NUM_NODES
. Assicurati che il numero di nodi sia impostato su un valore diverso da zero. Scopri di più sui nodi.CLUSTER_STORAGE_TYPE
: Il tipo di spazio di archiviazione da utilizzare per il cluster. Ogni cluster di un'istanza deve utilizzare lo stesso tipo di archiviazione. Accetta i valoriSSD
eHDD
. Nella maggior parte dei casi,SSD
è la soluzione migliore. Questa scelta è definitiva. Scopri di più.
Per attivare la replica, utilizza il comando
createcluster
per aggiungere un cluster:cbt -instance=INSTANCE_ID \ createcluster CLUSTER_ID \ ZONE \ NUM_NODES \ STORAGE_TYPE
Fornisci quanto segue:
INSTANCE_ID
: l'identificatore permanente dell'istanza appena creata.CLUSTER_ID
: l'identificatore permanente del cluster.ZONE
: la zona in cui viene eseguito il cluster.Ogni zona di una regione può contenere un solo cluster. Ad esempio, se un'istanza ha un cluster in
us-east1-b
, puoi aggiungere un cluster in un'altra zona della stessa regione, ad esempious-east1-c
, o in una zona di un'altra regione, ad esempioeurope-west2-a
.NUM_NODES
: Questo campo è facoltativo. Se non viene impostato alcun valore, Bigtable alloca automaticamente i nodi in base al tuo footprint dei dati e ottimizza per il 50% di utilizzo dello spazio di archiviazione. Se vuoi controllare il numero di nodi in un cluster, aggiorna il valoreNUM_NODES
. Assicurati che il numero di nodi sia impostato su un valore diverso da zero.In molti casi, ogni cluster di un'istanza deve avere lo stesso numero di nodi, ma esistono delle eccezioni. Scopri di più su nodi e replica.
STORAGE_TYPE
: Il tipo di spazio di archiviazione da utilizzare per il cluster. Ogni cluster di un'istanza deve utilizzare lo stesso tipo di archiviazione. Accetta i valoriSSD
eHDD
.
(Facoltativo) Esamina le impostazioni di replica nel profilo dell'app predefinito per verificare se sono appropriate per il tuo caso d'uso della replica. Potresti dover aggiornare il profilo dell'app predefinito o creare profili dell'app personalizzati.
C++
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C#
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Passaggi successivi
- Scopri come Bigtable utilizza istanze, cluster e nodi.
- Scopri di più sulla replica Bigtable.
- Esamina e aggiorna il profilo dell'app predefinito per la replica e crea profili dell'app personalizzati in base alle esigenze.
- Scopri come modificare un'istanza esistente.