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, se estiverem presentes.

    • Remova netty-tcnative-boringssl-static das dependências, a não ser que ele seja exigido por outra parte do aplicativo.

    • Adicione um dos artefatos a seguir às dependências, dependendo do seu caso de uso. As versões 2.x incluem um cliente assíncrono HBase que as versões 1.x não têm.

      • bigtable-hbase-1.x ou bigtable-hbase-2.x: use para aplicativos independentes em que você controla as dependências.
      • bigtable-hbase-1.x-hadoop ou bigtable-hbase-2.x-hadoop: use em ambientes do Hadoop.
      • bigtable-hbase-1.x-shaded ou bigtable-hbase-2.x-shaded: use em ambientes que não sejam o Hadoop que exigem versões anteriores de componentes, como protobuf ou Guava.

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

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

    • Se você usa a classe BigtableConnection diretamente, atualize seu código para passar a usar com.google.cloud.bigtable.hbase1_x.BigtableConnection.

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

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

    • Se você se conectar ao 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 ID de cluster e uma zona, especifique o ID da instância. Para encontrar o ID da instância, acesse o consoleGoogle Cloud .

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.

A seguir