Como atualizar bibliotecas de cliente

Nesta página, você verá como atualizar uma biblioteca de cliente do Cloud Bigtable instalada anteriormente. Caso precise instalar uma pela primeira vez, siga as instruções da linguagem de programação que preferir nas Bibliotecas de cliente do Cloud Bigtable.

Cliente HBase para Java

Se estiver fazendo upgrade da versão 1.0 ou posterior do cliente HBase para Java, será necessário apenas atualizar o número da versão na configuração. Não é preciso atualizar o código.

Se estiver fazendo upgrade de clientes HBase anteriores à 1.0, conclua as etapas a seguir:

  1. Atualize as dependências para usar a biblioteca de cliente mais recente e remova os artefatos desnecessários:

    • Remova os artefatos bigtable-hbase-1.0, bigtable-hbase-1.1 e bigtable-hbase-1.2 das dependências, caso estejam presentes.

    • Remova netty-tcnative-boringssl-static das dependências, a menos ele seja exigido por outra parte do aplicativo.

    • Adicione um dos seguintes artefatos às dependências:

  2. Atualize as configurações para se conectar ao Cloud Bigtable.

    • Se as definições de configuração no código ou em um arquivo hbase-site.xml incluírem um valor para hbase.client.connection.impl, altere-o para com.google.cloud.bigtable.hbase1_x.BigtableConnection.

    • Se usar a classe BigtableConnection diretamente, atualize o código para usar com.google.cloud.bigtable.hbase1_x.BigtableConnection.

    • Se usar um arquivo hbase-site.xml para se conectar ao Cloud Bigtable:

      • Adicione a propriedade google.bigtable.instance.id caso ela não esteja presente. Defina o valor da propriedade para o código da instância.
      • Remova a propriedade google.bigtable.cluster.name caso ela esteja presente.
      • Remova a propriedade google.bigtable.zone.name caso ela esteja presente.
    • Ao se conectar ao Cloud Bigtable chamando BigtableConfiguration.connect(), atualize o código conforme mostrado no exemplo a seguir:

      // Old code
      BigtableConfiguration.connect(projectId, zone, clusterId);
      
      // New code
      BigtableConfiguration.connect(projectId, instanceId);
      
  3. Reimplante o aplicativo em todos os ambientes, incluindo desenvolvimento local, teste, preparação e produção.

Para ver uma lista de versões para o cliente HBase para Java, consulte o histórico de versões no GitHub.

Go

Em junho de 2016, o cliente Go mudou a maneira de se conectar ao Cloud Bigtable. Em vez de especificar um código de cluster e uma zona, especifique um código de instância. Acesse o Console do Google Cloud Platform para ver esse código.

Para fazer o download da biblioteca de cliente, acesse o repositório de código no GitHub.

Atualize o código conforme mostrado abaixo:

// Old code
adminClient, err := bigtable.NewAdminClient(ctx, project, zone, cluster)
client, err := bigtable.NewClient(ctx, project, zone, cluster)

// New code
adminClient, err := bigtable.NewAdminClient(ctx, project, instance)
client, err := bigtable.NewClient(ctx, project, instance)

Para ver uma lista de versões para a biblioteca de cliente Go, consulte o histórico de versões no GitHub.

OpenTSDB

Se estiver usando o Cloud Bigtable por meio do OpenTSDB, conclua as etapas a seguir:

  1. Adicione uma dependência explícita na versão 0.4.0 ou posterior do artefato asyncbigtable.
  2. Atualize o OpenTSDB para a versão 2.3.1 ou posterior.

A seguir

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

Enviar comentários sobre…

Documentação do Cloud Bigtable