Cara menggunakan Lindorm Shell untuk terhubung ke LindormTable - Lindorm

Lindorm Shell adalah alat klien HBase yang disediakan oleh Lindorm. Alat ini memungkinkan Anda menggunakan HBase API untuk Java guna terhubung ke LindormTable dan melakukan operasi seperti pembuatan tabel, penyisipan data, serta kueri data. Topik ini menjelaskan cara mengunduh Lindorm Shell dan menggunakannya untuk terhubung ke LindormTable.

Prasyarat

Java Development Kit (JDK) V1.8 atau versi lebih baru telah diinstal.
Alamat IP klien Anda telah ditambahkan ke daftar putih dari instance Lindorm. Untuk informasi lebih lanjut, lihat Konfigurasi Daftar Putih.

Catatan penggunaan

Setelah menggunakan Lindorm Shell untuk terhubung ke LindormTable, Anda hanya dapat melakukan operasi DDL sederhana, membaca data, dan menulis data. Untuk informasi lebih lanjut, lihat Batasan.
Jangan gunakan HBase API untuk mengakses tabel lebar yang dibuat menggunakan SQL.
Kami merekomendasikan agar Anda menerapkan klien di lingkungan Linux atau macOS saat menggunakan Lindorm Shell untuk terhubung ke LindormTable.
Penting
Jika Anda menerapkan klien di lingkungan Windows, kesalahan mungkin muncul karena pustaka tidak ditemukan. Dalam hal ini, Anda harus menambahkan file pustaka yang sesuai ke sistem operasi Anda.

Prosedur

Unduh Lindorm Shell.
1. Masuk ke Konsol Lindorm. Di pojok kiri atas halaman, pilih wilayah tempat instance Lindorm Anda diterapkan. Pada halaman Instances, temukan instance dan klik ID instance tersebut.
2. Di panel navigasi di sebelah kiri, klik Database Connections. Pada halaman yang muncul, klik tab Wide Table Engine.
3. Klik HBase Compatibility Address, lalu klik Download Lindorm Shell untuk mengunduh paket Lindorm Shell.
Jalankan perintah berikut untuk mengekstrak paket Lindorm Shell yang diunduh ke jalur target. Dalam contoh ini, paket diekstrak ke jalur alihbase-2.0.18.
```
tar zxvf hbaseue-shell.tar.gz
```
Konfigurasikan parameter koneksi.
1. Pergi ke direktori alihbase-2.0.18/conf dan buka file hbase-site.xml.
```
vi hbase-site.xml
```
2. Tentukan titik akhir, nama pengguna, dan kata sandi yang ingin Anda gunakan untuk terhubung ke LindormTable.
```
<configuration>
    <property>
        <name>hbase.zookeeper.quorum</name>
        <value>ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30020</value>
    </property>
    <property>
        <name>hbase.client.username</name>
        <value>testuser</value>
    </property>
    <property>
        <name>hbase.client.password</name>
        <value>password</value>
    </property>
</configuration>
```
  Anda dapat mengonfigurasi parameter koneksi berikut dalam file konfigurasi:
  - hbase.zookeeper.quorum: Ganti parameter ini dengan titik akhir LindormTable yang ditampilkan setelah Access by Using HBase Java API pada tab Wide Table Engine di Konsol Lindorm.
    - Jika Lindorm Shell diterapkan pada instance Elastic Compute Service (ECS) yang berada di VPC yang sama dengan instance Lindorm Anda, ganti parameter ini dengan titik akhir VPC LindormTable.
    - Jika Lindorm Shell diterapkan pada komputer lokal atau instance ECS yang tidak berada di wilayah yang sama dengan instance Lindorm Anda, ganti parameter ini dengan titik akhir publik LindormTable.
  - hbase.client.username dan hbase.client.password: Ganti kedua parameter ini secara individual dengan nama pengguna dan kata sandi yang Anda gunakan untuk terhubung ke LindormTable. Jika Anda lupa kata sandi, Anda dapat mengubah kata sandi di cluster management system LindormTable. Untuk informasi lebih lanjut, lihat Ubah Kata Sandi Pengguna.
Gunakan Lindorm Shell untuk terhubung ke LindormTable.
Pergi ke jalur alihbase-2.0.18/bin lalu jalankan perintah berikut:
```
./hbase shell
```
Jika hasil berikut dikembalikan, klien Anda terhubung ke LindormTable.
```
Version 2.0.18, r08b8d58a9d6ce89765d5ebe2ddff425aed644c16, Mon Feb  1 12:46:39 CST 2021
Took 0.0034 seconds
```
Catatan
Untuk informasi lebih lanjut tentang penggunaan Shell, lihat bagian Referensi Lindorm Shell.

Referensi Lindorm Shell

Perintah Shell

Untuk informasi lebih lanjut tentang penggunaan perintah Shell, lihat The Apache HBase Shell.

Perintah DDL

create: Membuat tabel.
list: Menampilkan semua tabel di Lindorm.
disable: Menonaktifkan tabel.
is_disabled: Memeriksa apakah tabel dinonaktifkan.
enable: Mengaktifkan tabel.
is_enabled: Memeriksa apakah tabel diaktifkan.
describe: Menjelaskan detail tabel tertentu, termasuk atribut dan skema tabel.
alter: Mengubah skema tabel.
exists: Memeriksa apakah tabel ada.
drop: Menghapus tabel.

Perintah DML

put: Memperbarui nilai di kolom tertentu.
get: Mendapatkan nilai di baris atau kolom tertentu.
delete: Menghapus nilai di kolom tertentu.
deleteall: Menghapus semua kolom dalam satu baris.
scan: Memindai dan mengembalikan data dalam tabel.
count: Menghitung dan mengembalikan jumlah kolom dalam tabel.
truncate_preserve: Menghapus semua data dalam tabel. Operasi ini diimplementasikan dengan menonaktifkan dan menghapus tabel lalu membuat tabel baru dengan region yang sama seperti tabel aslinya.

Masuk dan keluar dari Lindorm Shell

Masuk ke Lindorm Shell.
```
bin/hbase shell
```
Keluar dari Lindorm Shell.
```
quit
```

Contoh

Buat tabel dan sisipkan data ke dalam tabel

Buat tabel. Anda harus menentukan nama tabel dan nama keluarga kolom.

create 'Nama Tabel', 'Nama Keluarga Kolom'

Contoh:

// Buat tabel bernama test dengan keluarga kolom bernama cf.
create 'test', 'cf'

Sisipkan data ke tabel.
```
put 'Nama Tabel', 'Rowkey', 'Nama Keluarga Kolom:Nama Kolom', 'Nilai'
```
Contoh:
```
put 'test', 'row1', 'cf:a', 'value1'
put 'test', 'row2', 'cf:b', 'value2'
put 'test', 'row3', 'cf:c', 'value3'
```
Catatan
Dalam perintah di atas, test adalah nama tabel, row1 adalah row key tabel, cf:a adalah nama keluarga kolom dan nama kolom, dan value1 adalah nilai kolom.

Kueri data

Kueri informasi tentang semua tabel. Anda dapat menggunakan ekspresi reguler untuk menyaring tabel yang ingin Anda kueri.
```
list
list 'abc.*'
list 'test'
```
Kueri data dalam tabel yang ditentukan.
Perintah scan dapat digunakan untuk mengakses data dalam tabel HBase. Ini juga dapat digunakan untuk secara fleksibel mengkueri semua data dalam tabel atau data dalam rentang tertentu. Kecepatan kueri perintah ini sedikit lebih lambat daripada perintah get. Anda dapat menjalankan perintah berikut untuk mengkueri data dalam tabel test:
```
scan 'Nama Tabel'
```
Contoh:
```
scan 'test'
```
Hasil berikut dikembalikan:
```
ROW                                      COLUMN+CELL
 row1                                    column=cf:a, timestamp=1421762485768, value=value1
 row2                                    column=cf:b, timestamp=1421762491785, value=value2
 row3                                    column=cf:c, timestamp=1421762496210, value=value3
3 baris(s) dalam 0.0230 detik
```

Kueri baris data tertentu dalam tabel.

get 'Nama Tabel', 'Rowkey'

Contoh:

get 'test', 'row1'

Hasil berikut dikembalikan:

COLUMN CELL
 cf:a timestamp=1421762485768, value=value1
1 baris(s) dalam 0.0350 detik

Aktifkan dan nonaktifkan tabel

Anda dapat mengaktifkan atau menonaktifkan tabel tertentu. Sebelum Anda menghapus atau memodifikasi pengaturan tabel, Anda harus menjalankan perintah disable untuk menonaktifkan tabel terlebih dahulu. Setelah Anda menghapus atau memodifikasi pengaturan, Anda dapat menjalankan perintah enable untuk mengaktifkan tabel ini.

disable 'Nama Tabel'
enable 'Nama Tabel'

Hapus tabel

Hapus tabel tertentu.

drop 'Nama Tabel'

Pengaturan referensi

Pengaturan Umum

Konfigurasikan interval operasi major compaction dilakukan. Satuan interval adalah milidetik. Kami merekomendasikan agar Anda tidak mengonfigurasi interval kecuali Anda memiliki persyaratan khusus.
Anda dapat menjalankan perintah berikut untuk mengatur interval operasi major compaction menjadi tujuh hari:
```
alter 'Nama Tabel', {NAME => 'Nama Keluarga Kolom', CONFIGURATION => {'hbase.hregion.majorcompaction' => 16800000}}
```
Catatan
Interval default dihitung menggunakan rumus berikut: Math.Min(TTL,1728000000ms). Jika TTL tidak ditentukan untuk tabel, interval default adalah 1728000000ms, yang sama dengan 20 hari.
Konfigurasikan algoritma enkripsi untuk keluarga kolom tabel yang ditentukan.
```
alter 'Nama Tabel', NAME => 'Nama Keluarga Kolom', COMPRESSION => 'ZSTD'
```
Konfigurasikan tipe pengkodean blok keluarga kolom tabel yang ditentukan.
Anda dapat menjalankan perintah berikut untuk mengatur tipe pengkodean blok keluarga kolom tabel test menjadi DATA_BLOCK_ENCODING:
```
alter 'Nama Tabel', NAME => 'Nama Keluarga Kolom', DATA_BLOCK_ENCODING => 'DIFF'
```
Konfigurasikan TTL untuk keluarga kolom tabel yang ditentukan. Satuan TTL adalah detik. Anda dapat menjalankan perintah berikut untuk mengatur TTL keluarga kolom menjadi 2592000s, yang sama dengan 30 hari:
```
alter 'Nama Tabel', NAME => 'Nama Keluarga Kolom', TTL => 2592000
```
Jika Anda ingin menyimpan data secara permanen, Anda dapat mengatur TTL menjadi FOREVER. Contoh:
```
alter 'Nama Tabel' , {NAME => 'Nama Keluarga Kolom', TTL => 'FOREVER'}
```

Konfigurasikan pre-partitioning untuk tabel HBase.

create'Table name',{NAME => 'Column family name',COMPRESSION => 'snappy' }, { NUMREGIONS => 50, SPLITALGO => 'HexStringSplit' }

Parameter

Parameter	Deskripsi
NAME	Nama keluarga kolom tabel HBase.
COMPRESSION	Algoritma yang digunakan untuk mengompresi data dalam tabel HBase. Parameter ini tidak memiliki nilai default. Nilai valid: ZSTD (Disarankan) SNAPPY LZ4
NUMREGIONS	Jumlah partisi. Saat Anda menghitung jumlah partisi, Anda dapat berasumsi bahwa setiap partisi menggunakan penyimpanan sebesar 6 hingga 8 GB. Anda dapat mengonfigurasi beberapa partisi berdasarkan ukuran instance Anda.
SPLITALGO	Algoritma yang digunakan untuk menginisialisasi region. Algoritma berikut didukung: HexStringSplit: Algoritma ini berlaku untuk tabel di mana row key diawali dengan string heksadesimal. DecimalStringSplit: Algoritma ini berlaku untuk tabel di mana row key diawali dengan string desimal. UniformSplit: Algoritma ini berlaku untuk tabel di mana awalan row key bersifat acak.

Setelah Anda memodifikasi pengaturan parameter, Anda dapat menjalankan perintah berikut untuk memeriksa apakah modifikasi tersebut berlaku:

describe 'Nama Tabel'