Criar e configurar perfis de aplicativo

Observação: este documento inclui recursos disponíveis apenas na edição Enterprise Plus. Para mais informações, consulte Visão geral das edições.

Os perfis de app do Bigtable (perfis de app) permitem especificar políticas de roteamento, opções de computação e configurações de isolamento de carga de trabalho para solicitações de clientes recebidas. É possível direcionar o tráfego pelos nós de cluster provisionados, executar leituras isoladas de alta capacidade de processamento usando a computação sem servidor do Data Boost ou rotear leituras pontuais para uma camada na memória (prévia) em instâncias do Enterprise Plus.

Antes de começar

Antes de criar ou configurar um perfil de app, leia a seguinte documentação:

• Leia a Visão geral dos perfis de app para saber como eles funcionam e a diferença entre um perfil de app padrão para computação padrão e um perfil de app do Data Boost para jobs de leitura sem servidor de alto volume. Para mais informações sobre como o Data Boost difere da computação usando nós de cluster provisionados, consulte a Visão geral do Bigtable Data Boost.
• Se você estiver usando perfis de aplicativo padrão para configurar a replicação, leia Visão geral da replicação e Exemplos de configurações de replicação para decidir quais configurações são as melhores para seu caso de uso.
• Se você estiver usando um perfil de app da camada na memória, leia a visão geral da camada na memória.

Funções exigidas

Para receber as permissões necessárias para criar, configurar ou excluir um perfil de app, peça ao administrador para conceder a você o papel do IAM de Administrador do Bigtable (roles/bigtable.admin) na instância. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Criar um perfil de app

Crie muitos perfis de app personalizados 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, use 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.

Criar um perfil de app padrão

Para criar um perfil de app padrão, siga estas etapas:

Console

1. No console do Google Cloud , abra a lista de instâncias do Bigtable.

   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. Selecione Standard.

6. Clique em Próxima.

7. 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 Bigtable.

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

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

10. Se você escolher Cluster único:

    1. Na lista Cluster, selecione o cluster para onde as solicitações serão encaminhadas.

    2. Se você precisar ativar transações de linha única, marque a caixa de seleção Permitir transações de linha única.

11. Se você escolher Vários clusters:

    1. Na lista Grupo de clusters, para rotear solicitações para qualquer cluster na instância, selecione Qualquer cluster.
    2. Para limitar o roteamento de solicitações a apenas alguns clusters na instância (roteamento do grupo de clusters), selecione cada cluster que você quer incluir no grupo de roteamento e clique em OK.
    3. Para rotear solicitações de leitura e gravação de linha única para um cluster específico com base na chave de linha da solicitação, selecione Ativar afinidade de linha.

12. Em Selecionar uma prioridade de roteamento, atribua uma prioridade às suas solicitações selecionando uma das seguintes opções:

    • Alta: use para solicitações sensíveis à latência.
    • Médio: use para solicitações de uso geral
    • Baixa: use para tarefas em segundo plano ou operações menos urgentes.

13. Para criar o perfil do app, clique em Criar.

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

gcloud

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

   gcloud bigtable instances list
   

2. Use o comando bigtable app-profiles create para criar um perfil de aplicativo:

   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]
   

   Preencha o seguinte:

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

   O comando aceita as sinalizações opcionais a seguir:

   • --description=DESCRIPTION: uma descrição detalhada do perfil do app.
   • --force: ignora avisos sobre possíveis problemas e conflitos com outros perfis de apps.

   • --route-any: ative o roteamento de vários clusters para encaminhar solicitações a qualquer cluster disponível.

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

   • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: uma lista de clusters para os quais as solicitações precisam ser roteadas. Use essa opção se quiser rotear solicitações para apenas alguns dos clusters na instância.

     Não é possível combinar essa 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. Essa sinalização ativa o encaminhamento de cluster único.

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

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

     Não é possível combinar essa sinalização com as sinalizações --route-any ou --restrict-to.

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

   • --row-affinity: ative o roteamento por afinidade de linha no perfil do app.

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

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

Criar um perfil de app da camada na memória

Visualizar

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Para criar um perfil de app em um cluster com o nível na memória ativado, siga estas etapas:

Observação: não é possível ativar o roteamento de afinidade de linha para um perfil de app com camada na memória.

Console

1. No console do Google Cloud , abra a lista de instâncias do Bigtable.

   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. Selecione Camada na memória.

6. Clique em Próxima.

7. 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 Bigtable.

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

9. Em Direcionamento de cluster, selecione um cluster com a camada na memória ativada.

   Os clusters da camada na memória precisam usar o roteamento de cluster único.

10. Se você precisar ativar transações de linha única, selecione Permitir transações de linha única.

11. Em Selecionar uma prioridade de roteamento, atribua uma prioridade às suas solicitações selecionando uma das seguintes opções:

    • Alta: use para solicitações sensíveis à latência.
    • Médio: use para solicitações de uso geral
    • Baixa: use para tarefas em segundo plano ou operações menos urgentes.

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

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

gcloud

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

   gcloud bigtable instances list
   

2. Use o comando gcloud beta bigtable app-profiles create para criar um perfil de aplicativo:

   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]
   

   Preencha o seguinte:

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

   O comando aceita as sinalizações opcionais a seguir:

   • --route-to=CLUSTER_ID: código do cluster ao qual todas as solicitações serão roteadas. Essa sinalização ativa o encaminhamento de cluster único.
   • --use-memory-layer: encaminha solicitações de rota com este perfil de app para a camada na memória. Essa flag é limitada à edição Enterprise Plus e ao roteamento de cluster único.
   • --description=DESCRIPTION: uma descrição detalhada do perfil do app.
   • --transactional-writes: ative as transações de linha única no perfil do app.
   • --priority=PRIORITY: o nível de prioridade das solicitações enviadas usando o perfil de app. Os valores aceitos são PRIORITY_HIGH, PRIORITY_MEDIUM ou PRIORITY_LOW. As prioridades de solicitação não afetam as solicitações qualificadas para a camada na memória.

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

Criar um perfil de app do Data Boost

Para criar um perfil do app Data Boost, que usa a computação sem servidor do Data Boost, siga estas etapas. Para garantir que sua carga de trabalho seja compatível com o Data Boost, consulte as limitações.

Observação: para usar os recursos avançados do Data Boost, sua instância precisa usar a edição Enterprise Plus.

Console

1. No console do Google Cloud , abra a lista de instâncias do Bigtable.

   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. Selecione Data Boost.

6. Clique em Próxima.

7. 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 Bigtable.

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

9. Em Roteamento de cluster, selecione o cluster para onde as solicitações serão encaminhadas.

10. Clique em Criar perfil do app.

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

gcloud

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

   gcloud bigtable instances list
   

2. Use o comando gcloud beta bigtable app-profiles create para criar um perfil de aplicativo:

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

   Preencha o seguinte:

   • APP_PROFILE_ID: identificador permanente do perfil de aplicativo.
   • INSTANCE_ID: identificador permanente da instância
   • CLUSTER_ID: código do cluster ao qual todas as solicitações serão roteadas. Essa sinalização ativa o encaminhamento de cluster único.

Conectar-se a um perfil de app personalizado

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

Os exemplos a seguir mostram como especificar um perfil de aplicativo quando o aplicativo cria um cliente do 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)

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

Atualizar um perfil de app

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 de comportamento inesperadas.

Importante: as alterações feitas em um perfil de aplicativo entram em vigor imediatamente e valem para qualquer aplicativo que use o perfil. Caso você precise fazer alterações que não possam ser efetivadas imediatamente, crie um novo perfil de aplicativo e atualize o aplicativo para usar o novo perfil ao se conectar ao Bigtable.

Para saber como atualizar um perfil de app do padrão para o Data Boost ou do Data Boost para o padrão, consulte Converter um perfil de app.

Atualizar um perfil de app Standard

Para atualizar um perfil padrão de app, siga estas etapas:

Console

1. No console do Google Cloud , abra a lista de instâncias do Bigtable.

   Abrir a lista de instâncias

2. Clique na instância com o perfil do app que você quer atualizar.

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

4. Clique em Editar perfil de aplicativo no perfil que você quer atualizar.

5. Atualize as configurações conforme necessário.

6. Clique em Salvar ou, para sair sem salvar, clique em Cancelar.

gcloud

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

   gcloud bigtable instances list
   

2. Caso você não saiba o ID 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 conferir as configurações do perfil do app:

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

   Preencha o seguinte:

   • 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] \
       [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...]
       [--route-to=CLUSTER_ID] \
       [--transactional-writes] \
       [--row-affinity]
   

   Preencha o seguinte:

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

   O comando aceita as sinalizações opcionais a seguir:

   • --description=DESCRIPTION: uma descrição detalhada do perfil do app.
   • --force: ignora avisos sobre possíveis problemas e conflitos com outros perfis de apps.

   • --route-any: ative o roteamento de vários clusters para encaminhar solicitações a qualquer cluster disponível.

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

   • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: uma lista de clusters para os quais as solicitações precisam ser roteadas. Use essa opção se quiser rotear solicitações para apenas alguns dos clusters na instância.

     Não é possível combinar essa 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. Essa sinalização ativa o encaminhamento de cluster único.

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

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

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

   • --priority=PRIORITY: o nível de prioridade usado pelo perfil de app. Os valores aceitos são PRIORITY_HIGH, PRIORITY_MEDIUM ou PRIORITY_LOW.

Atualizar um perfil de app da camada na memória

Visualizar

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Para atualizar um perfil de app em um cluster com o nível na memória ativado, siga estas etapas:

Console

Observação: não é possível ativar o roteamento por afinidade de linha para um perfil de app com nível na memória no console do Google Cloud .

1. No console do Google Cloud , abra a lista de instâncias do Bigtable.

   Abrir a lista de instâncias

2. Clique na instância com o perfil do app que você quer atualizar.

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

4. Clique em Editar perfil de aplicativo no perfil que você quer atualizar.

5. Atualize as configurações conforme necessário.

6. Clique em Salvar ou, para sair sem salvar, clique em Cancelar.

gcloud

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

   gcloud bigtable instances list
   

2. Caso você não saiba o ID 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 gcloud bigtable app-profiles describe para conferir as configurações do perfil do app:

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

   Preencha o seguinte:

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

4. Use o comando gcloud beta bigtable app-profiles update para atualizar as configurações do perfil de aplicativo:

   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]
   

   Preencha o seguinte:

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

   O comando aceita as sinalizações opcionais a seguir:

   • --description=DESCRIPTION: uma descrição detalhada do perfil do app.
   • --route-to=CLUSTER_ID: código do cluster ao qual todas as solicitações serão roteadas. Essa sinalização ativa o encaminhamento de cluster único.
   • --transactional-writes: ative as transações de linha única no perfil do app.
   • --priority=PRIORITY: o nível de prioridade usado pelo perfil de app. Os valores aceitos são PRIORITY_HIGH, PRIORITY_MEDIUM ou PRIORITY_LOW.
   • --use-memory-layer: encaminha solicitações de rota com este perfil de app para a camada na memória. Use --no-use-memory-layer para desativar o roteamento da camada na memória para este perfil de app. Essa flag é limitada à edição Enterprise Plus e ao roteamento de cluster único.

Atualizar um perfil de app do Data Boost

Para atualizar o cluster de que um perfil de app do Data Boost lê, siga estas etapas:

Console

1. No console do Google Cloud , abra a lista de instâncias do Bigtable.

   Abrir a lista de instâncias

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

   Se o perfil do app que você quer editar não aparecer, clique no nome da instância e em Perfis de aplicativo no painel à esquerda para conferir uma lista completa.

3. Selecione o novo cluster para onde o tráfego será encaminhado e clique em Salvar.

gcloud

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

   gcloud bigtable instances list
   

2. Caso você não saiba o ID 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 gcloud bigtable app-profiles describe para conferir as configurações do perfil do app:

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

   Preencha o seguinte:

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

4. Use o comando gcloud beta bigtable app-profiles update para atualizar as configurações do perfil de aplicativo:

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

   Preencha o seguinte:

   • APP_PROFILE_ID: identificador permanente do perfil de aplicativo.
   • INSTANCE_ID: identificador permanente da instância
   • CLUSTER_ID: o ID do novo cluster de leitura.

Converter um perfil de app

É possível converter um perfil de app padrão em um perfil de app do Data Boost ou converter um perfil de app do Data Boost em um perfil de app padrão. Antes de converter um perfil de app, leia as orientações em Mudanças no perfil de app.

Converter do modo padrão para o Data Boost

Antes de atualizar um perfil de app do padrão (nós provisionados para computação) para a computação sem servidor do Data Boost, confira as métricas de qualificação do Data Boost. Também é importante conhecer as limitações do Data Boost.

Observação: para usar os recursos avançados do Data Boost, sua instância precisa usar a edição Enterprise Plus.

Console

1. No console do Google Cloud , abra a lista de instâncias do Bigtable.

   Abrir a lista de instâncias

2. Na coluna Perfis de aplicativos, clique no perfil que você quer 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. Selecione Data Boost.

4. Selecione o cluster para onde as solicitações serão encaminhadas.

5. Clique em Salvar.

gcloud

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

   gcloud bigtable instances list
   

2. Caso você não saiba o ID 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 conferir as configurações do perfil do app:

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

   Preencha o seguinte:

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

4. Use o comando gcloud beta bigtable app-profiles update para converter um perfil de app de padrão para 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
   

   Preencha o seguinte:

   • APP_PROFILE_ID: identificador permanente do perfil de aplicativo.
   • INSTANCE_ID: identificador permanente da instância
   • CLUSTER_ID: código do cluster ao qual todas as solicitações serão roteadas. Essa sinalização ativa o encaminhamento de cluster único.

Converter do Data Boost para o padrão

Para mudar um perfil de app do uso do Data Boost (computação sem servidor) para padrão (nós provisionados para computação), siga estas etapas:

Console

1. No console do Google Cloud , abra a lista de instâncias do Bigtable.

   Abrir a lista de instâncias

2. Na coluna Perfis de aplicativos, clique no perfil que você quer 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. Selecione Standard.

4. Clique em Próxima.

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

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

7. Se você escolher Cluster único:

   1. Na lista Cluster, selecione o cluster para onde as solicitações serão encaminhadas.

   2. Se você precisar ativar transações de linha única, marque a caixa de seleção Permitir transações de linha única.

8. Se você escolher Vários clusters:

   1. Na lista Grupo de clusters, para rotear solicitações para qualquer cluster na instância, selecione Qualquer cluster.
   2. Para limitar o roteamento de solicitações a apenas alguns clusters na instância (roteamento do grupo de clusters), selecione cada cluster que você quer incluir no grupo de roteamento e clique em OK.
   3. Para rotear solicitações de leitura e gravação de linha única para um cluster específico com base na chave de linha da solicitação, selecione Ativar afinidade de linha.

9. Em Selecionar uma prioridade de roteamento, atribua uma prioridade às suas solicitações selecionando uma das seguintes opções:

   • Alta: use para solicitações sensíveis à latência.
   • Médio: use para solicitações de uso geral
   • Baixa: use para tarefas em segundo plano ou operações menos urgentes.

10. Clique em Salvar.

gcloud

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

   gcloud bigtable instances list
   

2. Caso você não saiba o ID 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 conferir as configurações do perfil do 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 de 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]
   

Preencha o seguinte:

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

O comando aceita as sinalizações opcionais a seguir:

• --route-any: ative o roteamento de vários clusters para encaminhar solicitações a qualquer cluster disponível.

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

• --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: uma lista de clusters para os quais as solicitações precisam ser roteadas. Use essa opção se quiser rotear solicitações para apenas alguns dos clusters na instância.

  Não é possível combinar essa 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. Essa sinalização ativa o encaminhamento de cluster único.

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

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

  Não é possível combinar essa flag com as flags --route-any ou --restrict-to.

Excluir um perfil de app

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

Aviso :não exclua um perfil personalizado que um aplicativo ainda esteja usando. Após excluir um perfil de aplicativo personalizado, qualquer solicitação que use esse aplicativo apresentará falhas.

Para excluir um perfil de aplicativo personalizado:

Console

1. No console do Google Cloud , abra a lista de instâncias do Bigtable.

   Abrir a lista de instâncias

2. Clique na instância em que está 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. Se você não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do projeto:

   gcloud bigtable instances list
   

2. Caso você não saiba o ID 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 do aplicativo:

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

   Preencha o seguinte:

   • 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 avisos sobre possíveis problemas e conflitos com outros perfis de apps.