升級用戶端程式庫

本頁說明如何將先前安裝的 Cloud BigTable 用戶端程式庫升級。如果您是首次需要安裝用戶端程式庫，請按照 Cloud BigTable 用戶端程式庫中您偏好的程式設計語言操作說明進行。

Java 適用的 HBase 用戶端

如果您是要從 Java 適用的 HBase 用戶端的 1.0 或更新版本進行升級，您只需要更新設定中的版本號碼即可，並不需要更新程式碼。

如果您是要從 1.0 版本之前的 HBase 用戶端進行升級，請完成下列步驟：

  1. 更新依附元件以使用最新的用戶端程式庫，並移除不再需要的成果：

    • 如果 bigtable-hbase-1.0、bigtable-hbase-1.1 和 bigtable-hbase-1.2 構件存在，請將其從依附元件中移除。

    • 除非應用程式的其他部分需要 netty-tcnative-boringssl-static，否則請從依附元件中將其移除。

    • 視用途而定，將下列其中一個構件新增至依附元件。2.x 版本包含 HBase 非同步用戶端，但 1.x 版本沒有。

      • bigtable-hbase-1.x 或 bigtable-hbase-2.x：在您控制依附元件的獨立應用程式中運用將這項成果。
      • bigtable-hbase-1.x-hadoop 或 bigtable-hbase-2.x-hadoop：用於 Hadoop 環境。
      • bigtable-hbase-1.x-shaded 或 bigtable-hbase-2.x-shaded：在 Hadoop 以外的環境中使用，這些環境需要較舊版本的元件，例如 protobuf 或 Guava。

  2. 更新配置設定以連線至 Bigtable。

    • 如果您的程式碼或 hbase-site.xml 檔案中的配置設定包含 hbase.client.connection.impl 的值，請將該值變更為 com.google.cloud.bigtable.hbase1_x.BigtableConnection。

    • 如果您直接使用 BigtableConnection 類別，請將程式碼更新為使用 com.google.cloud.bigtable.hbase1_x.BigtableConnection。

    • 如果您使用 hbase-site.xml 檔案連線至 Bigtable：

      • 如果 google.bigtable.instance.id 屬性不存在，請新增該屬性，並將屬性值設定為執行個體 ID。
      • 如果 google.bigtable.cluster.name 屬性存在，請將其移除。
      • 如果 google.bigtable.zone.name 屬性存在，請將其移除。

    • 如果您透過呼叫 BigtableConfiguration.connect() 連線至 Bigtable，請更新您的程式碼，如同下列範例所示：

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

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

  3. 在本機開發、測試、暫存和實際工作環境等所有環境中重新部署應用程式。

如需 Java 適用的 HBase 用戶端的版本清單，請參閱 GitHub 中的版本記錄。

Go

Go 用戶端在 2016 年 6 月變更了連線至 Bigtable 的方式。請指定執行個體 ID，而不是指定叢集 ID 和區域。您可以前往Google Cloud 控制台來找出執行個體 ID。

如要下載用戶端程式庫，請造訪 GitHub 的程式碼存放區。

請更新程式碼，如下所示：

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

如需 Go 用戶端程式庫的版本清單，請參閱 GitHub 中的版本記錄。

後續步驟