Actualiza las bibliotecas cliente

En esta página, se explica cómo actualizar una biblioteca cliente de Cloud Bigtable instalada previamente. Si necesitas instalar una biblioteca cliente por primera vez, sigue las instrucciones correspondientes al lenguaje de programación que prefieras en Bibliotecas cliente de Cloud Bigtable.

Cliente de HBase para Java

Si actualizas desde la versión1.0 o posterior del cliente HBase para Java, el único cambio que debes hacer es actualizar el número de versión en la configuración. No debes actualizar el código.

Si actualizas desde una versión del cliente de HBase anterior a la 1.0, sigue estos pasos:

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

    • Quita los artefactos bigtable-hbase-1.0, bigtable-hbase-1.1 y bigtable-hbase-1.2 de tus dependencias si están presentes.

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

    • Agrega uno de los siguientes artefactos a tus dependencias:

  2. Actualiza tu configuración para conectarte con Cloud Bigtable.

    • Si los parámetros de configuración en tu código o en 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 tu código para usar com.google.cloud.bigtable.hbase1_x.BigtableConnection en su lugar.

    • Si usas un archivo hbase-site.xml para conectarte a Cloud Bigtable, haz lo siguiente:

      • Agrega la propiedad google.bigtable.instance.id si no está presente. Configura el valor de la propiedad con el ID de tu instancia.
      • Quita la propiedad google.bigtable.cluster.name si está presente.
      • Quita la propiedad google.bigtable.zone.name si está presente.
    • Si te conectas a Cloud Bigtable mediante una llamada 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 la aplicación en todos los entornos, incluido los de desarrollo local, de pruebas, de etapas y de producción.

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

Go

En junio de 2016, el cliente de Go cambió su forma de conectarse con Cloud Bigtable. En lugar de especificar un ID de clúster y una zona, especifica un ID de la instancia. Para encontrar el ID de la instancia, visita Google Cloud Console.

Si deseas descargar la biblioteca cliente, visita el repositorio del código en GitHub.

Actualiza tu código como se muestra 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 actualizaciones de la biblioteca cliente de Go, consulta el historial de actualizaciones en GitHub.

Próximos pasos