Creazione e configurazione di profili di app

Questa pagina spiega come creare e gestire un'istanza Bigtable profili di applicazione o profili di app. Mostra inoltre come usare un'app personalizzata per la connessione a Bigtable.

Prima di leggere questa pagina, è importante capire che cosa sono i profili delle app e in che modo funzionano. In particolare, assicurati di comprendere la differenza tra un profilo dell'app standard: un profilo dell'app configurato per l'utilizzo di computing standard e un profilo dell'app Data Boost, ovvero un'app profilo che utilizza Data Boost (anteprima) serverless per eseguire job di lettura a velocità effettiva elevata. Per ulteriori informazioni Data Boost e come si differenzia dal computing utilizzando nodi cluster di cui è stato eseguito il provisioning, guarda Data Boost Panoramica.

Se utilizzi profili dell'app standard per configurare la replica, dovresti conoscere anche la panoramica di Bigtable di replica ed è necessario esaminare gli esempi di impostazioni di replica e decidere quali sono le impostazioni migliori per il tuo caso d'uso.

Ruoli obbligatori

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

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

Creare un profilo dell'app

Puoi creare diversi profili di app personalizzati per ogni istanza. Utilizza profili app personalizzati per controllare il modo in cui ogni applicazione, o ogni funzione distinta all'interno di un'applicazione, interagisce con in esecuzione in un'istanza Compute Engine. Ad esempio, potresti utilizzare un profilo dell'app per un'applicazione batch al fine di isolare il traffico a un singolo cluster e potresti usare un profilo dell'app diverso per fornire disponibilità elevata un'altra applicazione.

Crea un profilo dell'app standard

Per creare un profilo dell'app standard, svolgi i seguenti passaggi:

Console

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

    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 di applicazione.

  4. Fai clic su Crea profilo applicazione.

  5. Inserisci l'ID profilo applicazione.

    L'ID profilo di applicazione è un identificatore permanente dell'app profilo. L'applicazione fornisce questo ID quando si connette Bigtable.

  6. Inserisci una descrizione del profilo dell'app.

  7. In Routing dei cluster, seleziona un cluster singolo di routing o di routing multi-cluster. Scopri di più.

  8. Se scegli cluster singolo:

    1. Utilizza il menu a discesa per selezionare il cluster a cui instradare le richieste.

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

  9. Se scegli Multi-cluster:

    1. Per instradare richieste a qualsiasi cluster nell'istanza, Seleziona Qualsiasi cluster nell'elenco a discesa Gruppo di cluster.
    2. Per limitare il routing delle richieste solo ad alcuni cluster nell'istanza (routing del gruppo di cluster), seleziona la casella di controllo per ogni cluster che vuoi includere gruppo di routing, quindi fai clic su OK.

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

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

gcloud

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

    gcloud bigtable instances list

  2. Utilizza la 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]

    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: Ignorare 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 in qualsiasi cluster disponibile.

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

    • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: un elenco di cluster che a cui indirizzare le richieste. Utilizza questa opzione se vuoi indirizzare ad alcuni dei cluster nell'istanza.

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

    • --route-to=CLUSTER_ID: L'ID cluster a cui devono essere instradate tutte le richieste. Questo flag abilita routing a cluster singolo.

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

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

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

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

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

Crea un profilo dell'app Data Boost

Per creare un profilo app Data Boost, ovvero un profilo app che utilizza Elaborazione serverless di Data Boost: segui questi passaggi. Per assicurarti che il carico di lavoro è compatibile con Data Boost, consulta le limitazioni.

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

    gcloud bigtable instances list

  2. Utilizza la 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 instradate tutte le richieste. Questo flag abilita routing a cluster singolo.

Collegare un profilo dell'app personalizzato

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

I seguenti esempi mostrano come specificare un profilo dell'app quando la tua 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)

Java HBase

// 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]')

Aggiornare il profilo di un'app

Puoi visualizzare i profili delle app di un'istanza e aggiornare le relative impostazioni in qualsiasi momento. Bigtable ti avvisa in caso di aggiornamenti che potrebbero causare imprevisti cambiamenti nel comportamento.

Per vedere come aggiornare il profilo di un'app da Standard a Data Boost Data Boost in standard, vedi Convertire un profilo dell'app.

Aggiornare un profilo dell'app standard

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

Console

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

    Apri l'elenco delle istanze .

  2. Nella colonna Profili applicazione, fai clic sul profilo applicazione a cui vuoi applicare visualizzare o aggiornare.

    Se non vedi il profilo dell'app che desideri modificare, puoi visualizzare un per completare l'elenco facendo clic sul nome dell'istanza, quindi Profili di applicazione nel riquadro a sinistra.

  3. Aggiorna le impostazioni in base alle tue esigenze, poi fai clic su Salva o su Annulla. per uscire senza salvare.

gcloud

  1. Se non conosci l'ID istanza, utilizza 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, usa la 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 per l'istanza.

  3. (Facoltativo) Utilizza la 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 la 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]

    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: Ignorare 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 in qualsiasi cluster disponibile.

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

    • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: un elenco di cluster che a cui indirizzare le richieste. Utilizza questa opzione se vuoi indirizzare ad alcuni dei cluster nell'istanza.

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

    • --route-to=CLUSTER_ID: L'ID cluster a cui devono essere instradate tutte le richieste. Questo flag abilita routing a cluster singolo.

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

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

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

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

Aggiornare un profilo dell'app Data Boost

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

  1. Se non conosci l'ID istanza, utilizza 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, usa la 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 per l'istanza.

  3. (Facoltativo) Utilizza la 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 la 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 il profilo di un'app

Puoi convertire un profilo app standard in un profilo app Data Boost. converti un profilo app Data Boost in un profilo app standard. Prima di converti un profilo dell'app, rivedi le indicazioni in Profilo dell'app modifiche.

  1. Se non conosci l'ID istanza, utilizza 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, usa la 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 per l'istanza.

  3. (Facoltativo) Utilizza la 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 la beta bigtable app-profiles update per convertire un profilo dell'app da standard a Incremento dei dati:

    gcloud bigtable app-profile-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 instradate tutte le richieste. Questo flag abilita routing a cluster singolo.

Convertire un profilo app da standard a Data Boost

Prima di aggiornare il profilo di un'app da Standard (nodi di cui è stato eseguito il provisioning per il calcolo) per il serverless computing di Data Boost, verifica l'idoneità metriche.

  1. Se non conosci l'ID istanza, utilizza 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, usa la 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 per l'istanza.

  3. (Facoltativo) Utilizza la 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.

Convertire un profilo app da Data Boost a Standard

Per cambiare il profilo di un'app dall'utilizzo di Data Boost (serverless computing) a standard (nodi di cui è stato eseguito il provisioning per il calcolo):

  1. Se non conosci l'ID istanza, utilizza 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, usa la 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 per l'istanza.

  3. (Facoltativo) Utilizza la 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 la beta bigtable app-profiles update per convertire il profilo dell'app:

    gcloud beta 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 in qualsiasi cluster disponibile.

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

  • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: un elenco di cluster che a cui indirizzare le richieste. Utilizza questa opzione se vuoi indirizzare ad alcuni dei cluster nell'istanza.

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

  • --route-to=CLUSTER_ID: L'ID cluster a cui devono essere instradate tutte le richieste. Questo flag abilita routing a cluster singolo.

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

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

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

Eliminare il profilo di un'app

Puoi eliminare i profili app personalizzati di un'istanza, ma non l'app predefinita profilo.

Per eliminare un profilo dell'app personalizzato:

Console

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

    Apri l'elenco delle istanze .

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

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

  4. Apri il menu Altre azioni , quindi fai clic su Elimina profilo 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 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, usa la 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 per l'istanza.

  3. Utilizza la 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: Ignorare gli avvisi relativi a potenziali problemi e conflitti con altri profili di app.