Upgrade delle librerie client

Questa pagina spiega come eseguire l'upgrade di una libreria client Cloud Bigtable installata in precedenza. Se devi installare una libreria client per la prima volta, segui le istruzioni per il tuo linguaggio di programmazione preferito nella pagina Librerie client Cloud Bigtable.

Client HBase per Java

Se esegui l'upgrade dalla versione 1.0 o successiva del client HBase per Java, l'unica modifica da apportare è aggiornare il numero di versione nella configurazione. Non è necessario aggiornare il codice.

Se esegui l'upgrade da client HBase pre-1.0, completa i seguenti passaggi:

  1. Aggiorna le dipendenze per utilizzare la libreria client più recente e rimuovere gli elementi non più necessari:

    • Se presenti, rimuovi gli elementi bigtable-hbase-1.0, bigtable-hbase-1.1 e bigtable-hbase-1.2 dalle dipendenze.

    • Rimuovi netty-tcnative-boringssl-static dalle dipendenze a meno che non sia richiesto da un'altra parte dell'applicazione.

    • Aggiungi uno dei seguenti elementi alle dipendenze, a seconda del tuo caso d'uso. Le versioni 2.x includono un client asincrono HBase che non è presente nelle versioni 1.x.

      • bigtable-hbase-1.x o bigtable-hbase-2.x: da utilizzare per applicazioni autonome in cui hai il controllo delle dipendenze.
      • bigtable-hbase-1.x-hadoop o bigtable-hbase-2.x-hadoop: da utilizzare negli ambienti Hadoop.
      • bigtable-hbase-1.x-shaded o bigtable-hbase-2.x-shaded: da utilizzare in ambienti diversi da Hadoop che richiedono versioni precedenti di componenti come protobuf o Guava.

  2. Aggiorna le impostazioni di configurazione per la connessione a Bigtable.

    • Se le impostazioni di configurazione nel codice o in un file hbase-site.xml includono un valore per hbase.client.connection.impl, imposta il valore su com.google.cloud.bigtable.hbase1_x.BigtableConnection.

    • Se utilizzi direttamente la classe BigtableConnection, aggiorna il codice in modo da utilizzare com.google.cloud.bigtable.hbase1_x.BigtableConnection.

    • Se utilizzi un file hbase-site.xml per connetterti a Bigtable:

      • Aggiungi la proprietà google.bigtable.instance.id se non è presente. Imposta il valore della proprietà sull'ID istanza.
      • Rimuovi la proprietà google.bigtable.cluster.name se è presente.
      • Rimuovi la proprietà google.bigtable.zone.name, se presente.

    • Se ti connetti a Bigtable chiamando BigtableConfiguration.connect(), aggiorna il codice come mostrato nell' esempio seguente:

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

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

  3. Riimplementa l'applicazione in tutti gli ambienti, inclusi sviluppo locale, test, gestione temporanea e produzione.

Per un elenco delle release del client HBase per Java, consulta la cronologia delle release su GitHub.

Vai

A giugno 2016, il client Go ha modificato il modo di connettersi a Bigtable. Anziché specificare un ID cluster e una zona, specifica un ID istanza. Puoi trovare l'ID istanza visitando la Google Cloud console.

Per scaricare la libreria client, visita il repository di codice su GitHub.

Aggiorna il codice come mostrato di seguito:

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

Per un elenco delle release della libreria client Go, consulta la cronologia delle release su GitHub.

Passaggi successivi