Actualizar bibliotecas de cliente

En esta página se explica cómo actualizar una biblioteca cliente de Cloud Bigtable que ya se haya instalado. Si tienes que instalar una biblioteca de cliente por primera vez, sigue las instrucciones del lenguaje de programación que prefieras en Bibliotecas de cliente de Cloud Bigtable.

Cliente de HBase para Java

Si vas a actualizar desde la versión 1.0 o una posterior del cliente de HBase para Java, lo único que tienes que hacer es actualizar el número de versión en la configuración. No es necesario que actualice el código.

Si vas a actualizar clientes de HBase de versiones anteriores a la 1.0, sigue estos pasos:

  1. Actualiza tus dependencias para usar la biblioteca de cliente más reciente y elimina los artefactos que ya no necesites:

    • Elimina los artefactos bigtable-hbase-1.0, bigtable-hbase-1.1 y bigtable-hbase-1.2 de tus dependencias, si los hay.

    • Quita netty-tcnative-boringssl-static de tus dependencias a menos que otra parte de tu aplicación lo requiera.

    • Añade uno de los siguientes artefactos a tus dependencias, en función de tu caso de uso. Las versiones de 2.x incluyen un cliente asíncrono de HBase que no tienen las versiones de 1.x.

      • bigtable-hbase-1.x o bigtable-hbase-2.x: se usa en aplicaciones independientes en las que tienes el control de tus dependencias.
      • bigtable-hbase-1.x-hadoop o bigtable-hbase-2.x-hadoop: se usan en entornos de Hadoop.
      • bigtable-hbase-1.x-shaded o bigtable-hbase-2.x-shaded: se usa en entornos distintos de Hadoop que requieren versiones anteriores de componentes como protobuf o Guava.

  2. Actualiza los ajustes de configuración para conectarte a Bigtable.

    • Si los ajustes de configuración de tu código o de un archivo hbase-site.xml incluyen un valor para hbase.client.connection.impl, cambia el valor a com.google.cloud.bigtable.hbase1_x.BigtableConnection.

    • Si usas la clase BigtableConnection directamente, actualiza el código para usar com.google.cloud.bigtable.hbase1_x.BigtableConnection.

    • Si usas un archivo hbase-site.xml para conectarte a Bigtable, sigue estos pasos:

      • Añade la propiedad google.bigtable.instance.id si no está presente. Asigne a la propiedad el valor de su ID de instancia.
      • Elimina la propiedad google.bigtable.cluster.name si está presente.
      • Elimina la propiedad google.bigtable.zone.name si está presente.

    • Si te conectas a Bigtable llamando a BigtableConfiguration.connect(), actualiza tu código como se muestra en el siguiente ejemplo:

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

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

  3. Vuelve a implementar tu aplicación en todos tus entornos, incluidos los de desarrollo local, pruebas, staging y producción.

Para ver una lista de las versiones del cliente de HBase para Java, consulta el historial de versiones en GitHub.

Go

En junio del 2016, el cliente de Go cambió la forma de conectarse a Bigtable. En lugar de especificar un ID de clúster y una zona, especifica un ID de instancia. Puedes encontrar el ID de instancia en la consola deGoogle Cloud .

Para descargar la biblioteca de cliente, visita el repositorio de código en GitHub.

Actualice el código como se indica a continuación:

// 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 una lista de las versiones de la biblioteca de cliente de Go, consulta el historial de versiones en GitHub.

Siguientes pasos