Memigrasikan data dari HBase ke Bigtable

Halaman ini menjelaskan pertimbangan dan proses migrasi data dari cluster Apache HBase ke instance Bigtable di Google Cloud.

Proses yang dijelaskan di halaman ini mengharuskan Anda menjalankan aplikasi secara offline. Jika Anda ingin melakukan migrasi tanpa periode nonaktif, lihat panduan untuk migrasi online di Mereplikasi dari HBase ke Bigtable.

Untuk memigrasikan data ke Bigtable dari cluster HBase yang dihosting di layanan Google Cloud, seperti Dataproc atau Compute Engine, lihat Memigrasikan HBase di Google Cloud ke Bigtable.

Sebelum memulai migrasi ini, Anda harus mempertimbangkan implikasi performa, desain skema Bigtable, pendekatan Anda terhadap autentikasi dan otorisasi, serta kumpulan fitur Bigtable.

Pertimbangan pra-migrasi

Bagian ini menyarankan beberapa hal yang perlu ditinjau dan dipikirkan sebelum Anda memulai migrasi.

Performa

Dalam beban kerja umum, Bigtable memberikan performa yang sangat dapat diprediksi. Pastikan Anda memahami faktor-faktor yang memengaruhi performa Bigtable sebelum memigrasikan data.

Desain skema Bigtable

Pada umumnya, Anda dapat menggunakan desain skema yang sama di Bigtable seperti yang Anda lakukan di HBase. Jika Anda ingin mengubah skema atau jika kasus penggunaan Anda berubah, tinjau konsep yang diuraikan dalam Mendesain skema sebelum memigrasikan data.

Autentikasi dan otorisasi

Sebelum Anda mendesain kontrol akses untuk Bigtable, tinjau proses autentikasi dan otorisasi HBase yang ada.

Bigtable menggunakan mekanisme untuk autentikasi dan Identity and Access Management standar Google Cloud untuk memberikan kontrol akses, sehingga Anda mengonversi otorisasi yang ada di HBase ke IAM. Anda dapat memetakan grup Hadoop yang ada yang menyediakan mekanisme kontrol akses untuk HBase ke akun layanan yang berbeda.

Bigtable memungkinkan Anda mengontrol akses di tingkat project, instance, dan tabel. Untuk informasi selengkapnya, lihat Kontrol Akses.

Persyaratan periode nonaktif

Pendekatan migrasi yang dijelaskan di halaman ini melibatkan penghentian aplikasi Anda selama migrasi. Jika bisnis Anda tidak dapat mentoleransi periode nonaktif saat Anda melakukan migrasi ke Bigtable, lihat panduan untuk migrasi online di Mereplikasi dari HBase ke Bigtable.

Memigrasikan HBase ke Bigtable

Untuk memigrasikan data dari HBase ke Bigtable, Anda harus mengekspor snapshot HBase untuk setiap tabel ke Cloud Storage, lalu mengimpor data ke Bigtable. Langkah-langkah ini ditujukan untuk satu cluster HBase dan dijelaskan secara mendetail di beberapa bagian berikutnya.

1. Berhenti mengirim operasi tulis ke cluster HBase Anda.
2. Mengambil snapshot tabel cluster HBase.
3. Mengekspor file snapshot ke Cloud Storage.
4. Menghitung hash dan mengekspornya ke Cloud Storage.
5. Membuat tabel tujuan di Bigtable.
6. Impor data HBase dari Cloud Storage ke Bigtable.
7. Memvalidasi data yang diimpor.
8. Rute menulis ke Bigtable.

Sebelum memulai

1. Buat bucket Cloud Storage untuk menyimpan snapshot Anda. Buat bucket di lokasi yang sama dengan tempat Anda berencana menjalankan tugas Dataflow.

2. Buat instance Bigtable untuk menyimpan tabel baru Anda.

3. Identifikasi cluster Hadoop yang Anda ekspor. Anda dapat menjalankan tugas untuk migrasi secara langsung di cluster HBase atau di cluster Hadoop terpisah yang memiliki konektivitas jaringan ke Namenode dan Datanode cluster HBase.

4. Instal dan konfigurasikan konektor Cloud Storage di setiap node di cluster Hadoop serta host tempat tugas dimulai. Untuk mengetahui langkah-langkah penginstalan mendetail, lihat Menginstal konektor Cloud Storage.

5. Buka shell perintah di host yang dapat terhubung ke cluster HBase dan project Bigtable Anda. Di sinilah Anda akan menyelesaikan langkah-langkah berikutnya.

6. Dapatkan alat Terjemahan Skema:

   wget BIGTABLE_HBASE_TOOLS_URL
   

   Ganti BIGTABLE_HBASE_TOOLS_URL dengan URL JAR with dependencies terbaru yang tersedia di repositori Maven alat. Nama filenya mirip dengan https://repo1.maven.org/maven2/com/google/cloud/bigtable/bigtable-hbase-1.x-tools/1.24.0/bigtable-hbase-1.x-tools-1.24.0-jar-with-dependencies.jar.

   Untuk menemukan URL atau mendownload JAR secara manual, lakukan tindakan berikut:

   1. Buka repositori.
   2. Klik nomor versi terbaru.
   3. Identifikasi JAR with dependencies file (biasanya di bagian atas).
   4. Klik kanan dan salin URL, atau klik untuk mendownload file.

7. Dapatkan alat Impor:

   wget BIGTABLE_BEAM_IMPORT_URL
   

   Ganti BIGTABLE_BEAM_IMPORT_URL dengan URL shaded JAR terbaru yang tersedia di repositori Maven alat. Nama filenya mirip dengan https://repo1.maven.org/maven2/com/google/cloud/bigtable/bigtable-beam-import/1.24.0/bigtable-beam-import-1.24.0-shaded.jar.

   Untuk menemukan URL atau mendownload JAR secara manual, lakukan hal berikut:

   1. Buka repositori.
   2. Klik nomor versi terbaru.
   3. Klik Hasil download.
   4. Arahkan mouse ke shaded.jar.
   5. Klik kanan dan salin URL, atau klik untuk mendownload file.

8. Tetapkan variabel lingkungan berikut:

   #Google Cloud
   
   export PROJECT_ID=PROJECT_ID
   export INSTANCE_ID=INSTANCE_ID
   export REGION=REGION
   export CLUSTER_NUM_NODES=CLUSTER_NUM_NODES
   
   #JAR files
   
   export TRANSLATE_JAR=TRANSLATE_JAR
   export IMPORT_JAR=IMPORT_JAR
   
   #Cloud Storage
   
   export BUCKET_NAME="gs://BUCKET_NAME"
   export MIGRATION_DESTINATION_DIRECTORY="$BUCKET_NAME/hbase-migration-snap"
   
   #HBase
   
   export ZOOKEEPER_QUORUM=ZOOKEPER_QUORUM
   export ZOOKEEPER_PORT=2181
   export ZOOKEEPER_QUORUM_AND_PORT="$ZOOKEEPER_QUORUM:$ZOOKEEPER_PORT"
   export MIGRATION_SOURCE_DIRECTORY=MIGRATION_SOURCE_DIRECTORY
   

   Ganti kode berikut:

   • PROJECT_ID: project Google Cloud tempat instance Anda berada
   • INSTANCE_ID: ID instance Bigtable tempat Anda mengimpor data
   • REGION: region yang berisi salah satu cluster di instance Bigtable Anda. Contoh: northamerica-northeast2
   • CLUSTER_NUM_NODES: jumlah node dalam instance Bigtable Anda
   • TRANSLATE_JAR: nama dan nomor versi file JAR bigtable hbase tools yang Anda download dari Maven. Nilainya harus terlihat seperti bigtable-hbase-1.x-tools-1.24.0-jar-with-dependencies.jar.
   • IMPORT_JAR: nama dan nomor versi file JAR bigtable-beam-import yang Anda download dari Maven. Nilainya harus terlihat seperti bigtable-beam-import-1.24.0-shaded.jar.
   • BUCKET_NAME: nama bucket Cloud Storage tempat Anda menyimpan snapshot
   • ZOOKEEPER_QUORUM: host zookeeper yang akan dihubungkan oleh alat ini, dalam format host1.myownpersonaldomain.com
   • MIGRATION_SOURCE_DIRECTORY: direktori di host HBase yang menyimpan data yang ingin Anda migrasikan, dalam format hdfs://host1.myownpersonaldomain.com:8020/hbase

9. (Opsional) Untuk mengonfirmasi bahwa variabel telah ditetapkan dengan benar, jalankan perintah printenv untuk melihat semua variabel lingkungan.

Menghentikan pengiriman operasi tulis ke HBase

Sebelum mengambil snapshot tabel HBase, berhenti mengirim operasi tulis ke cluster HBase.

Mengambil snapshot tabel HBase

Saat cluster HBase Anda tidak lagi menyerap data, ambil snapshot setiap tabel yang ingin Anda migrasikan ke Bigtable.

Pada awalnya, snapshot memiliki jejak penyimpanan minimal di cluster HBase, tetapi seiring waktu, ukurannya dapat bertambah menjadi sama dengan tabel asli. Snapshot tidak menggunakan resource CPU apa pun.

Jalankan perintah berikut untuk setiap tabel, menggunakan nama unik untuk setiap snapshot:

echo "snapshot 'TABLE_NAME', 'SNAPSHOT_NAME'" | hbase shell -n

Ganti kode berikut:

• TABLE_NAME: nama tabel HBase tempat Anda mengekspor data.
• SNAPSHOT_NAME: nama untuk snapshot baru

Mengekspor snapshot HBase ke Cloud Storage

Setelah membuat snapshot, Anda perlu mengekspornya. Saat Anda menjalankan tugas ekspor di cluster HBase produksi, pantau cluster dan resource HBase lainnya untuk memastikan cluster tetap dalam status yang baik.

Untuk setiap snapshot yang ingin diekspor, jalankan perintah berikut:

hbase org.apache.hadoop.hbase.snapshot.ExportSnapshot \
-Dhbase.zookeeper.quorum=$ZOOKEEPER_QUORUM_AND_PORT -snapshot SNAPSHOT_NAME \
    -copy-from $MIGRATION_SOURCE_DIRECTORY \
    -copy-to $MIGRATION_DESTINATION_DIRECTORY/data

Ganti SNAPSHOT_NAME dengan nama snapshot yang akan diekspor.

Catatan: Jika Anda perlu membatasi bandwidth yang digunakan ekspor, gunakan parameter -mappers dengan nilai bilangan bulat untuk menentukan jumlah pemetaan yang akan dijalankan dan parameter -bandwidth dengan nilai bilangan bulat untuk MB/detik. Misalnya, untuk membatasi konkurensi tugas peta salinan menjadi 20, tetapkan -mappers 20 dan untuk membatasi bandwidth yang digunakan setiap tugas peta salinan menjadi 50 MB/detik, tambahkan -bandwidth 50 ke perintah. Hal ini membuat total bandwidth menjadi 1.000 MB/dtk (50 MB/dtk * 20 pemetaan = 1.000 MB/dtk).

Menghitung dan mengekspor hash

Selanjutnya, buat hash yang akan digunakan untuk validasi setelah migrasi selesai. HashTable adalah alat validasi yang disediakan oleh HBase yang menghitung hash untuk rentang baris dan mengekspornya ke file. Anda dapat menjalankan tugas sync-table di tabel tujuan untuk mencocokkan hash dan mendapatkan keyakinan dalam integritas data yang dimigrasikan.

Jalankan perintah berikut untuk setiap tabel yang Anda ekspor:

hbase org.apache.hadoop.hbase.mapreduce.HashTable --batchsize=32000 --numhashfiles=20 \
TABLE_NAME $MIGRATION_DESTINATION_DIRECTORY/hashtable/TABLE_NAME

Ganti kode berikut:

• TABLE_NAME: nama tabel HBase yang Anda buat snapshot-nya dan ekspor

Catatan: Untuk migrasi yang lebih besar saat Anda memigrasikan beberapa tabel, Anda dapat menjalankan tugas ExportSnapshot dan HashTable secara paralel. Hal ini dimungkinkan karena tugas ekspor membaca dari disk, dan tugas HashTable sibuk menghitung hash dan memindai HBase. Opsi ini dapat mengurangi periode nonaktif yang diperlukan untuk migrasi.

Membuat tabel tujuan

Langkah berikutnya adalah membuat tabel tujuan di instance Bigtable untuk setiap snapshot yang Anda ekspor. Gunakan akun yang memiliki izin bigtable.tables.create untuk instance.

Panduan ini menggunakan alat Bigtable Schema Translation, yang secara otomatis membuat tabel untuk Anda. Namun, jika tidak ingin skema Bigtable cocok persis dengan skema HBase, Anda dapat membuat tabel menggunakan alat command line cbt atau Konsol Google Cloud.

Alat Bigtable Schema Translation menangkap skema tabel HBase, termasuk nama tabel, grup kolom, kebijakan pembersihan sampah, dan pemisahan. Kemudian, tabel serupa akan dibuat di Bigtable.

Catatan: Jika master HBase Anda berada di virtual private cloud atau Anda tidak dapat terhubung ke internet, Anda dapat mengikuti petunjuk alternatif, bukan petunjuk di bagian ini. Saat menggunakan petunjuk alternatif, Anda akan mengekspor skema HBase ke file, lalu menggunakan file tersebut untuk membuat tabel di Bigtable.

Untuk setiap tabel yang ingin Anda impor, jalankan perintah berikut untuk menyalin skema dari HBase ke Bigtable.

java \
 -Dgoogle.bigtable.project.id=$PROJECT_ID \
 -Dgoogle.bigtable.instance.id=$INSTANCE_ID \
 -Dgoogle.bigtable.table.filter=TABLE_NAME \
 -Dhbase.zookeeper.quorum=$ZOOKEEPER_QUORUM \
 -Dhbase.zookeeper.property.clientPort=$ZOOKEEPER_PORT \
 -jar $TRANSLATE_JAR

Ganti TABLE_NAME dengan nama tabel HBase yang Anda impor. Alat Penerjemahan Skema menggunakan nama ini untuk tabel Bigtable baru Anda.

Anda juga dapat mengganti TABLE_NAME dengan ekspresi reguler, seperti ".*", yang menangkap semua tabel yang ingin Anda buat, lalu menjalankan perintah hanya sekali.

Mengimpor data HBase ke Bigtable menggunakan Dataflow

Setelah memiliki tabel yang siap untuk memigrasikan data, Anda siap untuk mengimpor dan memvalidasi data.

Tabel yang tidak dikompresi

Jika tabel HBase tidak dikompresi, jalankan perintah berikut untuk setiap tabel yang ingin dimigrasikan:

java -jar $IMPORT_JAR importsnapshot \
    --runner=DataflowRunner \
    --project=$PROJECT_ID \
    --bigtableInstanceId=$INSTANCE_ID \
    --bigtableTableId=TABLE_NAME \
    --hbaseSnapshotSourceDir=$MIGRATION_DESTINATION_DIRECTORY/data \
    --snapshotName=SNAPSHOT_NAME \
    --stagingLocation=$MIGRATION_DESTINATION_DIRECTORY/staging \
    --tempLocation=$MIGRATION_DESTINATION_DIRECTORY/temp \
    --maxNumWorkers=$(expr 3 \* $CLUSTER_NUM_NODES) \
    --region=$REGION

Ganti kode berikut:

• TABLE_NAME: nama tabel HBase yang Anda impor. Alat Penerjemahan Skema menggunakan nama ini untuk tabel Bigtable baru Anda. Nama tabel baru tidak didukung.
• SNAPSHOT_NAME: nama yang Anda tetapkan ke snapshot tabel yang Anda impor

Setelah Anda menjalankan perintah, alat ini akan memulihkan snapshot HBase ke bucket Cloud Storage, lalu memulai tugas impor. Mungkin perlu waktu beberapa menit hingga proses pemulihan snapshot selesai, bergantung pada ukuran snapshot.

Perhatikan tips berikut saat Anda mengimpor:

• Untuk meningkatkan performa pemuatan data, pastikan untuk menetapkan maxNumWorkers. Nilai ini membantu memastikan bahwa tugas impor memiliki daya komputasi yang cukup untuk selesai dalam waktu yang wajar, tetapi tidak terlalu banyak sehingga akan membebani instance Bigtable.
  • Jika Anda juga tidak menggunakan instance Bigtable untuk beban kerja lain, kalikan jumlah node di instance Bigtable Anda dengan 3, dan gunakan angka tersebut untuk maxNumWorkers.
  • Jika Anda menggunakan instance untuk beban kerja lain pada saat Anda mengimpor data HBase, kurangi nilai maxNumWorkers dengan semestinya.
• Gunakan jenis pekerja default.
• Selama impor, Anda harus memantau penggunaan CPU instance Bigtable. Jika penggunaan CPU di seluruh instance Bigtable terlalu tinggi, Anda mungkin perlu menambahkan node tambahan. Diperlukan waktu hingga 20 menit agar cluster dapat memberikan manfaat performa dari node tambahan.

Untuk informasi selengkapnya tentang cara memantau instance Bigtable, lihat Memantau instance Bigtable.

Tabel terkompresi Snappy

Jika mengimpor tabel yang dikompresi Snappy, Anda harus menggunakan image penampung kustom di pipeline Dataflow. Image penampung kustom yang Anda gunakan untuk mengimpor data terkompresi ke Bigtable memberikan dukungan library kompresi native Hadoop. Anda harus memiliki Apache Beam SDK versi 2.30.0 atau yang lebih baru untuk menggunakan Dataflow Runner v2, dan Anda harus memiliki library klien HBase versi 2.3.0 atau yang lebih baru untuk Java.

Untuk mengimpor tabel yang dikompresi Snappy, jalankan perintah yang sama yang Anda jalankan untuk tabel yang tidak dikompresi, tetapi tambahkan opsi berikut:

    --enableSnappy=true

Memvalidasi data yang diimpor di Bigtable

Untuk memvalidasi data yang diimpor, Anda perlu menjalankan tugas sync-table. Tugas sync-table menghitung hash untuk rentang baris di Bigtable, lalu mencocokkannya dengan output HashTable yang Anda hitung sebelumnya.

Untuk menjalankan tugas sync-table, jalankan perintah berikut di shell perintah:

java -jar $IMPORT_JAR sync-table  \
    --runner=dataflow \
    --project=$PROJECT_ID \
    --bigtableInstanceId=$INSTANCE_ID \
    --bigtableTableId=TABLE_NAME \
    --outputPrefix=$MIGRATION_DESTINATION_DIRECTORY/sync-table/output-TABLE_NAME-$(date +"%s") \
    --stagingLocation=$MIGRATION_DESTINATION_DIRECTORY/sync-table/staging \
    --hashTableOutputDir=$MIGRATION_DESTINATION_DIRECTORY/hashtable/TABLE_NAME \
    --tempLocation=$MIGRATION_DESTINATION_DIRECTORY/sync-table/dataflow-test/temp \
    --region=$REGION

Ganti TABLE_NAME dengan nama tabel HBase yang Anda impor.

Setelah tugas sync-table selesai, buka halaman Detail Tugas Dataflow dan tinjau bagian Penghitung kustom untuk tugas tersebut. Jika tugas impor berhasil mengimpor semua data, nilai untuk ranges_matched akan memiliki nilai dan nilai untuk ranges_not_matched adalah 0.

Jika ranges_not_matched menampilkan nilai, buka halaman Logs, pilih Worker Logs, lalu filter menurut Mismatch on range. Output log ini yang dapat dibaca mesin disimpan di Cloud Storage di tujuan output yang Anda buat di opsi outputPrefix tabel sinkronisasi.

Anda dapat mencoba tugas impor lagi atau menulis skrip untuk membaca file output guna menentukan tempat ketidakcocokan terjadi. Setiap baris dalam file output adalah data JSON yang diserialisasi dari rentang yang tidak cocok.

Penulisan rute ke Bigtable

Setelah memvalidasi data untuk setiap tabel di cluster, Anda dapat mengonfigurasi aplikasi untuk merutekan semua traffic ke Bigtable, lalu menghentikan penggunaan instance HBase.

Setelah migrasi selesai, Anda dapat menghapus snapshot di instance HBase.

Langkah selanjutnya

• Lihat bagian lain dari panduan migrasi Hadoop:
  • Overview
  • Panduan migrasi data
  • Panduan migrasi tugas
  • Pelajari Cloud Storage lebih lanjut.