Modifica di un'istanza
Dopo aver creato un'istanza di Cloud Bigtable, puoi aggiornare le impostazioni seguenti senza tempi di inattività:
-
Puoi abilitare o disabilitare la scalabilità automatica per i cluster di un'istanza o configurare le impostazioni per i cluster per i quali è già abilitata la scalabilità automatica.
Il numero di nodi nei cluster scalati manualmente
Dopo aver aggiunto o rimosso i nodi, in genere sono necessari alcuni minuti sotto il carico per Bigtable per ottimizzare le prestazioni del cluster.
Il numero di cluster nell'istanza
Dopo aver aggiunto un cluster, occorre tempo per la replica dei dati in Bigtable nel nuovo cluster. I nuovi cluster vengono replicati dal cluster geograficamente più vicino nell'istanza. In generale, maggiore è la distanza, maggiore sarà la replica.
I profili di applicazione per l'istanza, che contengono le impostazioni di replica
Le etichette dell'istanza, che forniscono metadati sull'istanza
Il nome visualizzato per l'istanza
Puoi modificare un ID cluster solo eliminando e ricreando il cluster.
Per modificare una qualsiasi delle seguenti opzioni, devi creare una nuova istanza con le impostazioni che preferisci, esportare i dati dalla vecchia istanza, importare i dati nella nuova istanza, quindi eliminare la vecchia istanza.
ID istanza
Tipo di archiviazione (SSD o HDD)
Configurazione della chiave di crittografia gestita dal cliente (CMEK)
Prima di iniziare
Se vuoi utilizzare le interfacce a riga di comando per Bigtable,
installa Google Cloud CLI e
cbt
l'interfaccia a riga di comando
se non lo hai già fatto.
Configura scalabilità automatica
Puoi abilitare o disabilitare la scalabilità automatica per qualsiasi cluster esistente. Puoi anche modificare il target di utilizzo della CPU, il numero minimo di nodi e il numero massimo di nodi per un cluster. Per indicazioni sulla scelta delle impostazioni di scalabilità automatica, consulta Scalabilità automatica. Non puoi utilizzare l'interfaccia a riga di comando cbt
per configurare la scalabilità automatica.
Abilita scalabilità automatica
Console
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza da modificare, quindi su Modifica istanza.
In Configura cluster, fai clic su Modifica
per il cluster da aggiornare.Seleziona Scalabilità automatica.
Inserisci i valori relativi ai seguenti valori:
- Numero minimo di nodi
- Numero massimo di nodi
- Target di utilizzo della CPU
- Target di utilizzo dello spazio di archiviazione
Fai clic su Salva.
gcloud
Se non conosci l'ID istanza, utilizza il comando
bigtable instances list
per visualizzare un elenco delle istanze del progetto:gcloud bigtable instances list
Se non conosci gli ID cluster dell'istanza, utilizza il comando
bigtable clusters list
per visualizzare un elenco dei cluster nell'istanza:gcloud bigtable clusters list --instances=INSTANCE_ID
Sostituisci
INSTANCE_ID
con l'identificatore permanente dell'istanza.Utilizza il comando
bigtable clusters update
per abilitare la scalabilità automatica:gcloud bigtable clusters update CLUSTER_ID \ --instance=INSTANCE_ID \ --autoscaling-max-nodes=AUTOSCALING_MAX_NODES \ --autoscaling-min-nodes=AUTOSCALING_MIN_NODES \ --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET \ --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET
Fornire quanto segue:
CLUSTER_ID
: l'identificatore permanente per il cluster.INSTANCE_ID
: l'identificatore permanente dell'istanza.AUTOSCALING_MAX_NODES
: il numero minimo di nodiAUTOSCALING_MIN_NODES
: il numero massimo di nodiAUTOSCALING_CPU_TARGET
: la percentuale del target di utilizzo della CPU mantenuta da Bigtable aggiungendo o rimuovendo nodi. Questo valore deve essere compreso tra 10 e 80.AUTOSCALING_STORAGE_TARGET
: il target di utilizzo dello spazio di archiviazione in GiB per nodo mantenuto da Bigtable aggiungendo o rimuovendo nodiIn molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma esistono eccezioni. Scopri di più sui nodi e sulla replica.
Disabilita scalabilità automatica
Console
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza da modificare, quindi su Modifica istanza.
In Configura cluster, fai clic su
per il cluster da aggiornare.Seleziona Allocazione manuale dei nodi.
Inserisci il numero di nodi per il cluster nel campo Quantità.
In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma esistono eccezioni. Scopri di più sui nodi e sulla replica.
Fai clic su Salva.
gcloud
Se non conosci l'ID istanza, utilizza il comando
bigtable instances list
per visualizzare un elenco delle istanze del progetto:gcloud bigtable instances list
Se non conosci gli ID cluster dell'istanza, utilizza il comando
bigtable clusters list
per visualizzare un elenco dei cluster nell'istanza:gcloud bigtable clusters list --instances=INSTANCE_ID
Sostituisci
INSTANCE_ID
con l'identificatore permanente dell'istanza.Utilizza il comando
bigtable clusters update
per disabilitare la scalabilità automatica e configurare un numero costante di nodi:gcloud bigtable clusters update CLUSTER_ID \ --instance=INSTANCE_ID \ --num-nodes=NUM_NODES --disable-autoscaling
Fornire quanto segue:
CLUSTER_ID
: l'identificatore permanente per il cluster.INSTANCE_ID
: l'identificatore permanente dell'istanza.NUM_NODES
: Il numero di nodi nel cluster. Ogni cluster in un'istanza deve avere uno o più nodi.In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma esistono eccezioni. Scopri di più sui nodi e sulla replica.
Modifica impostazioni di scalabilità automatica
Console
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza da modificare, quindi su Modifica istanza.
In Configura cluster, fai clic su
per il cluster da aggiornare.Inserisci i nuovi valori per tutti gli elementi che vuoi modificare:
- Numero minimo di nodi
- Numero massimo di nodi
- Target di utilizzo della CPU
- Target di utilizzo dello spazio di archiviazione
Fai clic su Salva.
gcloud
Se non conosci l'ID istanza, utilizza il comando
bigtable instances list
per visualizzare un elenco delle istanze del progetto:gcloud bigtable instances list
Se non conosci gli ID cluster dell'istanza, utilizza il comando
bigtable clusters list
per visualizzare un elenco dei cluster nell'istanza:gcloud bigtable clusters list --instances=INSTANCE_ID
Sostituisci
INSTANCE_ID
con l'identificatore permanente dell'istanza.Utilizza il comando
bigtable clusters update
per aggiornare le impostazioni per la scalabilità automatica:gcloud bigtable clusters update CLUSTER_ID \ --instance=INSTANCE_ID \ [--autoscaling-max-nodes=AUTOSCALING_MAX_NODES] \ [--autoscaling-min-nodes=AUTOSCALING_MIN_NODES] \ [--autoscaling-cpu-target=AUTOSCALING_CPU_TARGET] \ [--autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET]
Fornire quanto segue:
CLUSTER_ID
: l'identificatore permanente per il cluster.INSTANCE_ID
: l'identificatore permanente dell'istanza.
Il comando accetta flag di scalabilità automatica facoltativi. Puoi utilizzare tutti i flag o solo quelli per i valori da modificare.
AUTOSCALING_MAX_NODES
: il numero minimo di nodi.AUTOSCALING_MIN_NODES
: il numero massimo di nodi.AUTOSCALING_CPU_TARGET
: la percentuale del target di utilizzo della CPU mantenuta da Bigtable aggiungendo o rimuovendo nodi. Questo valore deve essere compreso tra 10 e 80.AUTOSCALING_STORAGE_TARGET
: il target di utilizzo dello spazio di archiviazione in GiB per nodo gestito da Bigtable aggiungendo o rimuovendo nodi.In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma esistono eccezioni. Scopri di più sui nodi e sulla replica.
Aggiungi o rimuovi nodi manualmente
Quando la modalità di scalabilità dei nodi di un cluster è manuale, puoi aggiungere o rimuovere i nodi e il numero di nodi rimane costante fino a quando non lo cambi di nuovo. Per esaminare le quote di nodi predefinite per zona per progetto Google Cloud, consulta Quote per i nodi. Se hai bisogno di eseguire il provisioning di più nodi rispetto a quelli predefiniti, puoi richiederne altri.
Per modificare il numero di nodi in un cluster che utilizza la scalabilità manuale:
Console
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza da modificare, quindi su Modifica istanza.
In Configura cluster, fai clic su Modifica
per il cluster da aggiornare.Nella sezione Allocazione manuale dei nodi, inserisci il numero di nodi per il cluster nel campo Quantità.
In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma esistono eccezioni. Scopri di più sui nodi e sulla replica.
Fai clic su Salva.
gcloud
Se non conosci l'ID istanza, utilizza il comando
bigtable instances list
per visualizzare un elenco delle istanze del progetto:gcloud bigtable instances list
Se non conosci gli ID cluster dell'istanza, utilizza il comando
bigtable clusters list
per visualizzare un elenco dei cluster nell'istanza:gcloud bigtable clusters list --instances=INSTANCE_ID
Sostituisci
INSTANCE_ID
con l'identificatore permanente dell'istanza.Usa il comando
bigtable clusters update
per modificare il numero di nodi:gcloud bigtable clusters update CLUSTER_ID \ --instance=INSTANCE_ID \ --num-nodes=NUM_NODES
Fornire quanto segue:
CLUSTER_ID
: l'identificatore permanente per il cluster.INSTANCE_ID
: l'identificatore permanente dell'istanza.NUM_NODES
: Il numero di nodi nel cluster. Ogni cluster in un'istanza deve avere uno o più nodi.In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma esistono eccezioni. Scopri di più sui nodi e sulla replica.
cbt
Se non conosci l'ID istanza, utilizza il comando
listinstances
per visualizzare un elenco delle istanze del progetto:cbt listinstances
Se non conosci gli ID cluster dell'istanza, utilizza il comando
listclusters
per visualizzare un elenco dei cluster nell'istanza:cbt -instance=INSTANCE_ID listclusters
Sostituisci
INSTANCE_ID
con l'identificatore permanente dell'istanza.Usa il comando
updatecluster
per modificare il numero di nodi:cbt -instance=INSTANCE_ID updatecluster CLUSTER_ID NUM_NODES
Fornire quanto segue:
INSTANCE_ID
: l'identificatore permanente dell'istanza.CLUSTER_ID
: l'identificatore permanente per il cluster.NUM_NODES
: Il numero di nodi nel cluster. Ogni cluster in un'istanza deve avere uno o più nodi.In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma esistono eccezioni. Scopri di più sui nodi e sulla replica.
Aggiungi un cluster
Puoi aggiungere cluster a un'istanza esistente. Un'istanza può avere cluster in massimo 8 regioni in cui è disponibile Bigtable. Ogni zona di una regione può contenere un solo cluster. Le posizioni ideali per cluster aggiuntivi dipendono dal tuo caso d'uso.
Se la tua istanza è protetta da CMEK, ogni nuovo cluster deve utilizzare una chiave CMEK che si trova nella stessa regione del cluster. Prima di aggiungere un nuovo cluster a un'istanza protetta da CMEK, identifica o crea una chiave CMEK nella regione in cui prevedi di individuare il cluster.
Prima di aggiungere cluster a un'istanza di un singolo cluster, leggi le limitazioni che si applicano quando modifichi i criteri di raccolta dei rifiuti sulle tabelle replicate. Quindi, consulta gli esempi di impostazioni di replica per i suggerimenti.
Per aggiungere un cluster a un'istanza:
Console
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza da modificare, quindi su Modifica istanza.
In Configura cluster, fai clic su Aggiungi cluster.
Se questo pulsante è disabilitato, l'istanza ha già il numero massimo di cluster.
Inserisci un ID cluster e seleziona la regione e la zona del cluster.
Inserisci il numero di nodi per il cluster.
In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma esistono eccezioni. Scopri di più sui nodi e sulla replica.
Se l'istanza è protetta da CMEK, seleziona o inserisci una chiave gestita dal cliente. La chiave CMEK deve trovarsi nella stessa regione del cluster.
Fai clic su Add (Aggiungi).
Ripeti questi passaggi per ciascun cluster aggiuntivo, quindi fai clic su Salva. Bigtable crea il cluster e inizia a replicare i dati nel nuovo cluster. Potresti notare un aumento dell'utilizzo della CPU all'inizio della replica.
Esamina le impostazioni di replica nel profilo dell'app predefinito per vedere se hanno senso per il tuo caso d'uso di replica. Potrebbe essere necessario aggiornare il profilo predefinito dell'app o creare profili di app personalizzati.
gcloud
Se non conosci l'ID istanza, utilizza il comando
bigtable instances list
per visualizzare un elenco delle istanze del progetto:gcloud bigtable instances list
Se non conosci gli ID cluster dell'istanza, utilizza il comando
bigtable clusters list
per visualizzare un elenco dei cluster nell'istanza:gcloud bigtable clusters list --instances=INSTANCE_ID
Sostituisci
INSTANCE_ID
con l'identificatore permanente dell'istanza.Utilizza il comando
bigtable clusters create
per aggiungere un cluster:gcloud bigtable clusters create CLUSTER_ID \ --async \ --instance=INSTANCE_ID \ --zone=ZONE \ [--num-nodes=NUM_NODES] \ [--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 --kms-keyring=KMS_KEYRING \ --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] \
Fornire quanto segue:
CLUSTER_ID
: l'identificatore permanente per il cluster.INSTANCE_ID
: l'identificatore permanente dell'istanza.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 una zona in una regione separata, comeeurope-west2-a
. Visualizza l'elenco delle zone.
Il flag
--async
non è obbligatorio, ma è vivamente consigliato. Senza questo flag, il comando potrebbe richiedere il timeout prima del completamento dell'operazione. Bigtable continuerà a creare il cluster in background.Il comando accetta i seguenti flag facoltativi:
--kms-key=KMS_KEY
: la chiave CMEK utilizzata dal cluster. Puoi aggiungere cluster CMEK solo alle istanze già protette da CMEK.--kms-keyring=KMS_KEYRING
: l'ID del keyring KMS per la chiave.--kms-location=KMS_LOCATION
: la posizione di Google Cloud per la chiave.--kms-project=KMS_PROJECT
: l'ID del progetto Google Cloud per la chiave.--storage-type=STORAGE_TYPE
: Il tipo di spazio di archiviazione da utilizzare per il cluster. Ogni cluster in un'istanza deve utilizzare lo stesso tipo di archiviazione. Accetta i valoriSSD
eHDD
. Il valore predefinito èSSD
.
Per l'allocazione manuale dei nodi, utilizza il flag
num-nodes
e sostituisciNUM_NODES
con il numero di nodi nel cluster. Ogni cluster in un'istanza deve avere uno o più nodi. Il valore predefinito è1
. In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma esistono eccezioni. Scopri di più sui nodi e sulla replica.Per la scalabilità automatica, specifica tutti i flag
autoscaling-
e non utilizzarenum-nodes
. Per indicazioni sulla scelta dei valori delle impostazioni di scalabilità automatica, consulta la sezione Scalabilità automatica. Sostituisci quanto segue: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
: l'utilizzo CPU target per il cluster. Questo valore deve essere compreso tra 10 e 80.AUTOSCALING_STORAGE_TARGET
: il target di utilizzo dello spazio di archiviazione in GiB mantenuto da Bigtable aggiungendo o rimuovendo nodi.
Esamina le impostazioni di replica nel profilo dell'app predefinito per vedere se hanno senso per il tuo caso d'uso di replica. Potrebbe essere necessario aggiornare il profilo predefinito dell'app o creare profili di app personalizzati.
cbt
Se non conosci l'ID istanza, utilizza il comando
listinstances
per visualizzare un elenco delle istanze del progetto:cbt listinstances
Se non conosci gli ID cluster dell'istanza, utilizza il comando
listclusters
per visualizzare un elenco dei cluster nell'istanza:cbt -instance=INSTANCE_ID listclusters
Sostituisci
INSTANCE_ID
con l'identificatore permanente dell'istanza.Utilizza il comando
createcluster
per aggiungere un cluster:cbt -instance=INSTANCE_ID createcluster CLUSTER_ID ZONE NUM_NODES STORAGE_TYPE
Fornire quanto segue:
INSTANCE_ID
: l'identificatore permanente dell'istanza.CLUSTER_ID
: l'identificatore permanente per il 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 una zona in una regione separata, comeeurope-west2-a
. Visualizza l'elenco delle zone.NUM_NODES
: Il numero di nodi nel cluster. Ogni cluster in un'istanza deve avere uno o più nodi.In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma esistono eccezioni. Scopri di più sui nodi e sulla replica.
STORAGE_TYPE
: Il tipo di spazio di archiviazione da utilizzare per il cluster. Ogni cluster in un'istanza deve utilizzare lo stesso tipo di archiviazione. Accetta i valoriSSD
eHDD
.
Esamina le impostazioni di replica nel profilo dell'app predefinito per vedere se hanno senso per il tuo caso d'uso di replica. Potrebbe essere necessario aggiornare il profilo predefinito dell'app o creare profili di app personalizzati.
Elimina un cluster
Se un'istanza ha più cluster, puoi eliminare tutti i cluster tranne 1. L'eliminazione di tutto tranne un cluster disabilita automaticamente la replica.
In alcuni casi, Bigtable non consente di eliminare un cluster:
- Se uno dei profili delle tue applicazioni instrada tutto il traffico a un singolo cluster, Bigtable non ti permette di eliminare quel cluster. Devi modificare o eliminare il profilo dell'applicazione prima di poter rimuovere il cluster.
- Se aggiungi nuovi cluster a un'istanza esistente, non puoi eliminare i cluster in tale istanza fino al completamento della copia dei dati iniziale nei nuovi cluster.
Per eliminare un cluster da un'istanza:
Console
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza da modificare, quindi su Modifica istanza.
In Configura cluster, fai clic su Elimina cluster
per il cluster che vuoi eliminare.Per annullare l'operazione di eliminazione, fai clic su Annulla, che rimane disponibile finché non fai clic su Salva. In caso contrario, fai clic su Salva.
gcloud
Se non conosci l'ID istanza, utilizza il comando
bigtable instances list
per visualizzare un elenco delle istanze del progetto:gcloud bigtable instances list
Se non conosci gli ID cluster dell'istanza, utilizza il comando
bigtable clusters list
per visualizzare un elenco dei cluster nell'istanza:gcloud bigtable clusters list --instances=INSTANCE_ID
Sostituisci
INSTANCE_ID
con l'identificatore permanente dell'istanza.Utilizza il comando
bigtable clusters delete
per eliminare il cluster:gcloud bigtable clusters delete CLUSTER_ID \ --instance=INSTANCE_ID
Fornire quanto segue:
CLUSTER_ID
: l'identificatore permanente per il cluster.INSTANCE_ID
: l'identificatore permanente dell'istanza.
cbt
Se non conosci l'ID istanza, utilizza il comando
listinstances
per visualizzare un elenco delle istanze del progetto:cbt listinstances
Se non conosci gli ID cluster dell'istanza, utilizza il comando
listclusters
per visualizzare un elenco dei cluster nell'istanza:cbt -instance=INSTANCE_ID listclusters
Sostituisci
INSTANCE_ID
con l'identificatore permanente dell'istanza.Usa il comando
deletecluster
per eliminare il cluster:cbt -instance=INSTANCE_ID deletecluster CLUSTER_ID
Fornire quanto segue:
INSTANCE_ID
: l'identificatore permanente dell'istanza.CLUSTER_ID
: l'identificatore permanente per il cluster.
Spostare i dati in una nuova posizione
Per spostare i dati in un'istanza Bigtable in una nuova zona o regione, aggiungi un nuovo cluster nella località in cui vuoi effettuare lo spostamento, quindi elimina il cluster nella località da cui vuoi eseguire il trasferimento. Il cluster eliminato rimane disponibile finché i dati non sono stati replicati nel nuovo cluster, quindi non devi preoccuparti di eventuali richieste non riuscite. Bigtable replica automaticamente tutti i dati nel nuovo cluster.
Gestisci profili delle app
I profili di applicazione, o profili delle app, controllano il modo in cui le applicazioni si connettono a un'istanza che utilizza la replica. Ogni istanza con più di un cluster ha il proprio profilo app predefinito. Puoi anche creare molti profili di app personalizzati diversi per ogni istanza, utilizzando un profilo di app diverso per ogni tipo di applicazione che esegui.
Per scoprire come configurare i profili delle app di un'istanza, consulta Configurazione dei profili app. Per esempi di impostazioni utilizzabili per implementare i casi d'uso comuni, consulta gli esempi di impostazioni di replica.
Gestisci etichette
Le etichette sono coppie chiave/valore utilizzabili per raggruppare istanze correlate e archiviare i metadati relativi a un'istanza.
Per informazioni su come gestire le etichette, consulta Aggiungere o aggiornare le etichette di un'istanza e Rimuovere un'etichetta da un'istanza.
Modifica il nome visualizzato di un'istanza
Per modificare il nome visualizzato di un'istanza, che viene utilizzata dalla console Google Cloud per identificare l'istanza:
Console
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza da modificare, quindi su Modifica istanza.
Modifica il nome dell'istanza e fai clic su Salva.
gcloud
Se non conosci l'ID istanza, utilizza il comando
bigtable instances list
per visualizzare un elenco delle istanze del progetto:gcloud bigtable instances list
Utilizza il comando
bigtable instances update
per aggiornare il nome visualizzato:gcloud bigtable instances update INSTANCE_ID \ --display-name=DISPLAY_NAME
Fornire quanto segue:
INSTANCE_ID
: l'identificatore permanente dell'istanza.DISPLAY_NAME
: un nome leggibile che identifica l'istanza nella console Google Cloud.
cbt
Questa funzionalità non è disponibile nell'interfaccia a riga di comando cbt
.
Passaggi successivi
- Scopri come aggiungere, aggiornare e rimuovere etichette per un'istanza.
- Scopri come creare e aggiornare i profili app di un'istanza, che contengono le impostazioni per la replica.