クライアント ライブラリのアップグレード

このページでは、以前にインストールした 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 バージョンには、1.x バージョンにはない HBase 非同期クライアントが含まれています。

      • 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: protobuf や Guava などの古いバージョンのコンポーネントを必要とする Hadoop 以外の環境で使用されます。

  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 用 Cloud Bigtable HBase クライアントのリリース一覧については、GitHub のリリース履歴をご覧ください。

Go

2016 年 6 月、Go クライアントは、Bigtable に対する接続方法が変更されました。クラスタ ID とゾーンを指定する代わりに、インスタンス ID を指定します。インスタンス ID は、Google Cloud Console にアクセスして確認できます。

クライアント ライブラリをダウンロードするには、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 のリリース履歴をご覧ください。

次のステップ