Migrasi dari HBase Client ke Tablestore HBase Client - Tablestore

Tablestore HBase Client dienkapsulasi berdasarkan HBase Client. Meskipun penggunaannya serupa dengan HBase Client, terdapat beberapa perbedaan. Topik ini menjelaskan cara bermigrasi dari HBase Client ke Tablestore HBase Client.

Prosedur

Langkah 1: Impor Tablestore dependensi HBase Client

Kode berikut menunjukkan isi file konfigurasi pom.xml dari Tablestore HBase Client V2.0.12:

 <dependencies>
    <dependency>
        <groupId>com.aliyun.openservices</groupId>
        <artifactId>tablestore-hbase-client</artifactId>
        <version>2.0.12</version>
    </dependency>
</dependencies>

Langkah 2: Modifikasi file konfigurasi

Untuk bermigrasi dari HBase Client ke Tablestore HBase Client, ubah tipe HBase Connection dan tambahkan parameter-parameter Tablestore dalam file konfigurasi hbase-site.xml.

1. Ubah tipe HBase Connection

Atur tipe HBase Connection menjadi TablestoreConnection.

<property>
    <name>hbase.client.connection.impl</name>
    <value>com.alicloud.tablestore.hbase.TablestoreConnection</value>
</property>

2. Tambahkan parameter-parameter Tablestore

Tablestore adalah layanan cloud yang menyediakan manajemen izin yang ketat. Untuk mengakses Tablestore, Anda harus mengonfigurasi parameter yang diperlukan seperti pasangan AccessKey dan instance Tablestore. Anda dapat mengonfigurasi parameter opsional berdasarkan kebutuhan bisnis Anda.

Parameter wajib
Anda harus mengonfigurasi parameter wajib seperti pasangan AccessKey dan instance sebelum dapat mengakses Tablestore. Parameter tablestore.client.endpoint menentukan titik akhir dari instance Tablestore yang ingin diakses. Parameter tablestore.client.instancename menentukan nama instance Tablestore yang ingin diakses. Parameter tablestore.client.accesskeyid dan tablestore.client.accesskeysecret menentukan ID AccessKey dan Rahasia AccessKey dari akun Alibaba Cloud atau Pengguna Resource Access Management (RAM).
```
<property>
    <name>tablestore.client.endpoint</name>
    <value>https://exampleinstance.cn-hangzhou.ots.aliyuncs.com</value>
</property>
<property>
    <name>tablestore.client.instancename</name>
    <value>exampleinstance</value>
</property>
<property>
    <name>tablestore.client.accesskeyid</name>
    <value>*****************</value>
</property>
<property>
    <name>tablestore.client.accesskeysecret</name>
    <value>***********</value>
</property>							
```

Parameter opsional

Anda dapat mengonfigurasi parameter opsional seperti nama tabel, jumlah maksimum koneksi, dan periode timeout menggunakan kode contoh berikut.

<property>
    <name>hbase.client.tablestore.family</name>
    <value>f1</value>
</property>
<property>
    <name>hbase.client.tablestore.family.$tablename</name>
    <value>f2</value>
</property>
<property>
    <name>tablestore.client.max.connections</name>
    <value>300</value>
</property>
<property>
    <name>tablestore.client.socket.timeout</name>
    <value>15000</value>
</property>
<property>
    <name>tablestore.client.connection.timeout</name>
    <value>15000</value>
</property>
<property>
    <name>tablestore.client.operation.timeout</name>
    <value>2147483647</value>
</property>
<property>
    <name>tablestore.client.retries</name>
    <value>3</value>
</property>

Tabel berikut menjelaskan parameter opsional.

Parameter	Deskripsi
hbase.client.tablestore.family	Tablestore hanya mendukung keluarga kolom tunggal. Saat memanggil API HBase, Anda harus menentukan isi dari keluarga tersebut. `hbase.client.tablestore.family` menentukan konfigurasi global, dan `hbase.client.tablestore.family.$tablename` menentukan konfigurasi untuk satu tabel. Untuk tabel bernama T, cari `hbase.client.tablestore.family.T`. Jika keluarga tidak ada, cari `hbase.client.tablestore.family`. Jika keluarga tidak ada, gunakan nilai default f.
hbase.client.tablestore.family.$tablename
tablestore.client.max.connections	Jumlah maksimum koneksi. Nilai default: 300.
tablestore.client.socket.timeout	Periode timeout socket. Satuan: detik. Nilai default: 15.
tablestore.client.connection.timeout	Periode timeout koneksi. Satuan: detik. Nilai default: 15.
tablestore.client.operation.timeout	Periode timeout API. Nilai default: `Integer.MAX_VALUE`. Nilai default menentukan bahwa API tidak pernah timeout.
tablestore.client.retries	Jumlah percobaan ulang saat terjadi kegagalan permintaan. Nilai default: 3.

Referensi

Untuk informasi lebih lanjut tentang migrasi data dari HBase ke Tablestore, lihat Data Integration.