Como configurar perfis de aplicativo

Nesta página, explicamos como criar e gerenciar os perfis de aplicativo de uma instância do Cloud Bigtable. Além disso, mostramos como usar um perfil de aplicativo personalizado para conexão com o Cloud Bigtable.

Antes de ler esta página, é preciso entender o que são "perfis de aplicativos" e como eles funcionam. Ao usar perfis de aplicativo para configurar a replicação, é preciso também estar familiarizado com a visão geral da replicação do Cloud Bigtable e revisar os exemplos de configurações de replicação para decidir quais configurações são as melhores para seu caso de uso.

Como criar um perfil de aplicativo personalizado

Você pode criar vários perfis personalizados de aplicativo diferentes para cada instância. Use perfis de app personalizados para controlar como cada aplicativo ou função do aplicativo interage com uma instância. Por exemplo, você pode usar um perfil para um aplicativo em lote para isolar o tráfego para um único cluster e usar outro perfil para oferecer alta disponibilidade a outro aplicativo.

Para criar um perfil personalizado de aplicativo:

Console

  1. Abra a lista de instâncias do Cloud Bigtable no Console do GCP.

    Abrir a lista de instâncias

  2. Clique na instância em que você quer criar um perfil de aplicativo.

  3. No painel esquerdo, clique em Perfis de aplicativo.

  4. Clique em Criar perfil de aplicativo.

  5. Informe o código do perfil de aplicativo.

    O código do perfil de aplicativo é um identificador permanente do perfil de aplicativo. Seu aplicativo mostra esse código quando se conecta ao Cloud Bigtable.

  6. Digite uma descrição do perfil de aplicativo.

  7. Em Roteamento de cluster, selecione um código de cluster para usar o roteamento de cluster único ou Qualquer cluster para usar o roteamento de vários clusters. Saiba mais.

  8. Em Transações de linha única, selecione a caixa Permitir transações de linha única caso precise habilitar transações de linha única. Saiba mais.

    Para habilitar transações de linha única, você precisa usar roteamento de cluster único.

  9. Clique em Criar para criar o perfil de aplicativo.

  10. Atualize o código do aplicativo para se conectar ao Cloud Bigtable para que ele use o novo perfil de aplicativo.

gcloud

  1. Caso não saiba o código da instância, use o comando bigtable instances list para ver uma lista de instâncias do projeto:

    gcloud bigtable instances list
    
  2. Para criar um perfil de aplicativo, use o comando bigtable app-profiles create:

    gcloud bigtable app-profiles create APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        [--description=DESCRIPTION] \
        [--force] \
        [--route-any] \
        [--route-to=CLUSTER_ID] \
        [--transactional-writes]
    

    Forneça os valores a seguir:

    • APP_PROFILE_ID: identificador permanente do perfil de aplicativo.
    • INSTANCE_ID: identificador permanente da instância.

    O comando aceita as seguintes sinalizações opcionais:

    • --description=DESCRIPTION: é uma descrição detalhada do perfil de aplicativo.
    • --force: ignora os avisos sobre possíveis problemas e conflitos com outros perfis de aplicativo.
    • --route-any: ativa o roteamento de diversos clusters para encaminhar solicitações a clusters disponíveis.

      Não é possível combinar esta sinalização com as sinalizações --route-to ou --transactional-writes.

    • --route-to=CLUSTER_ID: código do cluster ao qual todas as solicitações serão roteadas. Esta sinalização habilita o roteamento de cluster único.

      Não é possível combinar essa sinalização com a sinalização --route-any.

    • --transactional-writes: ativa transações de linha única no perfil de aplicativo.

      Não é possível combinar essa sinalização com a sinalização --route-any.

  3. Atualize o código do aplicativo para se conectar ao Cloud Bigtable para que ele use o novo perfil de aplicativo.

Como se conectar a um perfil de aplicativo personalizado

Após criar um perfil de aplicativo personalizado, atualize seu código para que o aplicativo use o perfil de aplicativo personalizado quando se conectar ao Cloud Bigtable.

Os exemplos a seguir mostram como especificar um perfil de aplicativo quando o aplicativo cria um cliente do Cloud Bigtable e se conecta a uma instância. Substitua [APP_PROFILE_ID] pelo valor adequado.

C#

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

Go

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

HappyBase

A biblioteca de cliente do HappyBase não é compatível com perfis de aplicativos personalizados. Ela sempre usa o perfil de aplicativo padrão.

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

Como atualizar um perfil de aplicativo

Você pode ver os perfis de aplicativo de uma instância e atualizar as configurações a qualquer momento. O Cloud Bigtable avisa sobre atualizações que possam causar mudanças inesperadas de comportamento.

Para visualizar ou atualizar um perfil de aplicativo existente:

Console

  1. Abra a lista de instâncias do Cloud Bigtable no Console do GCP.

    Abrir a lista de instâncias

  2. Na coluna Perfis de aplicativo, clique no perfil de aplicativo que você quer visualizar ou atualizar.

    Caso não encontre o perfil de aplicativo que quer editar, você poderá ver uma lista completa clicando no nome da instância e em Perfis de aplicativo no painel esquerdo.

  3. Atualize as configurações conforme necessário e clique em Salvar ou em Cancelar para sair sem salvar.

gcloud

  1. Caso não saiba o código da instância, use o comando bigtable instances list para ver uma lista de instâncias do projeto:

    gcloud bigtable instances list
    
  2. Caso não saiba o código do perfil de aplicativo, use o comando bigtable app-profiles list para ver uma lista de perfis de aplicativo da instância:

    gcloud bigtable app-profiles list --instance=INSTANCE_ID
    

    Substitua INSTANCE_ID pelo identificador permanente da instância.

  3. (Opcional) Use o comando bigtable app-profiles describe para ver as configurações do perfil de aplicativo:

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

    Forneça os valores a seguir:

    • APP_PROFILE_ID: identificador permanente do perfil de aplicativo.
    • INSTANCE_ID: identificador permanente da instância
  4. Use o comando bigtable app-profiles update para atualizar as configurações do perfil de aplicativo:

    gcloud bigtable app-profiles update APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        [--description=DESCRIPTION] \
        [--force] \
        [--route-any] \
        [--route-to=CLUSTER_ID] \
        [--transactional-writes]
    

    Forneça os valores a seguir:

    • APP_PROFILE_ID: identificador permanente do perfil de aplicativo.
    • INSTANCE_ID: identificador permanente da instância.

    O comando aceita as seguintes sinalizações opcionais:

    • --description=DESCRIPTION: é uma descrição detalhada do perfil de aplicativo.
    • --force: ignora os avisos sobre possíveis problemas e conflitos com outros perfis de aplicativo.
    • --route-any: ativa o roteamento de diversos clusters para encaminhar solicitações a clusters disponíveis.

      Não é possível combinar esta sinalização com as sinalizações --route-to ou --transactional-writes.

    • --route-to=CLUSTER_ID: código do cluster ao qual todas as solicitações serão roteadas. Esta sinalização habilita o roteamento de cluster único.

      Não é possível combinar essa sinalização com a sinalização --route-any.

    • --transactional-writes: ativa transações de linha única no perfil de aplicativo.

      Não é possível combinar essa sinalização com a sinalização --route-any.

Como excluir um perfil de aplicativo

É possível excluir os perfis de aplicativo personalizados de uma instância, mas não o perfil de aplicativo padrão.

Para excluir um perfil de aplicativo personalizado:

Console

  1. Abra a lista de instâncias do Cloud Bigtable no Console do GCP.

    Abrir a lista de instâncias

  2. Clique na instância que contém o perfil de aplicativo que você quer excluir.

  3. No painel esquerdo, clique em Perfis de aplicativo.

  4. Abra o menu mais ações e clique em Excluir perfil de aplicativo. Uma caixa de diálogo de confirmação é exibida.

  5. Siga as instruções na caixa de diálogo de confirmação e clique em Excluir.

gcloud

  1. Caso não saiba o código da instância, use o comando bigtable instances list para ver uma lista de instâncias do projeto:

    gcloud bigtable instances list
    
  2. Caso não saiba o código do perfil de aplicativo, use o comando bigtable app-profiles list para ver uma lista de perfis de aplicativo da instância:

    gcloud bigtable app-profiles list --instance=INSTANCE_ID
    

    Substitua INSTANCE_ID pelo identificador permanente da instância.

  3. Use o comando bigtable app-profiles delete para excluir o perfil de aplicativo:

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

    Forneça os valores a seguir:

    • APP_PROFILE_ID: identificador permanente do perfil de aplicativo.
    • INSTANCE_ID: identificador permanente da instância.

    O comando aceita a seguinte sinalização opcional:

    --force: ignora os avisos sobre possíveis problemas e conflitos com outros perfis de aplicativo.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Cloud Bigtable