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.

  • Livello in memoria (anteprima)

    Puoi abilitare o disabilitare 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à attiva.

  • Il numero di nodi nei cluster con scalabilità manuale

    Dopo aver aggiunto o rimosso 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, Bigtable impiega un po' di tempo per replicare 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 dell'applicazione per l'istanza, che contengono le impostazioni di replica

  • La posizione dei tuoi dati

  • Le etichette dell'istanza, che forniscono metadati sull'istanza

  • Il nome visualizzato dell'istanza

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

Per modificare una delle seguenti impostazioni, devi creare una nuova istanza con le impostazioni che preferisci, esportare i dati dall'istanza precedente, importare i dati nella nuova istanza e poi eliminare l'istanza precedente.

  • 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 l' interfaccia a riga di comando cbt , se non l'hai ancora fatto.

Cambia 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 avrai accesso immediato alle funzionalità di Enterprise Plus.

Console

  1. Nella console Google Cloud , apri l'elenco delle istanze Bigtable.

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza Enterprise di cui vuoi eseguire l'upgrade, quindi su Modifica istanza.

  3. Nella sezione Versione, seleziona Enterprise Plus.

  4. Fai clic su Salva.

  5. (Facoltativo) Attiva il livello in memoria.

gcloud

Utilizza il comando bigtable instances update per cambiare la versione:

gcloud bigtable instances update INSTANCE_ID \
    --edition=ENTERPRISE_PLUS

Fornisci quanto segue:

  • INSTANCE_ID: l'identificatore permanente dell'istanza.

Esegui il downgrade a Enterprise

Per eseguire il downgrade da Enterprise Plus a Enterprise, devi disattivare le funzionalità esclusive di Enterprise Plus. Ad esempio, se l'istanza contiene tabelle con granularità del timestamp in microsecondi, devi eliminarle prima di poter eseguire il downgrade alla versione Enterprise.

Dopo aver creato un'istanza Enterprise Plus o aver eseguito l'upgrade di un'istanza esistente a Enterprise Plus, non puoi eseguire il downgrade alla versione Enterprise per 48 ore.

Una volta modificata la versione, Bigtable aggiorna automaticamente la fatturazione e perdi l'accesso alle funzionalità di Enterprise Plus.

Console

  1. Nella console Google Cloud , apri l'elenco delle istanze Bigtable.

    Apri l'elenco delle istanze

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

  3. Nella sezione Versione, seleziona Enterprise.

  4. Fai clic su Salva.

gcloud

Utilizza il comando bigtable instances update per cambiare la versione:

gcloud bigtable instances update INSTANCE_ID \
    --edition=ENTERPRISE

Fornisci quanto segue:

  • INSTANCE_ID: l'identificatore permanente dell'istanza.

Configura il livello in memoria

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

Ruoli obbligatori

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

Questo ruolo predefinito contiene le autorizzazioni richieste da Bigtable per utilizzare il livello in-memory. 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ù sui ruoli e sulle autorizzazioni di 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 saperne di più, consulta la panoramica del livello in-memory.

Console

  1. Nella console Google Cloud , apri l'elenco delle istanze Bigtable.

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza Enterprise che vuoi aggiornare, quindi su Modifica istanza.

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

  4. Seleziona Abilita in memoria.

  5. Fai clic su Salva.

gcloud

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 dell'istanza.

Disattiva il livello in memoria

Prima di eseguire il downgrade da Enterprise Plus a Enterprise, devi disabilitare il livello in-memory.

Console

  1. Nella console Google Cloud , apri l'elenco delle istanze Bigtable.

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza Enterprise che vuoi aggiornare, quindi su Modifica istanza.

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

  4. Deseleziona Abilita in memoria.

  5. Fai clic su Salva.

gcloud

Per disattivare il livello in-memory 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 dell'istanza.

Ottieni un elenco di cluster con il livello in-memory

Console

Per visualizzare i cluster con il livello in memoria abilitato nella pagina di riepilogo dell'istanza, segui questi passaggi:

  1. Nella console Google Cloud , apri l'elenco delle istanze Bigtable.

    Apri l'elenco delle istanze

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

  3. Nella tabella in cluster, visualizza la colonna Livello in memoria.

gcloud

Per elencare i cluster con il livello in memoria abilitato su un'istanza, utilizza il comando gcloud beta bigtable memory-layers list.

gcloud beta bigtable memory-layers list \
    --instance=INSTANCE_ID

Fornisci quanto segue:

  • INSTANCE_ID: l'identificatore permanente dell'istanza.

Visualizza le informazioni sul livello in memoria

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

Console

  1. Nella console Google Cloud , apri l'elenco delle istanze Bigtable.

    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 memoria del tuo cluster.

gcloud

Per visualizzare le informazioni sul livello in-memory di un cluster, ad esempio lo stato del livello in-memory, 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 dell'istanza.

Configura scalabilità automatica

Puoi attivare o disattivare la scalabilità automatica per qualsiasi cluster esistente. Puoi anche modificare l'utilizzo della CPU target, 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. Nella console Google Cloud , apri l'elenco delle istanze Bigtable.

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza che vuoi modificare, quindi 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 i seguenti campi:

    • 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 progetto: 

    gcloud bigtable instances list

  2. Se non conosci gli ID cluster dell'istanza, utilizza il comando bigtable clusters list per visualizzare un elenco di 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 dell'istanza.
    • AUTOSCALING_MAX_NODES: il numero minimo di nodi
    • AUTOSCALING_MIN_NODES: il numero massimo di nodi
    • AUTOSCALING_CPU_TARGET: la percentuale target di utilizzo della CPU che Bigtable mantiene aggiungendo o rimuovendo nodi. Questo valore deve essere compreso tra 10 e 80.

    • AUTOSCALING_STORAGE_TARGET: L'obiettivo di utilizzo dello spazio di archiviazione in GiB per nodo che Bigtable mantiene aggiungendo o rimuovendo nodi

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

Disattiva la scalabilità automatica

Console

  1. Nella console Google Cloud , apri l'elenco delle istanze Bigtable.

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza che vuoi modificare, quindi su Modifica istanza.

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

  4. Seleziona Allocazione manuale dei nodi.

  5. Inserisci il numero di nodi del cluster nel campo Quantità.

    In molti casi, ogni cluster di un'istanza deve avere lo stesso numero di nodi, ma esistono delle 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 progetto: 

    gcloud bigtable instances list

  2. Se non conosci gli ID cluster dell'istanza, utilizza il comando bigtable clusters list per visualizzare un elenco di 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 disattivare 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 dell'istanza.

    • NUM_NODES: Questo campo è facoltativo. Se non viene impostato alcun valore, Bigtable alloca automaticamente i nodi in base all'impatto 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 di un'istanza deve avere lo stesso numero di nodi, ma esistono delle eccezioni. Scopri di più sui nodi e sulla replica.

Modifica le impostazioni di scalabilità automatica

Console

  1. Nella console Google Cloud , apri l'elenco delle istanze Bigtable.

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza che vuoi modificare, quindi su Modifica istanza.

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

  4. Inserisci nuovi valori per gli attributi 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 progetto: 

    gcloud bigtable instances list

  2. Se non conosci gli ID cluster dell'istanza, utilizza il comando bigtable clusters list per visualizzare un elenco di 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 dell'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 target di utilizzo della CPU 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 di un'istanza deve avere lo stesso numero di nodi, ma esistono delle eccezioni. Scopri di più sui nodi e sulla replica.

Aggiungi o rimuovi i 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 tuo cluster è manuale, puoi aggiungere o rimuovere nodi e il numero di nodi rimane costante finché non lo modifichi di nuovo. Per esaminare le quote dei nodi predefinite per zona per progetto Google Cloud , consulta Quote dei nodi. Se devi eseguire il provisioning di più nodi rispetto al valore predefinito, puoi richiederne altri.

Per modificare il numero di nodi in un cluster che utilizza la scalabilità manuale:

Console

  1. Nella console Google Cloud , apri l'elenco delle istanze Bigtable.

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza che vuoi modificare, quindi 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 di un'istanza deve avere lo stesso numero di nodi, ma esistono delle 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 progetto: 

    gcloud bigtable instances list

  2. Se non conosci gli ID cluster dell'istanza, utilizza il comando bigtable clusters list per visualizzare un elenco di 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 dell'istanza.

    • NUM_NODES: Questo campo è facoltativo. Se non viene impostato alcun valore, Bigtable alloca automaticamente i nodi in base all'impatto 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 di un'istanza deve avere lo stesso numero di nodi, ma esistono delle 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 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 dell'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'impatto 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 di un'istanza deve avere lo stesso numero di nodi, ma esistono delle 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 Bigtable è disponibile. Ogni zona di una regione può contenere un solo cluster. Le località ideali per i cluster aggiuntivi dipendono dal tuo caso d'uso.

Se l'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 con un singolo cluster, leggi le limitazioni che si applicano quando modifichi le policy di garbage collection sulle tabelle replicate. Quindi, consulta gli esempi di impostazioni di replica per i consigli.

Per aggiungere un cluster a un'istanza:

Console

  1. Nella console Google Cloud , apri l'elenco delle istanze Bigtable.

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza che vuoi modificare, quindi su Modifica istanza.

  3. In Configura i cluster, fai clic su Aggiungi cluster.

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

  4. Inserisci un ID cluster per il primo cluster.

    L'ID cluster è un identificatore permanente del cluster.

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

  6. (Facoltativo) Per configurare il cluster in modo che lo scale out avvenga 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, dovresti scegliere la scalabilità automatica. Per indicazioni sulla scalabilità, consulta Scalabilità automatica.

    1. In 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. In Scalabilità automatica, inserisci i valori per i seguenti campi:
      • 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 della risorsa per la chiave CMEK che vuoi utilizzare per il cluster. Non puoi 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 del cluster.

    In molti casi, ogni cluster di un'istanza deve avere lo stesso numero di nodi, ma esistono delle 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, 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.

  13. 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 dell'app personalizzati.

gcloud

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

    gcloud bigtable instances list

  2. Se non conosci gli ID cluster dell'istanza, utilizza il comando bigtable clusters list per visualizzare un elenco di 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 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 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 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 Google Cloud posizione della chiave.
    • --kms-project=KMS_PROJECT: l'ID progetto Google Cloud per la chiave.
    • --storage-type=STORAGE_TYPE: il tipo di archiviazione da utilizzare per il cluster. Ogni cluster di 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 la scalabilità dei nodi 2x. Puoi attivare questa funzionalità sia con la scalabilità manuale sia con la scalabilità automatica.

    Per visualizzare un elenco delle zone Bigtable non disponibili per la scalabilità 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 NUM_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ù sui nodi e sulla replica.

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

  4. 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 dell'app personalizzati.

cbt

  1. Se non conosci l'ID istanza, utilizza il comando listinstances per visualizzare un elenco delle istanze del 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 dell'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'impatto 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 di un'istanza deve avere lo stesso numero di nodi, ma esistono delle eccezioni. Scopri di più sui nodi e sulla replica.

    • STORAGE_TYPE: il tipo di archiviazione da utilizzare per il cluster. Ogni cluster di un'istanza deve utilizzare lo stesso tipo di archiviazione. Accetta i valori SSD e HDD.

  4. 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 dell'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.

Bigtable non consente di eliminare un cluster nei seguenti casi:

  • Se uno dei tuoi profili dell'applicazione instrada tutto il traffico a un singolo 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.
  • Se un cluster contiene uno o più backup. Per eliminare il cluster, devi eliminare i backup o attendere che scadano.
  • Se un cluster è configurato come località in una policy di backup automatico di una tabella. Per eliminare il cluster, devi prima aggiornare la policy di backup automatico.

Per eliminare un cluster da un'istanza:

Console

  1. Nella console Google Cloud , apri l'elenco delle istanze Bigtable.

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza che vuoi modificare, quindi su Modifica istanza.

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

  4. Per annullare l'operazione di eliminazione, fai clic su Annulla, che è 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 progetto: 

    gcloud bigtable instances list

  2. Se non conosci gli ID cluster dell'istanza, utilizza il comando bigtable clusters list per visualizzare un elenco di 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 dell'istanza.

cbt

  1. Se non conosci l'ID istanza, utilizza il comando listinstances per visualizzare un elenco delle istanze del 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 dell'istanza.
    • CLUSTER_ID: l'identificatore permanente del cluster.

Sposta i dati in una nuova località

Per spostare i dati di un'istanza Bigtable in una nuova zona o regione, aggiungi un nuovo cluster nella località in cui vuoi spostarli, quindi elimina il cluster nella località da cui vuoi spostarli. Il cluster eliminato rimane disponibile fino a quando 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.

Gestisci i profili app

I profili dell'applicazione, o profili dell'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 dell'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 che esegui.

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

Gestisci etichette

Le etichette sono coppie chiave-valore che puoi utilizzare per raggruppare 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.

Modifica il nome visualizzato di un'istanza

Per modificare il nome visualizzato di un'istanza, utilizzato dalla console Google Cloud per identificare l'istanza:

Console

  1. Nella console Google Cloud , apri l'elenco delle istanze Bigtable.

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza che vuoi modificare, quindi su Modifica istanza.

  3. Modifica il nome dell'istanza, quindi 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 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 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