Creazione di un'istanza
Un'istanza Bigtable è un container per i cluster Bigtable. Un'istanza con più cluster utilizza la replica. Puoi creare cluster in un massimo di 8 regioni, con un numero di cluster in ogni regione uguale al numero di zone.
In questa pagina viene spiegato come creare un'istanza. Prima di leggere questa pagina, dovresti acquisire familiarità con la panoramica di Bigtable. Dovresti leggere anche la panoramica su istanze, cluster e nodi.
Prima di iniziare
Prepara l'ambiente:
-
Accedi al tuo Account Google.
Se non ne hai già uno, crea un nuovo account.
-
Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Abilita le API Cloud Bigtable API, Cloud Bigtable Admin API.
- Installa Google Cloud CLI.
-
Per initialize gcloud CLI, esegui questo comando:
gcloud init
-
Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Abilita le API Cloud Bigtable API, Cloud Bigtable Admin API.
- Installa Google Cloud CLI.
-
Per initialize gcloud CLI, esegui questo comando:
gcloud init
- Esegui questo comando per installare l'interfaccia a riga di comando
cbt
:gcloud components install cbt
Pianifica la configurazione:
(Facoltativo) Se prevedi di abilitare la replica:
- Dedica qualche minuto a leggere la panoramica della replica.
- Identifica il tuo caso d'uso per la replica.
- Determina la o le regioni in cui si trova l'istanza, in base al tuo caso d'uso e alla località dell'applicazione e del traffico.
- Decidi come utilizzare i profili di applicazione per instradare le richieste in entrata.
(Facoltativo) Se vuoi utilizzare chiavi di crittografia gestite dal cliente (CMEK) anziché la crittografia predefinita gestita da Google, completa le attività descritte in Creazione di 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 la creazione e non puoi modificare o sostituire la chiave CMEK dopo la creazione dell'istanza.
Creazione di 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, SSD è l'opzione migliore. Questa scelta è definitiva. Scopri di più.
Fai clic su Continua.
Inserisci un ID 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. 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 quanti nodi hai bisogno, utilizza il valore predefinito. Puoi aggiungere altri nodi in un secondo momento.
- In Scalabilità automatica, inserisci i valori seguenti:
- Numero minimo di nodi
- Numero massimo di nodi
- Target di utilizzo CPU
- Target di utilizzo dello spazio di archiviazione
(Facoltativo) Per proteggere l'istanza con CMEK anziché con la crittografia predefinita gestita da Google, completa quanto segue:
- 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à è necessario concedere al tuo account utente il ruolo Amministratore Cloud KMS.
- Fai clic su Salva.
(Facoltativo) Per abilitare subito la replica, completa questi passaggi aggiuntivi:
- Fai clic su Mostra opzioni avanzate.
- Fai clic su Aggiungi cluster, inserisci le impostazioni per il cluster e fai clic su Aggiungi. Ripeti questo passaggio per creare altri cluster nell'istanza. Puoi anche abilitare 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 per il tuo primo cluster.
Per creare un'istanza con più di sei cluster, devi prima creare un'istanza con sei cluster, quindi aggiungere 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 adatte al tuo caso d'uso di replica. Potresti dover aggiornare il profilo dell'app predefinito o creare profili di 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 di
nodes
nel flag--cluster-config
è facoltativa. Se non viene impostato alcun valore, Bigtable alloca automaticamente i nodi al cluster in base all'ingombro dei dati e ottimizza per il 50% di utilizzo 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.Per la scalabilità automatica, specifica le opzioni
autoscaling-
nel flag--cluster-config
(autoscaling-storage-target
è facoltativo) e non utilizzarenodes
. Consulta Scalabilità automatica per linee guida su come scegliere i valori per le impostazioni di scalabilità automatica. Sostituisci quello seguente 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 target della CPU per il cluster. Questo valore deve essere compreso tra 10 e 80.AUTOSCALING_STORAGE_TARGET
: (facoltativo) il target di utilizzo dello spazio di archiviazione, espresso in GiB, gestito da Bigtable aggiungendo o rimuovendo 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 località del cluster
- KEYRING: il nome del keyring che contiene la chiave
- KEY: il nome della chiave
Ecco 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 alle 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 dal progetto attuale.
Esamina le impostazioni di replica nel profilo dell'app predefinito per verificare se sono adatte al tuo caso d'uso di replica. Potresti dover aggiornare il profilo dell'app predefinito o creare profili di app personalizzati.
cbt
Per iniziare, crea un'istanza con un singolo cluster. Utilizza 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 assegna automaticamente i nodi in base all'ingombro dei dati e ottimizza per un utilizzo dello spazio di archiviazione del 50%. 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 archiviazione da utilizzare per il cluster. Ogni cluster in un'istanza deve utilizzare lo stesso tipo di archiviazione. Accetta i valoriSSD
eHDD
. Nella maggior parte dei casi,SSD
è l'opzione migliore. Questa scelta è definitiva. Scopri di più.
Per abilitare la replica, usa 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 per l'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 una zona diversa nella stessa regione, comeus-east1-c
, o in una zona in una regione separata, ad esempioeurope-west2-a
.NUM_NODES
: questo campo è facoltativo. Se non viene impostato alcun valore, Bigtable assegna automaticamente i nodi in base all'ingombro dei dati e ottimizza per un utilizzo dello spazio di archiviazione del 50%. 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 dovrebbe avere lo stesso numero di nodi, ma esistono delle eccezioni. Scopri di più su nodi e replica.
STORAGE_TYPE
: il tipo di archiviazione da utilizzare per il cluster. Ogni cluster in un'istanza deve utilizzare lo stesso tipo di archiviazione. Accetta i valoriSSD
eHDD
.
(Facoltativo) Rivedi le impostazioni di replica nel profilo dell'app predefinito per verificare se sono adatte al tuo caso d'uso della replica. Potresti dover aggiornare il profilo dell'app predefinito o creare profili di app personalizzati.
C++
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura 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 di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura 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 di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura 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 di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura 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 di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura 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 di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura 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 di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura 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 di app personalizzati in base alle esigenze.
- Scopri come modificare un'istanza esistente.