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 relative al tuo linguaggio di programmazione preferito in Librerie client di Cloud Bigtable.
Client HBase per Java
Se esegui l'upgrade dalla versione 1.0 o successiva del client HBase per Java, l'unica modifica che devi apportare è aggiornare il numero di versione nella configurazione. Non è necessario aggiornare il codice.
Se esegui l'upgrade da client HBase precedenti alla versione 1.0, completa questi passaggi:
Aggiorna le dipendenze per utilizzare la libreria client più recente e rimuovi gli artefatti che non ti servono più:
Rimuovi gli artefatti
bigtable-hbase-1.0
,bigtable-hbase-1.1
ebigtable-hbase-1.2
dalle dipendenze, se presenti.Rimuovi
netty-tcnative-boringssl-static
dalle dipendenze, a meno che non sia richiesto da un'altra parte dell'applicazione.Aggiungi uno dei seguenti artefatti alle tue dipendenze, a seconda del tuo caso d'uso. Le versioni
2.x
includono un client asincrono HBase che le versioni1.x
non dispongono.bigtable-hbase-1.x
obigtable-hbase-2.x
: da utilizzare per le applicazioni autonome in cui hai il controllo delle dipendenze.bigtable-hbase-1.x-hadoop
obigtable-hbase-2.x-hadoop
: da usare negli ambienti Hadoop.bigtable-hbase-1.x-shaded
obigtable-hbase-2.x-shaded
: da utilizzare in ambienti diversi da Hadoop che richiedono versioni precedenti di componenti, come protobuf o Guava.
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 perhbase.client.connection.impl
, modifica il valore incom.google.cloud.bigtable.hbase1_x.BigtableConnection
.Se utilizzi direttamente il corso
BigtableConnection
, aggiorna il codice in modo da utilizzare invececom.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à sul tuo ID istanza. - Rimuovi la proprietà
google.bigtable.cluster.name
, se è presente. - Rimuovi la proprietà
google.bigtable.zone.name
, se presente.
- Aggiungi la proprietà
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);
Esegui di nuovo il deployment dell'applicazione in tutti i tuoi 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.
Go
Nel giugno 2016, il client Go ha cambiato 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 console Google Cloud.
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 per la libreria client Go, consulta la cronologia delle release su GitHub.
Passaggi successivi
- Scopri di più sulle librerie client.
- Scopri di più sull'integrazione di Bigtable con altri strumenti e servizi Google Cloud.