Atualizar bibliotecas de cliente

Esta página explica como atualizar uma biblioteca de cliente do Cloud Bigtable instalada anteriormente. Se precisar de instalar uma biblioteca cliente pela primeira vez, siga as instruções para a sua linguagem de programação preferida em Bibliotecas cliente do Cloud Bigtable.

Cliente HBase para Java

Se estiver a atualizar a partir da versão 1.0 ou posterior do cliente HBase para Java, a única alteração que tem de fazer é atualizar o número da versão na configuração. Não precisa de atualizar o código.

Se estiver a atualizar a partir de clientes HBase anteriores à versão 1.0, conclua os seguintes passos:

  1. Atualize as suas dependências para usar a biblioteca cliente mais recente e remover artefactos de que já não precisa:

    • Remova os artefactos bigtable-hbase-1.0, bigtable-hbase-1.1 e bigtable-hbase-1.2 das suas dependências, se estiverem presentes.

    • Remova netty-tcnative-boringssl-static das suas dependências, a menos que outra parte da sua aplicação o exija.

    • Adicione um dos seguintes artefactos às suas dependências, consoante o seu exemplo de utilização. As versões 2.x incluem um cliente assíncrono do HBase que as versões 1.x não têm.

      • bigtable-hbase-1.x ou bigtable-hbase-2.x: use para aplicações autónomas onde tem o controlo das suas dependências.
      • bigtable-hbase-1.x-hadoop ou bigtable-hbase-2.x-hadoop: use em ambientes Hadoop.
      • bigtable-hbase-1.x-shaded ou bigtable-hbase-2.x-shaded: use em ambientes que não sejam o Hadoop e que exijam versões anteriores de componentes, como o protobuf ou o Guava.

  2. Atualize as definições de configuração para estabelecer ligação ao Bigtable.

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

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

    • Se usar um ficheiro hbase-site.xml para estabelecer ligação ao Bigtable:

      • Adicione a propriedade google.bigtable.instance.id se não estiver presente. Defina o valor da propriedade para o ID da instância.
      • Remova a propriedade google.bigtable.cluster.name se estiver presente.
      • Remova a propriedade google.bigtable.zone.name, se estiver presente.

    • Se se ligar ao Bigtable chamando BigtableConfiguration.connect(), atualize o seu código conforme mostrado no exemplo seguinte:

      // Old code
BigtableConfiguration.connect(projectId, zone, clusterId);

// New code
BigtableConfiguration.connect(projectId, instanceId);

  3. Volte a implementar a sua aplicação em todos os seus ambientes, incluindo desenvolvimento local, testes, preparação e produção.

Para ver uma lista de lançamentos do cliente HBase para Java, consulte o histórico de lançamentos no GitHub.

Go

Em junho de 2016, o cliente Go alterou a forma de estabelecer ligação ao Bigtable. Em vez de especificar um ID do cluster e uma zona, especifique um ID da instância. Pode encontrar o ID da instância visitando a Google Cloud consola.

Para transferir a biblioteca de cliente, visite 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 lançamentos da biblioteca cliente Go, consulte o histórico de lançamentos no GitHub.

O que se segue?