Crie e configure perfis de apps

Esta página explica como criar e gerir os perfis de aplicações de uma instância do Bigtable, ou perfis de apps. Também mostra como usar um perfil de app personalizado para se ligar ao Bigtable.

Antes de ler esta página, deve compreender o que são os perfis de apps e como funcionam. Em particular, certifique-se de que compreende a diferença entre um perfil de app padrão, um perfil de app configurado para usar a computação padrão, e um perfil de app do Data Boost, um perfil de app que usa a computação sem servidor do Data Boost para executar tarefas de leitura de elevado débito. Para mais informações sobre o Data Boost e como difere da computação com nós de cluster aprovisionados, consulte a vista geral do Data Boost.

Se estiver a usar perfis de apps padrão para configurar a replicação, também deve conhecer a vista geral da replicação do Bigtable e rever os exemplos de definições de replicação e decidir que definições são mais adequadas para o seu exemplo de utilização.

Funções necessárias

Para receber as autorizações de que precisa para criar, configurar ou eliminar um perfil de app, peça ao seu administrador para lhe conceder a função do IAM Administrador do Bigtable (roles/bigtable.admin) na instância. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Crie um perfil de app

Pode criar muitos perfis de apps personalizados diferentes para cada instância. Use perfis de apps personalizados para controlar a forma como cada aplicação ou cada função distinta numa aplicação interage com uma instância. Por exemplo, pode usar um perfil de app para uma aplicação em lote para isolar o respetivo tráfego num único cluster e pode usar um perfil de app diferente para oferecer elevada disponibilidade para outra aplicação.

Crie um perfil de app padrão

Para criar um perfil de app padrão, siga estes passos:

Consola

  1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

    Abra a lista de instâncias

  2. Clique na instância onde quer criar o perfil da app.

  3. No painel esquerdo, clique em Perfis de aplicações.

  4. Clique em Criar perfil da aplicação.

  5. Selecione Padrão.

  6. Clicar em Seguinte.

  7. Introduza o ID do perfil da aplicação.

    O ID do perfil da aplicação é um identificador permanente do perfil da app. A sua aplicação fornece este ID quando se liga ao Bigtable.

  8. Introduza uma descrição do perfil da app.

  9. Em Encaminhamento de clusters, selecione o encaminhamento de cluster único ou o encaminhamento de vários clusters. Saiba mais.

  10. Se escolher Único cluster:

    1. Use o menu pendente para selecionar o cluster para o qual encaminhar os pedidos.

    2. Se precisar de ativar as transações de linha única, selecione a caixa de verificação Permitir transações de linha única.

  11. Se escolher Vários clusters:

    1. Para encaminhar pedidos para qualquer cluster na instância, selecione Qualquer cluster no menu pendente Grupo de clusters.
    2. Para limitar o encaminhamento de pedidos apenas a alguns clusters na instância (encaminhamento de grupos de clusters), selecione a caixa de verificação de cada cluster que quer incluir no grupo de encaminhamento e, de seguida, clique em OK.

  12. Clique em Criar para criar o perfil da app.

  13. Atualize o código da sua aplicação para se ligar ao Bigtable de modo a usar o novo perfil da app.

gcloud

  1. Se não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do seu projeto: 

    gcloud bigtable instances list

  2. Use o bigtable app-profiles create comando para criar um perfil de 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]

    Forneça os seguintes dados:

    • APP_PROFILE_ID: O identificador permanente do perfil da app.
    • INSTANCE_ID: O identificador permanente da instância.

    O comando aceita as seguintes flags opcionais:

    • --description=DESCRIPTION: Uma descrição detalhada do perfil da app.
    • --force: ignore os avisos sobre potenciais problemas e conflitos com outros perfis de apps.

    • --route-any: ative o encaminhamento em vários clusters para encaminhar pedidos para qualquer cluster disponível.

      Não pode combinar esta flag com as flags --route-to ou --transactional-writes.

    • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: uma lista de clusters para os quais os pedidos devem ser encaminhados. Use esta opção se quiser encaminhar pedidos apenas para alguns dos clusters na instância.

      Não pode combinar esta flag com as flags --route-to ou --transactional-writes.

    • --route-to=CLUSTER_ID: O ID do cluster para o qual todos os pedidos devem ser encaminhados. Este sinalizador ativa o encaminhamento de cluster único.

      Não pode combinar esta flag com a flag --route-any.

    • --transactional-writes: ative transações de linha única no perfil da app.

      Não pode combinar esta flag com as flags --route-any ou --restrict-to.

    • --priority=PRIORITY: o nível de prioridade que o perfil da app deve usar. Os valores aceites são PRIORITY_HIGH, PRIORITY_MEDIUM ou PRIORITY_LOW.

    • –-row-affinity: ative o encaminhamento de afinidade de linhas no perfil da app.

      Não pode combinar esta flag com as flags --route-to ou --transactional-writes.

  3. Atualize o código da sua aplicação para se ligar ao Bigtable de modo a usar o novo perfil da app.

Crie um perfil de app da Otimização de dados

Para criar um perfil de app do Data Boost, ou seja, um perfil de app que usa o cálculo sem servidor do Data Boost, siga estes passos. Para se certificar de que a sua carga de trabalho é compatível com o aumento de dados, reveja as limitações.

Consola

  1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

    Abra a lista de instâncias

  2. Clique na instância onde quer criar o perfil da app.

  3. No painel esquerdo, clique em Perfis de aplicações.

  4. Clique em Criar perfil da aplicação.

  5. Selecione Otimização de dados.

  6. Clicar em Seguinte.

  7. Introduza o ID do perfil da aplicação.

    O ID do perfil da aplicação é um identificador permanente do perfil da app. A sua aplicação fornece este ID quando se liga ao Bigtable.

  8. Introduza uma descrição do perfil da app.

  9. Em Encaminhamento de clusters, selecione o cluster para o qual encaminhar os pedidos.

  10. Clique em Criar perfil da app para criar o perfil da app.

  11. Atualize o código da sua aplicação para se ligar ao Bigtable de modo a usar o novo perfil da app.

gcloud

  1. Se não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do seu projeto: 

    gcloud bigtable instances list

  2. Use o gcloud beta bigtable app-profiles create comando para criar um perfil de 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

    Forneça os seguintes dados:

    • APP_PROFILE_ID: O identificador permanente do perfil da app.
    • INSTANCE_ID: O identificador permanente da instância.
    • CLUSTER_ID: O ID do cluster para o qual todos os pedidos devem ser encaminhados. Este sinalizador ativa o encaminhamento de cluster único.

Associe um perfil de app personalizado

Depois de criar um perfil de app personalizado, pode atualizar o código para que a sua aplicação use o perfil de app quando se ligar ao Bigtable.

Os exemplos seguintes mostram como especificar um perfil de app quando a sua app cria um cliente do Bigtable e se liga 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)

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

Atualize um perfil de app

Pode ver os perfis de apps de uma instância e atualizar as respetivas definições em qualquer altura. O Bigtable avisa acerca de quaisquer atualizações que possam causar alterações inesperadas no comportamento.

Para saber como atualizar um perfil de app do tipo padrão para o tipo Otimização de dados ou do tipo Otimização de dados para o tipo padrão, consulte o artigo Converta um perfil de app.

Atualize um perfil de app padrão

Para atualizar um perfil de app padrão, siga estes passos:

Consola

  1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

    Abra a lista de instâncias

  2. Na coluna Perfis de aplicações, clique no perfil da app que quer ver ou atualizar.

    Se não vir o perfil da app que quer editar, pode ver uma lista completa clicando no nome da instância e, de seguida, em Perfis de aplicações no painel do lado esquerdo.

  3. Atualize as definições conforme necessário e, de seguida, clique em Guardar ou clique em Cancelar para sair sem guardar.

gcloud

  1. Se não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do seu projeto: 

    gcloud bigtable instances list

  2. Se não souber o ID do perfil da app, use o comando bigtable app-profiles list para ver uma lista dos perfis da app da instância: 

    gcloud bigtable app-profiles list --instance=INSTANCE_ID

    Substitua INSTANCE_ID pelo identificador permanente da instância.

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

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

    Forneça os seguintes dados:

    • APP_PROFILE_ID: O identificador permanente do perfil da app.
    • INSTANCE_ID: O identificador permanente da instância.

  4. Use o bigtable app-profiles updatecomando para atualizar as definições do perfil da 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]

    Forneça os seguintes dados:

    • APP_PROFILE_ID: O identificador permanente do perfil da app.
    • INSTANCE_ID: O identificador permanente da instância.

    O comando aceita as seguintes flags opcionais:

    • --description=DESCRIPTION: Uma descrição detalhada do perfil da app.
    • --force: ignore os avisos sobre potenciais problemas e conflitos com outros perfis de apps.

    • --route-any: ative o encaminhamento em vários clusters para encaminhar pedidos para qualquer cluster disponível.

      Não pode combinar esta flag com as flags --route-to ou --transactional-writes.

    • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: uma lista de clusters para os quais os pedidos devem ser encaminhados. Use esta opção se quiser encaminhar pedidos apenas para alguns dos clusters na instância.

      Não pode combinar esta flag com as flags --route-to ou --transactional-writes.

    • --route-to=CLUSTER_ID: O ID do cluster para o qual todos os pedidos devem ser encaminhados. Este sinalizador ativa o encaminhamento de cluster único.

      Não pode combinar esta flag com a flag --route-any.

    • --transactional-writes: ative transações de linha única no perfil da app.

      Não pode combinar esta flag com a flag --route-any.

    • --priority=PRIORITY: o nível de prioridade que o perfil da app usa. Os valores aceites são PRIORITY_HIGH, PRIORITY_MEDIUM ou PRIORITY_LOW.

Atualize um perfil da app do Data Boost

Para atualizar o cluster a partir do qual um perfil da app Data Boost lê, siga estes passos:

Consola

  1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

    Abra a lista de instâncias

  2. Na coluna Perfis de aplicações, clique no perfil da app que quer ver ou atualizar.

    Se não vir o perfil da app que quer editar, pode ver uma lista completa clicando no nome da instância e, de seguida, em Perfis de aplicações no painel do lado esquerdo.

  3. Selecione o novo cluster para o qual o tráfego deve ser encaminhado e, de seguida, clique em Guardar.

gcloud

  1. Se não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do seu projeto: 

    gcloud bigtable instances list

  2. Se não souber o ID do perfil da app, use o comando bigtable app-profiles list para ver uma lista dos perfis da app da instância: 

    gcloud bigtable app-profiles list --instance=INSTANCE_ID

    Substitua INSTANCE_ID pelo identificador permanente da instância.

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

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

    Forneça os seguintes dados:

    • APP_PROFILE_ID: O identificador permanente do perfil da app.
    • INSTANCE_ID: O identificador permanente da instância.

  4. Use o gcloud beta bigtable app-profiles updatecomando para atualizar as definições do perfil da app:

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

    Forneça os seguintes dados:

    • APP_PROFILE_ID: O identificador permanente do perfil da app.
    • INSTANCE_ID: O identificador permanente da instância.
    • CLUSTER_ID: o ID do novo cluster a partir do qual ler

Converta um perfil de app

Pode converter um perfil de app padrão num perfil de app Data Boost ou converter um perfil de app Data Boost num perfil de app padrão. Antes de converter um perfil de app, reveja as orientações em Alterações ao perfil de app.

Converta de padrão para Data Boost

Antes de atualizar um perfil de app do tipo padrão (nós aprovisionados para computação) para computação sem servidor do Data Boost, verifique as métricas de elegibilidade do Data Boost. Também deve ter em atenção as limitações do aumento de dados.

Consola

  1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

    Abra a lista de instâncias

  2. Na coluna Perfis de aplicações, clique no perfil da app que quer atualizar.

    Se não vir o perfil da app que quer editar, pode ver uma lista completa clicando no nome da instância e, de seguida, em Perfis de aplicações no painel do lado esquerdo.

  3. Selecione Otimização de dados.

  4. Selecione o cluster para o qual os pedidos devem ser encaminhados.

  5. Clique em Guardar.

gcloud

  1. Se não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do seu projeto: 

    gcloud bigtable instances list

  2. Se não souber o ID do perfil da app, use o comando bigtable app-profiles list para ver uma lista dos perfis da app da instância: 

    gcloud bigtable app-profiles list --instance=INSTANCE_ID

    Substitua INSTANCE_ID pelo identificador permanente da instância.

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

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

    Forneça os seguintes dados:

    • APP_PROFILE_ID: O identificador permanente do perfil da app.
    • INSTANCE_ID: O identificador permanente da instância.

  4. Use o gcloud beta bigtable app-profiles updatecomando para converter um perfil de app de padrão para Otimizador de dados:

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

    Forneça os seguintes dados:

    • APP_PROFILE_ID: O identificador permanente do perfil da app.
    • INSTANCE_ID: O identificador permanente da instância.
    • CLUSTER_ID: O ID do cluster para o qual todos os pedidos devem ser encaminhados. Este sinalizador ativa o encaminhamento de cluster único.

Converta de Data Boost para padrão

Para alterar um perfil de app de modo a usar o Data Boost (computação sem servidor) para o modo padrão (nós aprovisionados para computação), siga estes passos:

Consola

  1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

    Abra a lista de instâncias

  2. Na coluna Perfis de aplicações, clique no perfil da app que quer atualizar.

    Se não vir o perfil da app que quer editar, pode ver uma lista completa clicando no nome da instância e, de seguida, em Perfis de aplicações no painel do lado esquerdo.

  3. Selecione Padrão.

  4. Clicar em Seguinte.

  5. Opcional: edite a descrição do perfil da app.

  6. Em Encaminhamento de clusters, selecione o encaminhamento de cluster único ou o encaminhamento de vários clusters. Saiba mais.

  7. Se escolher Único cluster:

    1. Use o menu pendente para selecionar o cluster para o qual encaminhar os pedidos.

    2. Se precisar de ativar as transações de linha única, selecione a caixa de verificação Permitir transações de linha única.

  8. Se escolher Vários clusters:

    1. Para encaminhar pedidos para qualquer cluster na instância, selecione Qualquer cluster no menu pendente Grupo de clusters.
    2. Para limitar o encaminhamento de pedidos apenas a alguns clusters na instância (encaminhamento de grupos de clusters), selecione a caixa de verificação de cada cluster que quer incluir no grupo de encaminhamento e, de seguida, clique em OK.

  9. Clique em Guardar.

gcloud

  1. Se não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do seu projeto: 

    gcloud bigtable instances list

  2. Se não souber o ID do perfil da app, use o comando bigtable app-profiles list para ver uma lista dos perfis da app da instância: 

    gcloud bigtable app-profiles list --instance=INSTANCE_ID

    Substitua INSTANCE_ID pelo identificador permanente da instância.

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

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

  4. Use o comando gcloud beta bigtable app-profiles update para converter o perfil da 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]

Forneça os seguintes dados:

  • APP_PROFILE_ID: O identificador permanente do perfil da app.
  • INSTANCE_ID: O identificador permanente da instância.

O comando aceita as seguintes flags opcionais:

  • --route-any: ative o encaminhamento em vários clusters para encaminhar pedidos para qualquer cluster disponível.

    Não pode combinar esta flag com as flags --route-to ou --transactional-writes.

  • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: uma lista de clusters para os quais os pedidos devem ser encaminhados. Use esta opção se quiser encaminhar pedidos apenas para alguns dos clusters na instância.

    Não pode combinar esta flag com as flags --route-to ou --transactional-writes.

  • --route-to=CLUSTER_ID: O ID do cluster para o qual todos os pedidos devem ser encaminhados. Este sinalizador ativa o encaminhamento de cluster único.

    Não pode combinar esta flag com a flag --route-any.

  • --transactional-writes: ative transações de linha única no perfil da app.

    Não pode combinar esta flag com as flags --route-any ou --restrict-to.

Elimine um perfil de app

Pode eliminar os perfis de apps personalizados de uma instância, mas não o perfil de app predefinido.

Para eliminar um perfil de app personalizado:

Consola

  1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

    Abra a lista de instâncias

  2. Clique na instância que contém o perfil da app que quer eliminar.

  3. No painel esquerdo, clique em Perfis de aplicações.

  4. Abra o menu Mais ações e, de seguida, clique em Eliminar perfil da aplicação. É apresentada uma caixa de diálogo de confirmação.

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

gcloud

  1. Se não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do seu projeto: 

    gcloud bigtable instances list

  2. Se não souber o ID do perfil da app, use o comando bigtable app-profiles list para ver uma lista dos perfis da app da instância: 

    gcloud bigtable app-profiles list --instance=INSTANCE_ID

    Substitua INSTANCE_ID pelo identificador permanente da instância.

  3. Use o bigtable app-profiles deletecomando para eliminar o perfil da app:

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

    Forneça os seguintes dados:

    • APP_PROFILE_ID: O identificador permanente do perfil da app.
    • INSTANCE_ID: O identificador permanente da instância.

    O comando aceita a seguinte marca opcional:

    --force: ignore os avisos sobre potenciais problemas e conflitos com outros perfis de apps.