クライアント ライブラリのアップグレード
このページでは、以前にインストールした Cloud Bigtable クライアント ライブラリをアップグレードする方法について説明します。クライアント ライブラリを初めてインストールする必要がある場合は、Cloud Bigtable クライアント ライブラリにあるご希望のプログラミング言語の手順を実施してください。
Java 用 HBase クライアント
Java 用 HBase クライアントのバージョン 1.0 以降からアップグレードする場合に必要な変更は、構成内のバージョン番号の更新のみです。コードの更新は必要ありません。
1.0 より前の HBase クライアントからアップグレードする場合は、以下の手順を実施してください。
最新のクライアント ライブラリを使用するように依存関係を更新し、不要になったアーティファクトを削除します。
bigtable-hbase-1.0
、bigtable-hbase-1.1
、およびbigtable-hbase-1.2
アーティファクト(存在する場合)を依存関係から削除します。アプリケーションの他の部分で必要ない場合は、
netty-tcnative-boringssl-static
を依存関係から削除します。ユースケースに応じて、次のいずれかのアーティファクトを依存関係に追加します。
2.x
バージョンには、1.x
バージョンにはない HBase 非同期クライアントが含まれています。
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);
ローカル開発、テスト、ステージング、本番など、すべての環境にアプリケーションを再デプロイします。
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 のリリース履歴をご覧ください。
次のステップ
- クライアント ライブラリの詳細を確認する。
- Bigtable と他のツールおよび Google Cloud サービスの統合方法について確認する。