Modifica un'istanza

Dopo aver creato un'istanza Bigtable, puoi aggiornare le seguenti impostazioni senza tempi di inattività:

  • Versione

    Puoi eseguire l'upgrade a Enterprise Plus o il downgrade a Enterprise.

  • In-memory (Anteprima)

    Puoi attivare o disattivare il livello in memoria per un cluster in un'istanza.

  • Scalabilità automatica

    Puoi attivare o disattivare la scalabilità automatica per i cluster di un'istanza o configurare le impostazioni per i cluster per cui la scalabilità automatica è già abilitata.

  • Il numero di nodi nei cluster scalati manualmente

    Dopo aver aggiunto o rimosso i nodi, in genere Bigtable impiega alcuni minuti sotto carico per ottimizzare le prestazioni del cluster.

  • Il numero di cluster nell'istanza

    Dopo aver aggiunto un cluster, è necessario del tempo prima che Bigtable replichi i dati nel nuovo cluster. I nuovi cluster vengono replicati dal cluster geograficamente più vicino nell'istanza. In generale, maggiore è la distanza, più tempo richiederà la replica.

  • I profili di applicazione per l'istanza, che contengono le impostazioni di replica

  • La posizione dei tuoi dati

  • Le etichette per l'istanza, che forniscono metadati sull'istanza

  • Il nome visualizzato dell'istanza

Puoi modificare un ID cluster solo eliminando e ricreando il cluster.

Per modificare uno dei seguenti elementi, devi creare una nuova istanza con le impostazioni che preferisci, esportare i dati dalla vecchia istanza, importare i dati nella nuova istanza e poi 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 CLI se non l'hai ancora fatto.

Cambiare versione

Puoi passare da una versione all'altra eseguendo l'upgrade a Enterprise Plus o il downgrade a Enterprise.

Esegui l'upgrade a Enterprise Plus

Una volta modificata la versione, Bigtable aggiorna automaticamente la fatturazione e hai accesso immediato alle funzionalità di Enterprise Plus.

Console

  1. Apri l'elenco delle istanze Bigtable nella console Google Cloud .

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza Enterprise da aggiornare e poi su Modifica istanza.

  3. Nella sezione Versione, seleziona Enterprise Plus.

  4. Fai clic su Salva.

  5. (Facoltativo) Abilita il livello in memoria.

gcloud

Utilizza il comando bigtable instances update per modificare la versione:

gcloud bigtable instances update INSTANCE_ID \
    --edition=ENTERPRISE_PLUS

Fornisci quanto segue:

  • INSTANCE_ID: L'identificatore permanente per l'istanza.

Eseguire il downgrade a Enterprise

Per eseguire il downgrade da Enterprise Plus a Enterprise, devi disattivare le funzionalità esclusive di Enterprise Plus. Una volta modificata l'edizione, Bigtable aggiorna automaticamente la fatturazione e perdi l'accesso alle funzionalità di Enterprise Plus.

Console

  1. Apri l'elenco delle istanze Bigtable nella console Google Cloud .

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza Enterprise di cui vuoi eseguire il downgrade, poi fai clic su Modifica istanza.

  3. Nella sezione Versione, seleziona Enterprise.

  4. Fai clic su Salva.

gcloud

Utilizza il comando bigtable instances update per modificare la versione:

gcloud bigtable instances update INSTANCE_ID \
    --edition=ENTERPRISE

Fornisci quanto segue:

  • INSTANCE_ID: L'identificatore permanente per l'istanza.

Configura in-memory

Puoi attivare, disattivare o visualizzare informazioni sul livello in memoria.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare il livello in memoria, chiedi all'amministratore di concederti il ruolo IAM Bigtable Admin (roles/bigtable.admin) sull'istanza.

Questo ruolo predefinito contiene le autorizzazioni richieste da Bigtable per funzionare con il livello in memoria. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

  • bigtable.memoryLayer.get
  • bigtable.memoryLayer.list
  • bigtable.memoryLayer.update

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per saperne di più su ruoli e autorizzazioni Bigtable, consulta Controllo dell'accesso con IAM.

Abilita il livello in memoria

Nella versione Enterprise Plus, puoi attivare il livello in memoria su un cluster. Per utilizzare il livello in-memory, devi utilizzare un profilo dell'app configurato per in-memory. Per ulteriori informazioni, consulta la panoramica in memoria.

Console

  1. Apri l'elenco delle istanze Bigtable nella console Google Cloud .

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza Enterprise da aggiornare, poi fai clic su Modifica istanza.

  3. Fai clic su Modifica cluster per il cluster in cui vuoi attivare il livello in memoria.

  4. Seleziona Abilita in memoria.

  5. Fai clic su Salva.

gcloud

Nella versione Enterprise Plus, per abilitare il livello in memoria su un cluster, utilizza il comando gcloud beta bigtable memory-layers update. 

gcloud beta bigtable memory-layers update CLUSTER_ID \
    --instance=INSTANCE_ID --enable

Fornisci quanto segue:

  • CLUSTER_ID: L'identificatore permanente del cluster.
  • INSTANCE_ID: L'identificatore permanente per l'istanza.

Disabilita il livello in memoria

Prima di eseguire il downgrade da Enterprise Plus a Enterprise, devi disattivare il livello in memoria.

Console

  1. Apri l'elenco delle istanze Bigtable nella console Google Cloud .

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza Enterprise da aggiornare, poi fai clic su Modifica istanza.

  3. Fai clic su Modifica cluster per il cluster in cui vuoi disattivare il livello in memoria.

  4. Deseleziona Abilita in memoria.

  5. Fai clic su Salva.

gcloud

Per disattivare il livello in memoria su un cluster, utilizza il comando gcloud beta bigtable memory-layers update.

gcloud beta bigtable memory-layers update CLUSTER_ID \
    --instance=INSTANCE_ID --disable

Fornisci quanto segue:

  • CLUSTER_ID: L'identificatore permanente del cluster.
  • INSTANCE_ID: L'identificatore permanente per l'istanza.

Visualizza informazioni sul livello in memoria

Puoi visualizzare lo stato e la capacità del livello in memoria di un cluster.

Console

  1. Apri l'elenco delle istanze Bigtable nella console Google Cloud .

    Apri l'elenco delle istanze

  2. Fai clic sull'ID dell'istanza che contiene il cluster che vuoi visualizzare.

  3. Nella tabella dei cluster, visualizza la colonna In-memory del cluster.

gcloud

Per visualizzare informazioni sul livello in memoria di un cluster, ad esempio lo stato in memoria, utilizza il comando gcloud beta bigtable memory-layers describe. 

gcloud beta bigtable memory-layers describe CLUSTER_ID \
    --instance=INSTANCE_ID

Fornisci quanto segue:

  • CLUSTER_ID: L'identificatore permanente del cluster.
  • INSTANCE_ID: L'identificatore permanente per l'istanza.

Configura scalabilità automatica

Puoi attivare o disattivare 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

  1. Apri l'elenco delle istanze Bigtable nella console Google Cloud .

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza da modificare, poi fai clic su Modifica istanza.

  3. In Configura cluster, fai clic su Modifica per il cluster che vuoi aggiornare.

  4. Seleziona Scalabilità automatica.

  5. 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

  6. Fai clic su Salva.

gcloud

  1. Se non conosci l'ID istanza, utilizza il comando bigtable instances list per visualizzare un elenco delle istanze del tuo progetto: 

    gcloud bigtable instances list

  2. 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.

  3. Utilizza il comando bigtable clusters update per attivare 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

    Fornisci quanto segue:

    • CLUSTER_ID: L'identificatore permanente del cluster.
    • INSTANCE_ID: L'identificatore permanente per l'istanza.
    • AUTOSCALING_MAX_NODES: Il numero minimo di nodi
    • AUTOSCALING_MIN_NODES: Il numero massimo di nodi
    • AUTOSCALING_CPU_TARGET: la percentuale di utilizzo CPU target che Bigtable mantiene 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 che Bigtable gestisce aggiungendo o rimuovendo nodi

      In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma ci sono eccezioni. Scopri di più sui nodi e sulla replica.

Disattiva la scalabilità automatica

Console

  1. Apri l'elenco delle istanze Bigtable nella console Google Cloud .

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza da modificare, poi fai clic su Modifica istanza.

  3. In Configura cluster, fai clic su per il cluster che vuoi aggiornare.

  4. Seleziona Allocazione manuale dei nodi.

  5. 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 ci sono eccezioni. Scopri di più sui nodi e sulla replica.

  6. Fai clic su Salva.

gcloud

  1. Se non conosci l'ID istanza, utilizza il comando bigtable instances list per visualizzare un elenco delle istanze del tuo progetto: 

    gcloud bigtable instances list

  2. 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.

  3. 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

    Fornisci quanto segue:

    • CLUSTER_ID: L'identificatore permanente del cluster.
    • INSTANCE_ID: L'identificatore permanente per l'istanza.

    • NUM_NODES: Questo campo è facoltativo. Se non viene impostato alcun valore, Bigtable alloca automaticamente i nodi in base all'impronta dei dati e ottimizza l'utilizzo dello spazio di archiviazione al 50%. Se vuoi controllare il numero di nodi in un cluster, aggiorna il valore NUM_NODES. Assicurati che il numero di nodi sia impostato su un valore diverso da zero.

      In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma ci sono eccezioni. Scopri di più sui nodi e sulla replica.

Modificare le impostazioni di scalabilità automatica

Console

  1. Apri l'elenco delle istanze Bigtable nella console Google Cloud .

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza da modificare, poi fai clic su Modifica istanza.

  3. In Configura cluster, fai clic su per il cluster che vuoi aggiornare.

  4. Inserisci nuovi valori per uno qualsiasi dei seguenti elementi che vuoi modificare:

    • Numero minimo di nodi
    • Numero massimo di nodi
    • Target di utilizzo della CPU
    • Target di utilizzo dello spazio di archiviazione

  5. Fai clic su Salva.

gcloud

  1. Se non conosci l'ID istanza, utilizza il comando bigtable instances list per visualizzare un elenco delle istanze del tuo progetto: 

    gcloud bigtable instances list

  2. 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.

  3. 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

    Fornisci quanto segue:

    • CLUSTER_ID: L'identificatore permanente del cluster.
    • INSTANCE_ID: L'identificatore permanente per l'istanza.

    Il comando accetta flag di scalabilità automatica facoltativi. Puoi utilizzare tutti i flag o solo quelli per i valori che vuoi modificare.

    • AUTOSCALING_MAX_NODES: il numero minimo di nodi.
    • AUTOSCALING_MIN_NODES: il numero massimo di nodi.
    • AUTOSCALING_CPU_TARGET: la percentuale di utilizzo CPU target che Bigtable mantiene 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 che Bigtable mantiene aggiungendo o rimuovendo nodi.

      In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma ci sono eccezioni. Scopri di più sui nodi e sulla replica.

Aggiungere o rimuovere nodi manualmente

Nella maggior parte dei casi, ti consigliamo di attivare la scalabilità automatica. Se scegli di non farlo e la modalità di scalabilità dei nodi del cluster è manuale, puoi aggiungere o rimuovere nodi e il numero di nodi rimane costante finché non lo modifichi di nuovo. Per esaminare le quote di nodi predefinite per zona per Google Cloud progetto, consulta Quote di nodi. Se hai bisogno di eseguire il provisioning di un numero maggiore di nodi rispetto a quello predefinito, puoi richiederne altri.

Per modificare il numero di nodi in un cluster che utilizza lo scaling manuale:

Console

  1. Apri l'elenco delle istanze Bigtable nella console Google Cloud .

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza da modificare, poi fai clic su Modifica istanza.

  3. In Configura cluster, fai clic su Modifica per il cluster che vuoi aggiornare.

  4. 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 ci sono eccezioni. Scopri di più sui nodi e sulla replica.

  5. Fai clic su Salva.

gcloud

  1. Se non conosci l'ID istanza, utilizza il comando bigtable instances list per visualizzare un elenco delle istanze del tuo progetto: 

    gcloud bigtable instances list

  2. 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.

  3. Utilizza il comando bigtable clusters update per modificare il numero di nodi:

    gcloud bigtable clusters update CLUSTER_ID \
    --instance=INSTANCE_ID \
    --num-nodes=NUM_NODES

    Fornisci quanto segue:

    • CLUSTER_ID: L'identificatore permanente del cluster.
    • INSTANCE_ID: L'identificatore permanente per l'istanza.

    • NUM_NODES: Questo campo è facoltativo. Se non viene impostato alcun valore, Bigtable alloca automaticamente i nodi in base all'impronta dei dati e ottimizza l'utilizzo dello spazio di archiviazione al 50%. Se vuoi controllare il numero di nodi in un cluster, aggiorna il valore NUM_NODES. Assicurati che il numero di nodi sia impostato su un valore diverso da zero.

      In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma ci sono eccezioni. Scopri di più sui nodi e sulla replica.

cbt

  1. Se non conosci l'ID istanza, utilizza il comando listinstances per visualizzare un elenco delle istanze del tuo progetto: 

    cbt listinstances

  2. Se non conosci gli ID cluster dell'istanza, utilizza il comando listclusters per visualizzare un elenco di cluster nell'istanza: 

    cbt -instance=INSTANCE_ID listclusters

    Sostituisci INSTANCE_ID con l'identificatore permanente dell'istanza.

  3. Utilizza il comando updatecluster per modificare il numero di nodi:

    cbt -instance=INSTANCE_ID updatecluster CLUSTER_ID NUM_NODES

    Fornisci quanto segue:

    • INSTANCE_ID: L'identificatore permanente per l'istanza.
    • CLUSTER_ID: L'identificatore permanente del cluster.

    • NUM_NODES: Questo campo è facoltativo. Se non viene impostato alcun valore, Bigtable alloca automaticamente i nodi in base all'impronta dei dati e ottimizza l'utilizzo dello spazio di archiviazione al 50%. Se vuoi controllare il numero di nodi in un cluster, aggiorna il valore NUM_NODES. Assicurati che il numero di nodi sia impostato su un valore diverso da zero.

      In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma ci sono 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 un massimo di 8 regioni in cui è disponibile Bigtable. Ogni zona di una regione può contenere un solo cluster. Le posizioni ideali per i 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 posizionare il cluster.

Prima di aggiungere cluster a un'istanza a cluster singolo, leggi le limitazioni che si applicano quando modifichi le norme di Garbage Collection nelle tabelle replicate. Poi, consulta gli esempi di impostazioni della replica per i consigli.

Per aggiungere un cluster a un'istanza:

Console

  1. Apri l'elenco delle istanze Bigtable nella console Google Cloud .

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza da modificare, poi fai clic su Modifica istanza.

  3. Nella sezione Configura cluster, fai clic su Aggiungi cluster.

    Se questo pulsante è disattivato, l'istanza ha già il numero massimo di cluster.

  4. Inserisci un ID cluster per il primo cluster.

    L'ID cluster è un identificatore permanente per il cluster.

  5. Scegli la regione e la zona in cui verrà eseguito il primo cluster.

  6. (Facoltativo) Per configurare il cluster in modo che venga scalato sempre in incrementi di due nodi, seleziona Abilita la scalabilità dei nodi in incrementi di 2. Per saperne di più, consulta Fattore di scalabilità dei nodi.

  7. Scegli una modalità di scalabilità dei nodi per il cluster. Nella maggior parte dei casi, devi scegliere lo scalabilità automatica. Per indicazioni sulla scalabilità, vedi Scalabilità automatica.

    1. Per l'allocazione manuale dei nodi, inserisci il numero di nodi Bigtable per il primo cluster. Se non sai con certezza quanti nodi ti servono, utilizza il valore predefinito. Puoi aggiungere altri nodi in un secondo momento.
    2. 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

  8. (Facoltativo) Per proteggere l'istanza con CMEK anziché con la crittografia predefinita gestita da Google, completa i seguenti passaggi:

    1. Fai clic su Mostra opzioni di crittografia.
    2. Seleziona il pulsante di opzione accanto a Chiave di crittografia gestita dal cliente (CMEK).
    3. Seleziona o inserisci il nome risorsa della chiave CMEK che vuoi utilizzare per il cluster. Non potrai aggiungerlo in un secondo momento.
    4. Se ti viene chiesto di concedere l'autorizzazione al service account della chiave CMEK, fai clic su Concedi. Per completare questa attività, al tuo account utente deve essere concesso il ruolo Amministratore Cloud KMS.
    5. Fai clic su Salva.

  9. Inserisci il numero di nodi per il cluster.

    In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma ci sono eccezioni. Scopri di più sui nodi e sulla replica.

  10. Se l'istanza è protetta da CMEK, seleziona o inserisci una chiave gestita dal cliente. La chiave CMEK deve trovarsi nella stessa regione del cluster.

  11. Fai clic su Aggiungi.

  12. Ripeti questi passaggi per ogni cluster aggiuntivo, poi 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.

  13. Esamina le impostazioni di replica nel profilo app predefinito per verificare se sono adatte al tuo caso d'uso di replica. Potresti dover aggiornare il profilo app predefinito o creare profili app personalizzati.

gcloud

  1. Se non conosci l'ID istanza, utilizza il comando bigtable instances list per visualizzare un elenco delle istanze del tuo progetto: 

    gcloud bigtable instances list

  2. 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.

  3. 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] \

    Fornisci quanto segue:

    • CLUSTER_ID: L'identificatore permanente del cluster.
    • INSTANCE_ID: L'identificatore permanente per l'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 della stessa regione, ad esempio us-east1-c, o in una zona di una regione separata, ad esempio europe-west2-a. Visualizza l'elenco delle zone.

    Il flag --async non è obbligatorio, ma è vivamente consigliato. Senza questo flag, il comando potrebbe scadere 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 in uso dal cluster. Puoi aggiungere cluster CMEK solo a istanze già protette da CMEK.
    • --kms-keyring=KMS_KEYRING: l'ID del keyring KMS per la chiave.
    • --kms-location=KMS_LOCATION: La Google Cloud posizione della chiave.
    • --kms-project=KMS_PROJECT: l' Google Cloud ID progetto per la chiave.
    • --storage-type=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 valori SSD e HDD. Il valore predefinito è SSD.
    • --node-scaling-factor=node-scaling-factor-2x: un flag che attiva lo scaling dei nodi 2x. Puoi abilitare questa funzionalità sia con lo scaling manuale che con la scalabilità automatica.

    Per visualizzare un elenco delle zone Bigtable non disponibili per lo scaling dei nodi 2x, consulta Limitazioni del fattore di scalabilità dei nodi.

    Se non viene impostato alcun valore per l'opzione --num-nodes, Bigtable alloca automaticamente i nodi al cluster in base all'impronta dei dati e ottimizza l'utilizzo dello spazio di archiviazione al 50%. Questa allocazione automatica dei nodi ha un impatto sui prezzi. Se vuoi controllare il numero di nodi in un cluster, aggiorna il valore di NUM_NODES. Assicurati che il numero di nodi sia impostato su un valore diverso da zero. In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma ci sono eccezioni. Scopri di più sui nodi e sulla replica.

    Per la scalabilità automatica, fornisci tutti i flag autoscaling- e non utilizzare num-nodes. Consulta Scalabilità automatica per indicazioni sulla scelta dei valori per le impostazioni di 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 che Bigtable gestisce aggiungendo o rimuovendo nodi.

  4. Esamina le impostazioni di replica nel profilo app predefinito per verificare se sono adatte al tuo caso d'uso di replica. Potresti dover aggiornare il profilo app predefinito o creare profili app personalizzati.

cbt

  1. Se non conosci l'ID istanza, utilizza il comando listinstances per visualizzare un elenco delle istanze del tuo progetto: 

    cbt listinstances

  2. Se non conosci gli ID cluster dell'istanza, utilizza il comando listclusters per visualizzare un elenco di cluster nell'istanza: 

    cbt -instance=INSTANCE_ID listclusters

    Sostituisci INSTANCE_ID con l'identificatore permanente dell'istanza.

  3. 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 per l'istanza.
    • 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 della stessa regione, ad esempio us-east1-c, o in una zona di una regione separata, ad esempio europe-west2-a. Visualizza l'elenco delle zone.

    • NUM_NODES: Questo campo è facoltativo. Se non viene impostato alcun valore, Bigtable alloca automaticamente i nodi in base all'impronta dei dati e ottimizza l'utilizzo dello spazio di archiviazione al 50%. Se vuoi controllare il numero di nodi in un cluster, aggiorna il valore NUM_NODES. Assicurati che il numero di nodi sia impostato su un valore diverso da zero.

      In molti casi, ogni cluster in un'istanza deve avere lo stesso numero di nodi, ma ci sono eccezioni. Scopri di più sui nodi e sulla 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 valori SSD e HDD.

  4. Esamina le impostazioni di replica nel profilo app predefinito per verificare se sono adatte al tuo caso d'uso di replica. Potresti dover aggiornare il profilo app predefinito o creare profili app personalizzati.

Elimina un cluster

Se un'istanza ha più cluster, puoi eliminarli tutti tranne uno. L'eliminazione di tutti i cluster tranne uno disattiva automaticamente la replica.

In alcuni casi, Bigtable non ti consente di eliminare un cluster:

  • Se uno dei tuoi profili dell'applicazione instrada tutto il traffico a un singolo cluster, Bigtable non ti consentirà 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 quell'istanza finché non viene completata la copia iniziale dei dati nei nuovi cluster.

Per eliminare un cluster da un'istanza:

Console

  1. Apri l'elenco delle istanze Bigtable nella console Google Cloud .

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza da modificare, poi fai clic su Modifica istanza.

  3. In Configura cluster, fai clic su Elimina cluster per il cluster che vuoi eliminare.

  4. Per annullare l'operazione di eliminazione, fai clic su Annulla, disponibile finché non fai clic su Salva. In caso contrario, fai clic su Salva.

gcloud

  1. Se non conosci l'ID istanza, utilizza il comando bigtable instances list per visualizzare un elenco delle istanze del tuo progetto: 

    gcloud bigtable instances list

  2. 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.

  3. Utilizza il comando bigtable clusters delete per eliminare il cluster:

    gcloud bigtable clusters delete CLUSTER_ID \
    --instance=INSTANCE_ID

    Fornisci quanto segue:

    • CLUSTER_ID: L'identificatore permanente del cluster.
    • INSTANCE_ID: L'identificatore permanente per l'istanza.

cbt

  1. Se non conosci l'ID istanza, utilizza il comando listinstances per visualizzare un elenco delle istanze del tuo progetto: 

    cbt listinstances

  2. Se non conosci gli ID cluster dell'istanza, utilizza il comando listclusters per visualizzare un elenco di cluster nell'istanza: 

    cbt -instance=INSTANCE_ID listclusters

    Sostituisci INSTANCE_ID con l'identificatore permanente dell'istanza.

  3. Utilizza il comando deletecluster per eliminare il cluster:

    cbt -instance=INSTANCE_ID deletecluster CLUSTER_ID

    Fornisci quanto segue:

    • INSTANCE_ID: L'identificatore permanente per l'istanza.
    • CLUSTER_ID: L'identificatore permanente del 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 spostarti e poi elimina il cluster nella località da cui vuoi spostarti. Il cluster eliminato rimane disponibile finché i dati non vengono replicati nel nuovo cluster, quindi non devi preoccuparti di eventuali richieste non riuscite. Bigtable replica automaticamente tutti i dati nel nuovo cluster.

Gestire i profili delle app

I profili dell'applicazione, o profili app, controllano la modalità di connessione delle applicazioni 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 dell'app personalizzati diversi per ogni istanza, utilizzando un profilo dell'app diverso per ogni tipo di applicazione in esecuzione.

Per scoprire come configurare i profili app di un'istanza, vedi Configurazione dei profili app. Per esempi di impostazioni che puoi utilizzare per implementare casi d'uso comuni, vedi Esempi di configurazioni di replica.

Gestisci etichette

Le etichette sono coppie chiave-valore che puoi utilizzare per raggruppare le istanze correlate e archiviare i metadati di un'istanza.

Per scoprire come gestire le etichette, consulta Aggiunta o aggiornamento delle etichette di un'istanza e Rimozione di un'etichetta da un'istanza.

Modificare il nome visualizzato di un'istanza

Per modificare il nome visualizzato di un'istanza, che la console Google Cloud utilizza per identificare l'istanza:

Console

  1. Apri l'elenco delle istanze Bigtable nella console Google Cloud .

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza da modificare, poi fai clic su Modifica istanza.

  3. Modifica il nome dell'istanza e fai clic su Salva.

gcloud

  1. Se non conosci l'ID istanza, utilizza il comando bigtable instances list per visualizzare un elenco delle istanze del tuo progetto: 

    gcloud bigtable instances list

  2. Utilizza il comando bigtable instances update per aggiornare il nome visualizzato:

    gcloud bigtable instances update INSTANCE_ID \
    --display-name=DISPLAY_NAME

    Fornisci quanto segue:

    • INSTANCE_ID: L'identificatore permanente per l'istanza.
    • DISPLAY_NAME: Un nome leggibile da una persona che identifica l'istanza nella console Google Cloud .

cbt

Questa funzionalità non è disponibile nella CLI di cbt.

Passaggi successivi