Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Clientbibliotheken aktualisieren
Auf dieser Seite wird gezeigt, wie Sie ein Upgrade einer zuvor installierten Cloud Bigtable-Clientbibliothek durchführen. Wenn Sie eine Clientbibliothek zum ersten Mal installieren müssen, folgen Sie der Anleitung für Ihre bevorzugte Programmiersprache unter Cloud Bigtable-Clientbibliotheken.
HBase-Client für Java
Wenn Sie für den HBase-Client für Javaab Version 1.0 ein Upgrade ausführen möchten, müssen Sie nur die Versionsnummer in der Konfiguration aktualisieren. Der Code muss nicht aktualisiert werden.
Wenn Sie den HBase-Client vor Version 1.0 aktualisieren möchten, führen Sie die folgenden Schritte aus:
Aktualisieren Sie Ihre Abhängigkeiten, um die neueste Clientbibliothek zu verwenden, und entfernen Sie Artefakte, die Sie nicht mehr benötigen:
Entfernen Sie, sofern vorhanden, die Artefakte bigtable-hbase-1.0, bigtable-hbase-1.1 und bigtable-hbase-1.2 aus den Abhängigkeiten.
Entfernen Sie netty-tcnative-boringssl-static aus den Abhängigkeiten, sofern dies nicht für einen anderen Teil Ihrer Anwendung erforderlich ist.
Fügen Sie Ihren Abhängigkeiten je nach Anwendungsfall eines der folgenden Artefakte hinzu. Die 2.x-Versionen enthalten einen asynchronen HBase-Client, den die 1.x-Versionen nicht haben.
bigtable-hbase-1.x oder bigtable-hbase-2.x: Wird für eigenständige Anwendungen verwendet, in denen Sie die Kontrolle über Ihre Abhängigkeiten haben.
bigtable-hbase-1.x-hadoop oder bigtable-hbase-2.x-hadoop: Verwendung in Hadoop-Umgebungen.
bigtable-hbase-1.x-shaded oder bigtable-hbase-2.x-shaded: Verwendung in anderen Umgebungen als Hadoop, für die ältere Versionen von Komponenten wie protobuf oder Guava erforderlich sind.
Aktualisieren Sie Ihre Konfigurationseinstellungen zur Verbindungsherstellung mit Bigtable.
Wenn die Konfigurationseinstellungen in Ihrem Code oder in einer hbase-site.xml-Datei einen Wert für hbase.client.connection.impl enthalten, müssen Sie den Wert in com.google.cloud.bigtable.hbase1_x.BigtableConnection ändern.
Wenn Sie die Klasse BigtableConnection direkt verwenden, aktualisieren Sie den Code, sodass stattdessen com.google.cloud.bigtable.hbase1_x.BigtableConnection verwendet wird.
Wenn Sie eine hbase-site.xml-Datei verwenden, um eine Verbindung zu Bigtable herzustellen:
Fügen Sie das Attribut google.bigtable.instance.id hinzu, falls es nicht vorhanden ist. Legen Sie den Attributwert als Ihre Instanz-ID fest.
Entfernen Sie das Attribut google.bigtable.cluster.name, sofern vorhanden.
Entfernen Sie das Attribut google.bigtable.zone.name, sofern vorhanden.
Wenn Sie eine Verbindung zu Bigtable durch Aufrufen von BigtableConfiguration.connect() herstellen, aktualisieren Sie Ihren Code wie im folgenden Beispiel dargestellt:
// Old codeBigtableConfiguration.connect(projectId,zone,clusterId);// New codeBigtableConfiguration.connect(projectId,instanceId);
Stellen Sie Ihre Anwendung noch einmal in all Ihren Umgebungen bereit, einschließlich der lokalen Entwicklungs-, Test-, Staging- und Produktionsumgebung.
Im Juni 2016 wurde beim Go-Client die Art und Weise geändert, mit der eine Verbindung zu Bigtable hergestellt wird. Geben Sie anstelle einer Cluster-ID und Zone eine Instanz-ID an. Sie finden die Instanz-ID in derGoogle Cloud Console.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-27 (UTC)."],[[["\u003cp\u003eThis guide details how to upgrade existing Cloud Bigtable client libraries, specifically for the HBase client for Java and the Go client.\u003c/p\u003e\n"],["\u003cp\u003eUpgrading the HBase client for Java from version 1.0 or later requires only a version number update in the configuration, while pre-1.0 upgrades require dependency and configuration updates.\u003c/p\u003e\n"],["\u003cp\u003eFor pre-1.0 HBase upgrades, you will have to remove certain artifacts, add new ones, change specific configurations and deploy your updated application.\u003c/p\u003e\n"],["\u003cp\u003eThe Go client update from June 2016 requires switching from specifying a cluster ID and zone to specifying an instance ID in the code, with examples provided.\u003c/p\u003e\n"],["\u003cp\u003eBoth the Java and Go clients have their release histories on their respective Github repos.\u003c/p\u003e\n"]]],[],null,["# Upgrading client libraries\n==========================\n\nThis page explains how to upgrade a previously installed Cloud Bigtable\nclient library. If you need to install a client library for the first time,\nfollow the instructions for your preferred programming language at\n[Cloud Bigtable Client Libraries](/bigtable/docs/reference/libraries).\n\nHBase client for Java\n---------------------\n\nIf you're upgrading from version **1.0 or later** of the [HBase client for Java](https://github.com/googleapis/java-bigtable-hbase), the only change you need to make is to update the version number\nin the configuration. You don't need to update your code.\n\nIf you're upgrading from **pre-1.0** HBase clients, complete the following\nsteps:\n\n1. **Update your dependencies** to use the newest client library and remove\n artifacts that you no longer need:\n\n - Remove the `bigtable-hbase-1.0`, `bigtable-hbase-1.1`, and\n `bigtable-hbase-1.2` artifacts from your dependencies if they are present.\n\n - Remove `netty-tcnative-boringssl-static` from your dependencies\n unless another part of your application requires it.\n\n - Add one of the following artifacts to your dependencies, depending on\n your use case. The `2.x` versions include an HBase async client that the\n `1.x` versions don't have.\n\n - `bigtable-hbase-1.x` or `bigtable-hbase-2.x`: Use for standalone applications where you are in control of your dependencies.\n - `bigtable-hbase-1.x-hadoop` or `bigtable-hbase-2.x-hadoop`: Use in Hadoop environments.\n - `bigtable-hbase-1.x-shaded` or `bigtable-hbase-2.x-shaded`: Use in environments other than Hadoop that require earlier versions of components such as [protobuf](https://github.com/google/protobuf) or [Guava](https://github.com/google/guava).\n2. **Update your configuration settings** for connecting to\n Bigtable.\n\n - If the configuration settings in your code or in an `hbase-site.xml`\n file include a value for `hbase.client.connection.impl`, change\n the value to `com.google.cloud.bigtable.hbase1_x.BigtableConnection`.\n\n - If you use the `BigtableConnection` class directly, update your code to\n use `com.google.cloud.bigtable.hbase1_x.BigtableConnection` instead.\n\n - If you use an `hbase-site.xml` file to connect to Bigtable:\n\n - Add the property `google.bigtable.instance.id` if it is not present. Set the property value to your instance ID.\n - Remove the property `google.bigtable.cluster.name` if it is present.\n - Remove the property `google.bigtable.zone.name` if it is present.\n - If you connect to Bigtable by calling\n `BigtableConfiguration.connect()`, update your code as shown in the\n following example:\n\n // Old code\n BigtableConfiguration.connect(projectId, zone, clusterId);\n\n // New code\n BigtableConfiguration.connect(projectId, instanceId);\n\n3. **Redeploy your application** in all of your environments, including local\n development, testing, staging, and production.\n\nFor a list of releases for the HBase client for Java, see the\n[release history on GitHub](https://github.com/googleapis/java-bigtable-hbase/releases).\n\nGo\n---\n\nIn June 2016, the Go client changed the way to connect to\nBigtable. Instead of specifying a cluster ID and zone, specify\nan instance ID. You can find the instance ID by [visiting the\nGoogle Cloud console](https://console.cloud.google.com/bigtable/instances).\n\nTo download the client library, visit the [code repository on GitHub](https://github.com/GoogleCloudPlatform/google-cloud-go).\n\nUpdate your code as shown below: \n\n // Old code\n adminClient, err := bigtable.NewAdminClient(ctx, project, zone, cluster)\n client, err := bigtable.NewClient(ctx, project, zone, cluster)\n\n // New code\n adminClient, err := bigtable.NewAdminClient(ctx, project, instance)\n client, err := bigtable.NewClient(ctx, project, instance)\n\nFor a list of releases for the Go client library, see the\n[release history on GitHub](https://github.com/GoogleCloudPlatform/google-cloud-go/releases).\n\nWhat's next\n-----------\n\n- Read more about [client libraries](/bigtable/docs/reference/libraries).\n- Learn more about how Bigtable [integrates with other tools and Google Cloud services](/bigtable/docs/integrations)."]]
