Creazione e configurazione di profili di app

Nota: questo documento include funzionalità disponibili solo nella versione Enterprise Plus. Per saperne di più, consulta Panoramica delle versioni.

I profili dell'applicazione Bigtable (profili dell'app) consentono di specificare policy di routing, opzioni di computing e impostazioni di isolamento dei workload per le richieste client in entrata. Puoi indirizzare il traffico tra i nodi del cluster di cui è stato eseguito il provisioning, eseguire letture isolate con throughput elevato utilizzando il serverless computing di Data Boost o indirizzare i punti del percorso a un livello in memoria (anteprima) sulle istanze Enterprise Plus.

Prima di iniziare

Prima di creare o configurare un profilo dell'app, leggi la seguente documentazione:

• Leggi la panoramica dei profili app per scoprire come funzionano i profili app e la differenza tra un profilo app standard per il computing standard e un profilo app Data Boost per i job di lettura con throughput elevato serverless. Per saperne di più sulle differenze tra Data Boost e il computing che utilizza i nodi del cluster di cui è stato eseguito il provisioning, consulta la panoramica di Bigtable Data Boost.
• Se utilizzi profili app standard per configurare la replica, leggi la panoramica della replica e gli esempi di configurazioni di replica per decidere quali impostazioni sono più adatte al tuo caso d'uso.
• Se utilizzi un profilo dell'app di livello in memoria, leggi la panoramica del livello in memoria.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare, configurare o eliminare un profilo dell'app, chiedi all'amministratore di concederti il ruolo IAM Bigtable Administrator (roles/bigtable.admin) sull'istanza. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea un profilo dell'app

Puoi creare molti profili app personalizzati diversi per ogni istanza. Utilizza i profili app personalizzati per controllare il modo in cui ogni applicazione o ogni funzione distinta all'interno di un'applicazione interagisce con un'istanza. Ad esempio, puoi utilizzare un profilo dell'app per un'applicazione batch per isolare il traffico in un singolo cluster e un profilo dell'app diverso per fornire alta affidabilità per un'altra applicazione.

Crea un profilo dell'app standard

Per creare un profilo dell'app standard, segui questi passaggi:

Console

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

   Apri l'elenco delle istanze

2. Fai clic sull'istanza in cui vuoi creare il profilo dell'app.

3. Nel riquadro a sinistra, fai clic su Profili applicazione.

4. Fai clic su Crea profilo dell'applicazione.

5. Seleziona Standard.

6. Fai clic su Avanti.

7. Inserisci l'ID del profilo dell'applicazione.

   L'ID profilo dell'applicazione è un identificatore permanente del profilo dell'app. La tua applicazione fornisce questo ID quando si connette a Bigtable.

8. Inserisci una descrizione del profilo dell'app.

9. In Routing dei cluster, seleziona Routing a cluster singolo o Routing a cluster multipli. Scopri di più.

10. Se scegli Cluster singolo:

    1. Nell'elenco Cluster, seleziona il cluster a cui indirizzare le richieste.

    2. Se devi attivare le transazioni su riga singola, seleziona la casella di controllo Consenti transazioni su riga singola.

11. Se scegli Multi-cluster:

    1. Nell'elenco Gruppo di cluster, per instradare le richieste a qualsiasi cluster nell'istanza, seleziona Qualsiasi cluster.
    2. Per limitare il routing delle richieste solo ad alcuni cluster nell'istanza (routing dei gruppi di cluster), seleziona ogni cluster che vuoi includere nel gruppo di routing, quindi fai clic su OK.
    3. Per indirizzare le richieste di lettura e scrittura a riga singola a un cluster specifico in base alla chiave di riga della richiesta, seleziona Abilita affinità delle righe.

12. In Seleziona una priorità di routing, assegna una priorità di routing alle tue richieste selezionando una delle seguenti opzioni:

    • Alta: da utilizzare per le richieste sensibili alla latenza
    • Media: da utilizzare per richieste di uso generico
    • Bassa: da utilizzare per attività in background o operazioni meno urgenti

13. Per creare il profilo dell'app, fai clic su Crea.

14. Aggiorna il codice dell'applicazione per la connessione a Bigtable in modo che utilizzi il nuovo profilo dell'app.

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 app-profiles create per creare un profilo dell'app:

   gcloud bigtable app-profiles create APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       [--description=DESCRIPTION] \
       [--force] \
       [--route-any] \
       [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...] \
       [--route-to=CLUSTER_ID] \
       [--transactional-writes] \
       [--priority=PRIORITY] \
       [--row-affinity]
   

   Fornisci quanto segue:

   • APP_PROFILE_ID: L'identificatore permanente del profilo dell'app.
   • INSTANCE_ID: l'identificatore permanente dell'istanza

   Il comando accetta i seguenti flag facoltativi:

   • --description=DESCRIPTION: Una descrizione dettagliata del profilo dell'app.
   • --force: ignora gli avvisi relativi a potenziali problemi e conflitti con altri profili di app.

   • --route-any: Abilita il routing multi-cluster per instradare le richieste a qualsiasi cluster disponibile.

     Non puoi combinare questo flag con i flag --route-to o --transactional-writes.

   • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: un elenco di cluster a cui devono essere indirizzate le richieste. Utilizza questa opzione se vuoi instradare le richieste solo ad alcuni cluster dell'istanza.

     Non puoi combinare questo flag con i flag --route-to o --transactional-writes.

   • --route-to=CLUSTER_ID: l'ID cluster a cui devono essere indirizzate tutte le richieste. Questo flag attiva il routing a un cluster singolo.

     Non puoi combinare questo flag con il flag --route-any.

   • --transactional-writes: Attiva le transazioni su una singola riga nel profilo dell'app.

     Non puoi combinare questo flag con i flag --route-any o --restrict-to.

   • --priority=PRIORITY: il livello di priorità che il profilo dell'app deve utilizzare. I valori accettati sono PRIORITY_HIGH, PRIORITY_MEDIUM o PRIORITY_LOW.

   • --row-affinity: attiva il routing di affinità delle righe nel profilo dell'app.

     Non puoi combinare questo flag con i flag --route-to o --transactional-writes.

3. Aggiorna il codice dell'applicazione per la connessione a Bigtable in modo che utilizzi il nuovo profilo dell'app.

Crea un profilo dell'applicazione di livello in memoria

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Per creare un profilo dell'app su un cluster con il livello in-memory abilitato, segui questi passaggi:

Nota: non puoi abilitare il routing con affinità delle righe per un profilo dell'app con 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 in cui vuoi creare il profilo dell'app.

3. Nel riquadro a sinistra, fai clic su Profili applicazione.

4. Fai clic su Crea profilo dell'applicazione.

5. Seleziona Livello in memoria.

6. Fai clic su Avanti.

7. Inserisci l'ID del profilo dell'applicazione.

   L'ID profilo dell'applicazione è un identificatore permanente del profilo dell'app. La tua applicazione fornisce questo ID quando si connette a Bigtable.

8. Inserisci una descrizione del profilo dell'app.

9. In Routing dei cluster, seleziona un cluster con il livello in memoria abilitato.

   I cluster di livello in memoria devono utilizzare il routing a un cluster singolo.

10. Se devi attivare le transazioni su riga singola, seleziona Consenti transazioni su riga singola.

11. In Seleziona una priorità di routing, assegna una priorità di routing alle tue richieste selezionando una delle seguenti opzioni:

    • Alta: da utilizzare per le richieste sensibili alla latenza
    • Media: da utilizzare per richieste di uso generico
    • Bassa: da utilizzare per attività in background o operazioni meno urgenti

12. Fai clic su Crea per creare il profilo dell'app.

13. Aggiorna il codice dell'applicazione per la connessione a Bigtable in modo che utilizzi il nuovo profilo dell'app.

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 gcloud beta bigtable app-profiles create per creare un profilo dell'app:

   gcloud beta bigtable app-profiles create APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       --route-to=CLUSTER_ID \
       --use-memory-layer \
       [--description=DESCRIPTION] \
       [--transactional-writes] \
       [--priority=PRIORITY]
   

   Fornisci quanto segue:

   • APP_PROFILE_ID: L'identificatore permanente del profilo dell'app.
   • INSTANCE_ID: l'identificatore permanente dell'istanza

   Il comando accetta i seguenti flag facoltativi:

   • --route-to=CLUSTER_ID: l'ID cluster a cui devono essere indirizzate tutte le richieste. Questo flag attiva il routing a un cluster singolo.
   • --use-memory-layer: instrada le richieste con questo profilo dell'app al livello in memoria. Questo flag è limitato alla versione Enterprise Plus e al routing a cluster singolo.
   • --description=DESCRIPTION: Una descrizione dettagliata del profilo dell'app.
   • --transactional-writes: Attiva le transazioni su una singola riga nel profilo dell'app.
   • --priority=PRIORITY: il livello di priorità delle richieste inviate utilizzando il profilo dell'app. I valori accettati sono PRIORITY_HIGH, PRIORITY_MEDIUM o PRIORITY_LOW. Le priorità delle richieste non influiscono sulle richieste idonee per il livello in memoria.

3. Aggiorna il codice dell'applicazione per la connessione a Bigtable in modo che utilizzi il nuovo profilo dell'app.

Crea un profilo dell'app Data Boost

Per creare un profilo dell'app Data Boost, ovvero un profilo dell'app che utilizza il serverless computing di Data Boost, segui questi passaggi. Per assicurarti che il tuo workload sia compatibile con Data Boost, consulta le limitazioni.

Nota: Per utilizzare le funzionalità avanzate di Data Boost, l'istanza deve utilizzare l'edizione Enterprise Plus.

Console

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

   Apri l'elenco delle istanze

2. Fai clic sull'istanza in cui vuoi creare il profilo dell'app.

3. Nel riquadro a sinistra, fai clic su Profili applicazione.

4. Fai clic su Crea profilo dell'applicazione.

5. Seleziona Data Boost.

6. Fai clic su Avanti.

7. Inserisci l'ID del profilo dell'applicazione.

   L'ID profilo dell'applicazione è un identificatore permanente del profilo dell'app. La tua applicazione fornisce questo ID quando si connette a Bigtable.

8. Inserisci una descrizione del profilo dell'app.

9. In Routing al cluster, seleziona il cluster a cui indirizzare le richieste.

10. Fai clic su Crea profilo app per creare il profilo dell'app.

11. Aggiorna il codice dell'applicazione per la connessione a Bigtable in modo che utilizzi il nuovo profilo dell'app.

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 gcloud beta bigtable app-profiles create per creare un profilo dell'app:

   gcloud bigtable app-profiles create APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       --data-boost \
       --data-boost-compute-billing-owner=HOST_PAYS \
       --route-to=CLUSTER_ID
   

   Fornisci quanto segue:

   • APP_PROFILE_ID: L'identificatore permanente del profilo dell'app.
   • INSTANCE_ID: l'identificatore permanente dell'istanza
   • CLUSTER_ID: l'ID cluster a cui devono essere indirizzate tutte le richieste. Questo flag attiva il routing a un cluster singolo.

Connettiti con un profilo dell'app personalizzato

Dopo aver creato un profilo dell'app personalizzato, puoi aggiornare il codice in modo che l'applicazione utilizzi il profilo dell'app quando si connette a Bigtable.

Gli esempi seguenti mostrano come specificare un profilo dell'app quando l'app crea un client Bigtable e si connette a un'istanza. Sostituisci [APP_PROFILE_ID] con il valore appropriato.

C#

var client = BigtableClient.Create(appProfileId: "[APP_PROFILE_ID]");

Vai

clientConf := bigtable.ClientConfig{AppProfile:"[APP_PROFILE_ID]"}
client, err = bigtable.NewClientWithConfig(ctx, project, instance, clientConf)

HBase Java

// If using BigtableOptions directly:
optionsBuilder.setAppProfileId("[APP_PROFILE_ID]");

// If using BigtableOptionsFactory:
configuration.set(BigtableOptionsFactory.APP_PROFILE_ID_KEY, "[APP_PROFILE_ID]");

// If using system properties, set "google.bigtable.app_profile.id" to
// "[APP_PROFILE_ID]"

// If using CloudBigtableIO for Cloud Dataflow:
config.withConfiguration(BigtableOptionsFactory.APP_PROFILE_ID_KEY,
                         "[APP_PROFILE_ID]");

Node.js

const bigtable = new Bigtable({appProfileId: '[APP_PROFILE_ID]'});

Python

from google.cloud import bigtable

client = bigtable.Client(project=project_id)
instance = client.instance(instance_id)
table = bigtable.table.Table(table_id, instance, '[APP_PROFILE_ID]')

Aggiorna un profilo dell'app

Puoi visualizzare i profili app di un'istanza e aggiornare le relative impostazioni in qualsiasi momento. Bigtable ti avvisa di eventuali aggiornamenti che potrebbero causare modifiche impreviste al comportamento.

Importante: le modifiche a un profilo dell'app hanno effetto immediato e si applicano a qualsiasi applicazione che utilizza il profilo dell'app. Se devi apportare modifiche che non devono avere effetto immediato, crea un nuovo profilo dell'app e aggiorna l'applicazione in modo che utilizzi il nuovo profilo dell'app per connettersi a Bigtable.

Per scoprire come aggiornare un profilo dell'app da standard a Data Boost o da Data Boost a standard, consulta Converti un profilo dell'app.

Aggiorna un profilo dell'app standard

Per aggiornare un profilo dell'app standard, segui questi passaggi:

Console

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

   Apri l'elenco delle istanze

2. Fai clic sull'istanza con il profilo dell'app che vuoi aggiornare.

3. Nel riquadro a sinistra, fai clic su Profili applicazione.

4. Fai clic su Modifica profilo applicazione per il profilo dell'applicazione che vuoi aggiornare.

5. Aggiorna le impostazioni in base alle esigenze.

6. Fai clic su Salva o, per uscire senza salvare, su Annulla.

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 l'ID del profilo dell'app, utilizza il comando bigtable app-profiles list per visualizzare un elenco dei profili dell'app dell'istanza:

   gcloud bigtable app-profiles list --instance=INSTANCE_ID
   

   Sostituisci INSTANCE_ID con l'identificatore permanente dell'istanza.

3. (Facoltativo) Utilizza il comando bigtable app-profiles describe per visualizzare le impostazioni del profilo dell'app:

   gcloud bigtable app-profiles describe APP_PROFILE_ID \
       --instance=INSTANCE_ID
   

   Fornisci quanto segue:

   • APP_PROFILE_ID: L'identificatore permanente del profilo dell'app.
   • INSTANCE_ID: l'identificatore permanente dell'istanza

4. Utilizza il comando bigtable app-profiles update per aggiornare le impostazioni del profilo dell'app:

   gcloud bigtable app-profiles update APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       [--description=DESCRIPTION] \
       [--force] \
       [--route-any] \
       [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...]
       [--route-to=CLUSTER_ID] \
       [--transactional-writes] \
       [--row-affinity]
   

   Fornisci quanto segue:

   • APP_PROFILE_ID: L'identificatore permanente del profilo dell'app.
   • INSTANCE_ID: l'identificatore permanente dell'istanza

   Il comando accetta i seguenti flag facoltativi:

   • --description=DESCRIPTION: Una descrizione dettagliata del profilo dell'app.
   • --force: ignora gli avvisi relativi a potenziali problemi e conflitti con altri profili di app.

   • --route-any: Abilita il routing multi-cluster per instradare le richieste a qualsiasi cluster disponibile.

     Non puoi combinare questo flag con i flag --route-to o --transactional-writes.

   • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: un elenco di cluster a cui devono essere indirizzate le richieste. Utilizza questa opzione se vuoi instradare le richieste solo ad alcuni cluster dell'istanza.

     Non puoi combinare questo flag con i flag --route-to o --transactional-writes.

   • --route-to=CLUSTER_ID: l'ID cluster a cui devono essere indirizzate tutte le richieste. Questo flag attiva il routing a un cluster singolo.

     Non puoi combinare questo flag con il flag --route-any.

   • --transactional-writes: Attiva le transazioni su una singola riga nel profilo dell'app.

     Non puoi combinare questo flag con il flag --route-any.

   • --priority=PRIORITY: il livello di priorità utilizzato dal profilo dell'app. I valori accettati sono PRIORITY_HIGH, PRIORITY_MEDIUM o PRIORITY_LOW.

Aggiorna un profilo dell'app con livello in memoria

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Per aggiornare un profilo dell'app su un cluster con il livello in memoria abilitato, segui questi passaggi:

Console

Nota: non puoi abilitare il routing con affinità di riga per un profilo dell'app con livello in-memory nella console Google Cloud .

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

   Apri l'elenco delle istanze

2. Fai clic sull'istanza con il profilo dell'app che vuoi aggiornare.

3. Nel riquadro a sinistra, fai clic su Profili applicazione.

4. Fai clic su Modifica profilo applicazione per il profilo dell'applicazione che vuoi aggiornare.

5. Aggiorna le impostazioni in base alle esigenze.

6. Fai clic su Salva o, per uscire senza salvare, su Annulla.

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 l'ID del profilo dell'app, utilizza il comando bigtable app-profiles list per visualizzare un elenco dei profili dell'app dell'istanza:

   gcloud bigtable app-profiles list --instance=INSTANCE_ID
   

   Sostituisci INSTANCE_ID con l'identificatore permanente dell'istanza.

3. (Facoltativo) Utilizza il comando gcloud bigtable app-profiles describe per visualizzare le impostazioni del profilo dell'app:

   gcloud bigtable app-profiles describe APP_PROFILE_ID \
       --instance=INSTANCE_ID
   

   Fornisci quanto segue:

   • APP_PROFILE_ID: L'identificatore permanente del profilo dell'app.
   • INSTANCE_ID: l'identificatore permanente dell'istanza

4. Utilizza il comando gcloud beta bigtable app-profiles update per aggiornare le impostazioni del profilo dell'app:

   gcloud beta bigtable app-profiles update APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       --route-to=CLUSTER_ID \
       [--description=DESCRIPTION] \
       [--transactional-writes] \
       [--priority=PRIORITY] \
       [--use-memory-layer] \
       [--no-use-memory-layer]
   

   Fornisci quanto segue:

   • APP_PROFILE_ID: L'identificatore permanente del profilo dell'app.
   • INSTANCE_ID: l'identificatore permanente dell'istanza

   Il comando accetta i seguenti flag facoltativi:

   • --description=DESCRIPTION: Una descrizione dettagliata del profilo dell'app.
   • --route-to=CLUSTER_ID: l'ID cluster a cui devono essere indirizzate tutte le richieste. Questo flag attiva il routing a un cluster singolo.
   • --transactional-writes: Attiva le transazioni su una singola riga nel profilo dell'app.
   • --priority=PRIORITY: il livello di priorità utilizzato dal profilo dell'app. I valori accettati sono PRIORITY_HIGH, PRIORITY_MEDIUM o PRIORITY_LOW.
   • --use-memory-layer: instrada le richieste con questo profilo dell'app al livello in memoria. Utilizza --no-use-memory-layer per disattivare il routing del livello in memoria per questo profilo dell'app. Questo flag è limitato alla versione Enterprise Plus e al routing a cluster singolo.

Aggiorna un profilo dell'app Data Boost

Per aggiornare il cluster da cui un profilo dell'app Data Boost legge i dati, segui questi passaggi:

Console

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

   Apri l'elenco delle istanze

2. Nella colonna Profili applicazione, fai clic sul profilo dell'applicazione che vuoi visualizzare o aggiornare.

   Se non vedi il profilo dell'app che vuoi modificare, puoi visualizzare un elenco completo facendo clic sul nome dell'istanza e poi su Profili applicazione nel riquadro a sinistra.

3. Seleziona il nuovo cluster a cui deve essere indirizzato il traffico, 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. Se non conosci l'ID del profilo dell'app, utilizza il comando bigtable app-profiles list per visualizzare un elenco dei profili dell'app dell'istanza:

   gcloud bigtable app-profiles list --instance=INSTANCE_ID
   

   Sostituisci INSTANCE_ID con l'identificatore permanente dell'istanza.

3. (Facoltativo) Utilizza il comando gcloud bigtable app-profiles describe per visualizzare le impostazioni del profilo dell'app:

   gcloud bigtable app-profiles describe APP_PROFILE_ID \
       --instance=INSTANCE_ID
   

   Fornisci quanto segue:

   • APP_PROFILE_ID: L'identificatore permanente del profilo dell'app.
   • INSTANCE_ID: l'identificatore permanente dell'istanza

4. Utilizza il comando gcloud beta bigtable app-profiles update per aggiornare le impostazioni del profilo dell'app:

   gcloud beta bigtable app-profiles update APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       --route-to=CLUSTER_ID
   

   Fornisci quanto segue:

   • APP_PROFILE_ID: L'identificatore permanente del profilo dell'app.
   • INSTANCE_ID: l'identificatore permanente dell'istanza
   • CLUSTER_ID: l'ID del nuovo cluster da cui leggere

Converti un profilo dell'app

Puoi convertire un profilo dell'app standard in un profilo dell'app Data Boost o viceversa. Prima di convertire un profilo dell'app, consulta le indicazioni riportate in Modifiche ai profili dell'app.

Passa da Standard a Data Boost

Prima di aggiornare un profilo dell'app da standard (nodi di cui è stato eseguito il provisioning per il computing) al serverless computing di Data Boost, controlla le metriche di idoneità di Data Boost. Devi anche tenere presente le limitazioni di Data Boost.

Nota: Per utilizzare le funzionalità avanzate di Data Boost, l'istanza deve utilizzare l'edizione Enterprise Plus.

Console

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

   Apri l'elenco delle istanze

2. Nella colonna Profili applicazione, fai clic sul profilo dell'applicazione che vuoi aggiornare.

   Se non vedi il profilo dell'app che vuoi modificare, puoi visualizzare un elenco completo facendo clic sul nome dell'istanza, quindi su Profili applicazione nel riquadro a sinistra.

3. Seleziona Data Boost.

4. Seleziona il cluster a cui devono essere indirizzate le richieste.

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 l'ID del profilo dell'app, utilizza il comando bigtable app-profiles list per visualizzare un elenco dei profili dell'app dell'istanza:

   gcloud bigtable app-profiles list --instance=INSTANCE_ID
   

   Sostituisci INSTANCE_ID con l'identificatore permanente dell'istanza.

3. (Facoltativo) Utilizza il comando bigtable app-profiles describe per visualizzare le impostazioni del profilo dell'app:

   gcloud bigtable app-profiles describe APP_PROFILE_ID \
       --instance=INSTANCE_ID
   

   Fornisci quanto segue:

   • APP_PROFILE_ID: L'identificatore permanente del profilo dell'app.
   • INSTANCE_ID: l'identificatore permanente dell'istanza

4. Utilizza il comando gcloud beta bigtable app-profiles update per convertire un profilo dell'app da standard a Data Boost:

   gcloud bigtable app-profiles update APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       --data-boost \
       --data-boost-compute-billing-owner=HOST_PAYS \
       --route-to=CLUSTER_ID
   

   Fornisci quanto segue:

   • APP_PROFILE_ID: L'identificatore permanente del profilo dell'app.
   • INSTANCE_ID: l'identificatore permanente dell'istanza
   • CLUSTER_ID: l'ID cluster a cui devono essere indirizzate tutte le richieste. Questo flag attiva il routing a un cluster singolo.

Converti da Data Boost a Standard

Per modificare un profilo dell'app in modo che utilizzi Data Boost (serverless computing) anziché standard (nodi di cui è stato eseguito il provisioning per il computing), segui questi passaggi:

Console

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

   Apri l'elenco delle istanze

2. Nella colonna Profili applicazione, fai clic sul profilo dell'applicazione che vuoi aggiornare.

   Se non vedi il profilo dell'app che vuoi modificare, puoi visualizzare un elenco completo facendo clic sul nome dell'istanza, quindi su Profili applicazione nel riquadro a sinistra.

3. Seleziona Standard.

4. Fai clic su Avanti.

5. (Facoltativo) Modifica la descrizione del profilo dell'app.

6. In Routing dei cluster, seleziona Routing a cluster singolo o Routing a cluster multipli. Scopri di più.

7. Se scegli Cluster singolo:

   1. Nell'elenco Cluster, seleziona il cluster a cui indirizzare le richieste.

   2. Se devi attivare le transazioni su riga singola, seleziona la casella di controllo Consenti transazioni su riga singola.

8. Se scegli Multi-cluster:

   1. Nell'elenco Gruppo di cluster, per instradare le richieste a qualsiasi cluster nell'istanza, seleziona Qualsiasi cluster.
   2. Per limitare il routing delle richieste solo ad alcuni cluster nell'istanza (routing dei gruppi di cluster), seleziona ogni cluster che vuoi includere nel gruppo di routing, quindi fai clic su OK.
   3. Per indirizzare le richieste di lettura e scrittura a riga singola a un cluster specifico in base alla chiave di riga della richiesta, seleziona Abilita affinità delle righe.

9. In Seleziona una priorità di routing, assegna una priorità di routing alle tue richieste selezionando una delle seguenti opzioni:

   • Alta: da utilizzare per le richieste sensibili alla latenza
   • Media: da utilizzare per richieste di uso generico
   • Bassa: da utilizzare per attività in background o operazioni meno urgenti

10. 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 l'ID del profilo dell'app, utilizza il comando bigtable app-profiles list per visualizzare un elenco dei profili dell'app dell'istanza:

   gcloud bigtable app-profiles list --instance=INSTANCE_ID
   

   Sostituisci INSTANCE_ID con l'identificatore permanente dell'istanza.

3. (Facoltativo) Utilizza il comando bigtable app-profiles describe per visualizzare le impostazioni del profilo dell'app:

   gcloud bigtable app-profiles describe APP_PROFILE_ID \
       --instance=INSTANCE_ID
   

4. Utilizza il comando gcloud beta bigtable app-profiles update per convertire il profilo dell'app:

   gcloud bigtable app-profiles update APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       --standard \
       [--route-any] \
       [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...]
       [--route-to=CLUSTER_ID] \
       [--transactional-writes]
   

Fornisci quanto segue:

• APP_PROFILE_ID: L'identificatore permanente del profilo dell'app.
• INSTANCE_ID: l'identificatore permanente dell'istanza

Il comando accetta i seguenti flag facoltativi:

• --route-any: Abilita il routing multi-cluster per instradare le richieste a qualsiasi cluster disponibile.

  Non puoi combinare questo flag con i flag --route-to o --transactional-writes.

• --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: un elenco di cluster a cui devono essere indirizzate le richieste. Utilizza questa opzione se vuoi instradare le richieste solo ad alcuni cluster dell'istanza.

  Non puoi combinare questo flag con i flag --route-to o --transactional-writes.

• --route-to=CLUSTER_ID: l'ID cluster a cui devono essere indirizzate tutte le richieste. Questo flag attiva il routing a un cluster singolo.

  Non puoi combinare questo flag con il flag --route-any.

• --transactional-writes: Attiva le transazioni su una singola riga nel profilo dell'app.

  Non puoi combinare questo flag con i flag --route-any o --restrict-to.

Elimina un profilo dell'app

Puoi eliminare i profili app personalizzati di un'istanza, ma non il profilo app predefinito.

Avviso: non eliminare un profilo dell'app personalizzato ancora utilizzato da un'applicazione. Dopo aver eliminato un profilo dell'app personalizzato, tutte le richieste che utilizzano quel profilo dell'app non andranno a buon fine.

Per eliminare un profilo dell'app personalizzato:

Console

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

   Apri l'elenco delle istanze

2. Fai clic sull'istanza che contiene il profilo dell'app che vuoi eliminare.

3. Nel riquadro a sinistra, fai clic su Profili applicazione.

4. Apri il menu Altre azioni , quindi fai clic su Elimina profilo dell'applicazione. Viene visualizzata una finestra di dialogo di conferma.

5. Segui le istruzioni nella finestra di dialogo di conferma, quindi fai clic su Elimina.

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 l'ID del profilo dell'app, utilizza il comando bigtable app-profiles list per visualizzare un elenco dei profili dell'app dell'istanza:

   gcloud bigtable app-profiles list --instance=INSTANCE_ID
   

   Sostituisci INSTANCE_ID con l'identificatore permanente dell'istanza.

3. Utilizza il comando bigtable app-profiles delete per eliminare il profilo dell'app:

   gcloud bigtable app-profiles delete APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       [--force]
   

   Fornisci quanto segue:

   • APP_PROFILE_ID: L'identificatore permanente del profilo dell'app.
   • INSTANCE_ID: l'identificatore permanente dell'istanza

   Il comando accetta il seguente flag facoltativo:

   --force: ignora gli avvisi relativi a potenziali problemi e conflitti con altri profili di app.