Mengupgrade library klien

Halaman ini menjelaskan cara mengupgrade library klien Cloud Bigtable yang diinstal sebelumnya. Jika Anda perlu menginstal library klien untuk pertama kalinya, ikuti petunjuk untuk bahasa pemrograman pilihan Anda di Library Klien Cloud Bigtable.

Klien HBase untuk Java

Jika Anda melakukan upgrade dari versi 1.0 atau yang lebih baru klien HBase untuk Java, satu-satunya perubahan yang perlu Anda lakukan adalah memperbarui nomor versi dalam konfigurasi. Anda tidak perlu memperbarui kode Anda.

Jika Anda mengupgrade dari klien HBase sebelum versi 1.0, selesaikan langkah-langkah berikut:

  1. Update dependensi untuk menggunakan library klien terbaru dan menghapus artefak yang tidak diperlukan lagi:

    • Hapus artefak bigtable-hbase-1.0, bigtable-hbase-1.1, dan bigtable-hbase-1.2 dari dependensi Anda jika ada.

    • Hapus netty-tcnative-boringssl-static dari dependensi Anda kecuali jika ada bagian lain dari aplikasi Anda yang memerlukannya.

    • Tambahkan salah satu artefak berikut ke dependensi Anda, bergantung pada kasus penggunaan Anda. Versi 2.x menyertakan klien asinkron HBase yang tidak dimiliki oleh versi 1.x.

      • bigtable-hbase-1.x atau bigtable-hbase-2.x: Gunakan untuk aplikasi mandiri tempat Anda mengontrol dependensi Anda.
      • bigtable-hbase-1.x-hadoop atau bigtable-hbase-2.x-hadoop: Gunakan di lingkungan Hadoop.
      • bigtable-hbase-1.x-shaded atau bigtable-hbase-2.x-shaded: Digunakan di lingkungan selain Hadoop yang memerlukan versi komponen yang lebih lama seperti protobuf atau Guava.

  2. Perbarui setelan konfigurasi untuk terhubung ke Bigtable.

    • Jika setelan konfigurasi dalam kode Anda atau dalam file hbase-site.xml menyertakan nilai untuk hbase.client.connection.impl, ubah nilainya menjadi com.google.cloud.bigtable.hbase1_x.BigtableConnection.

    • Jika Anda menggunakan class BigtableConnection secara langsung, perbarui kode untuk menggunakan com.google.cloud.bigtable.hbase1_x.BigtableConnection.

    • Jika Anda menggunakan file hbase-site.xml untuk terhubung ke Bigtable:

      • Tambahkan properti google.bigtable.instance.id jika tidak ada. Tetapkan nilai properti ke ID instance Anda.
      • Hapus properti google.bigtable.cluster.name jika ada.
      • Hapus properti google.bigtable.zone.name jika ada.

    • Jika Anda terhubung ke Bigtable dengan memanggil BigtableConfiguration.connect(), perbarui kode Anda seperti yang ditunjukkan pada contoh berikut:

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

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

  3. Deploy ulang aplikasi di semua lingkungan, termasuk pengembangan, pengujian, staging, dan produksi lokal.

Untuk mengetahui daftar rilis klien HBase untuk Java, lihat histori rilis di GitHub.

Go

Pada Juni 2016, klien Go mengubah cara untuk terhubung ke Bigtable. Daripada menetapkan ID cluster dan zona, sebaiknya tentukan ID instance. Anda dapat menemukan ID instance dengan mengunjungi Google Cloud Console.

Untuk mendownload library klien, buka repositori kode di GitHub.

Update kode Anda seperti yang ditunjukkan di bawah ini:

// 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)

Untuk mengetahui daftar rilis library klien Go, lihat histori rilis di GitHub.

Langkah selanjutnya