Menghubungkan ke LindormTable menggunakan Lindorm Shell - Lindorm

Lindorm Shell adalah alat baris perintah dari Lindorm yang kompatibel dengan HBase. Anda dapat menggunakannya untuk terhubung ke LindormTable melalui HBase Java API guna melakukan operasi data, seperti membuat tabel, memasukkan data, dan mengkueri data. Topik ini menjelaskan cara mengunduh Lindorm Shell dan menghubungkannya ke LindormTable.

Prasyarat

Java Development Kit (JDK) 1.8 atau versi lebih baru telah terinstal.
Tambahkan alamat IP klien Anda ke daftar putih instans Lindorm. Untuk informasi selengkapnya, lihat Konfigurasi daftar putih.

Catatan penggunaan

Saat menghubungkan ke LindormTable menggunakan Lindorm Shell, Anda hanya dapat melakukan operasi dasar bahasa definisi data (DDL) dan bahasa manipulasi data (DML). Untuk informasi tentang operasi yang tidak didukung, lihat Batasan penggunaan HBase API.
Jangan gunakan HBase API untuk mengakses tabel lebar yang dibuat dengan SQL. Hal ini dapat menghasilkan karakter acak (garbled characters).
Kami merekomendasikan penggunaan Lindorm Shell pada sistem operasi Linux atau macOS.
Penting
Jika Anda menggunakan Lindorm Shell di Windows, Anda mungkin mengalami error atau pesan library tidak ditemukan. Jika hal ini terjadi, Anda harus menambahkan library yang diperlukan ke sistem operasi sesuai petunjuk dalam pesan error tersebut.

Prosedur

Unduh Lindorm Shell.
1. Di pojok kiri atas Konsol Lindorm, pilih wilayah instans Anda. Pada halaman Instances, klik ID instans target.
2. Di panel navigasi sebelah kiri, klik Database Connections, lalu klik tab Wide Table Engine.
3. Klik Lindorm Shell Download.
Jalankan perintah berikut untuk mengekstrak paket Lindorm Shell. Contoh ini mengekstrak paket ke direktori alihbase-2.0.18.
```
tar zxvf hbaseue-shell.tar.gz
```
Konfigurasikan parameter koneksi.
1. Buka direktori alihbase-2.0.18/conf dan buka file hbase-site.xml.
```
vi hbase-site.xml
```
2. Konfigurasikan titik akhir koneksi, username, dan password untuk 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>
```
  Parameter:
  - hbase.zookeeper.quorum: Titik akhir koneksi untuk LindormTable. Anda dapat menemukan titik akhir ini di bagian Access by Using HBase Java API di konsol.
    - Titik akhir VPC: Gunakan titik akhir ini jika Lindorm Shell berada di Instance ECS yang berada dalam VPC yang sama dengan instans Lindorm Anda.
    - Titik akhir publik: Gunakan titik akhir ini jika Lindorm Shell berada di mesin on-premises atau Instance ECS di luar VPC instans Lindorm Anda.
  - hbase.client.username dan hbase.client.password: Username dan password yang digunakan untuk mengakses LindormTable. Jika Anda lupa password, Anda dapat mengubahnya di Cluster Management System LindormTable. Untuk informasi selengkapnya, lihat Mengubah password pengguna.
Hubungkan ke LindormTable menggunakan Lindorm Shell.
Buka direktori alihbase-2.0.18/bin dan jalankan perintah berikut.
```
./hbase shell
```
Output berikut menunjukkan koneksi berhasil.
```
Version 2.0.18, r08b8d58a9d6ce89765d5ebe2ddff425aed644c16, Mon Feb  1 12:46:39 CST 2021
Took 0.0034 seconds
```
Catatan
Untuk informasi selengkapnya tentang cara menggunakan shell, lihat Referensi Lindorm Shell.

Referensi Lindorm Shell

Referensi perintah

Untuk informasi selengkapnya tentang perintah shell, lihat The Apache HBase Shell.

Bahasa definisi data (DDL)

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

Bahasa manipulasi data (DML)

put: Memperbarui nilai sel tertentu.
get: Mengambil isi baris atau sel tertentu.
delete: Menghapus nilai sel dalam tabel.
deleteall: Menghapus semua sel dalam baris tertentu.
scan: Memindai dan mengembalikan data tabel.
count: Menghitung dan mengembalikan jumlah baris dalam tabel.
truncate_preserve: Memotong tabel. Operasi ini menonaktifkan, menghapus, lalu membuat ulang tabel yang ditentukan. Tabel baru mempertahankan pemisahan region yang sama seperti tabel aslinya.

Masuk dan keluar dari shell

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

Contoh

Membuat dan memasukkan data

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

create 'table_name', 'column_family_name'

Contoh:

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

Masukkan data.

put 'table_name', 'row_key', 'column_family:column_name', 'value'

Contoh:

put 'test', 'row1', 'cf:a', 'value1'
put 'test', 'row2', 'cf:b', 'value2'
put 'test', 'row3', 'cf:c', 'value3'

Catatan

row1 adalah kunci baris dari tabel test, cf:a menentukan keluarga kolom dan nama kolom, sedangkan value1 adalah nilainya.

Kueri data

Kueri informasi tentang semua tabel. Anda dapat menggunakan ekspresi reguler untuk memfilter tabel.
```
list
list 'abc.*'
list 'test'
```
Kueri data dalam tabel tertentu.
Perintah scan menyediakan cara fleksibel untuk mengakses data HBase. Anda dapat menggunakan perintah scan untuk memindai seluruh tabel atau mengkueri data dalam rentang tertentu. Operasi scan sedikit lebih lambat daripada kueri baris tunggal menggunakan perintah get. Jalankan perintah berikut untuk mengkueri data dalam tabel test.
```
scan 'table_name'
```
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 row(s) in 0.0230 seconds
```

Kueri satu baris data dari tabel.

get 'table_name', 'row_key'

Contoh:

get 'test', 'row1'

Hasil berikut dikembalikan:

COLUMN CELL
 cf:a timestamp=1421762485768, value=value1
1 row(s) in 0.0350 seconds

Menonaktifkan dan mengaktifkan tabel

Nonaktifkan atau aktifkan tabel. Sebelum Anda dapat menghapus tabel, mengubah pengaturannya, atau melakukan operasi manajemen lainnya, Anda harus terlebih dahulu menonaktifkan tabel tersebut dengan perintah disable. Setelah operasi selesai, gunakan perintah enable untuk mengaktifkannya kembali.

disable 'table_name'
enable 'table_name'

Hapus tabel

Hapus tabel tertentu.

drop 'table_name'

Konfigurasi umum

Pengaturan umum

Tetapkan periode major compaction pada tabel tertentu. Kami menyarankan agar Anda tidak mengubah pengaturan ini kecuali benar-benar diperlukan. Satuan waktunya adalah milidetik (ms).
Contoh berikut menetapkan periode major compaction menjadi tujuh hari.
```
alter 'table_name', {NAME => 'column_family_name', CONFIGURATION => {'hbase.hregion.majorcompaction' => 16800000}}
```
Catatan
Nilai default: Math.Min(TTL, 1728000000). Jika Anda tidak menetapkan TTL, nilai default-nya adalah 1.728.000.000 ms, yaitu 20 hari.

Tetapkan algoritma kompresi untuk keluarga kolom pada tabel tertentu.

alter 'table_name', NAME => 'column_family_name', COMPRESSION => 'ZSTD'

Tetapkan jenis encoding blok untuk keluarga kolom pada tabel tertentu.
Tetapkan jenis encoding blok untuk keluarga kolom tabel test menjadi DATA_BLOCK_ENCODING.
```
alter 'table_name', NAME => 'column_family_name', DATA_BLOCK_ENCODING => 'DIFF'
```
Tetapkan waktu hidup (TTL) untuk keluarga kolom pada tabel tertentu. Satuan TTL adalah detik (s). Misalnya, 2.592.000 detik setara dengan 30 hari.
```
alter 'table_name', NAME => 'column_family_name', TTL => 2592000
```
Jika Anda ingin menyimpan data secara permanen, Anda dapat menetapkan nilai TTL menjadi FOREVER. Contoh:
```
alter 'table_name' , {NAME => 'column_family_name', TTL => 'FOREVER'}
```

Pre-split tabel tertentu.

create 'table_name', {NAME => 'column_family_name', COMPRESSION => 'snappy' }, { NUMREGIONS => 50, SPLITALGO => 'HexStringSplit' }

Parameter

Parameter	Deskripsi
NAME	Nama keluarga kolom.
COMPRESSION	Algoritma kompresi untuk data tabel. Default: None. Algoritma yang didukung: ZSTD (Direkomendasikan) SNAPPY LZ4
NUMREGIONS	Jumlah region. Sebagai pedoman umum, hitung jumlah region agar mencapai ukuran 6–8 GB per region. Untuk instans berskala besar, Anda dapat menambah jumlah ini sesuai kebutuhan.
SPLITALGO	Algoritma yang digunakan untuk menginisialisasi region. Algoritma yang didukung beserta kasus penggunaannya adalah sebagai berikut: HexStringSplit: Algoritma ini cocok untuk kunci baris yang diawali string heksadesimal. DecimalStringSplit: Algoritma ini cocok untuk kunci baris yang diawali string numerik desimal. UniformSplit: Algoritma ini cocok untuk kunci baris yang memiliki awalan sepenuhnya acak.

Setelah mengubah konfigurasi, Anda dapat menjalankan perintah berikut untuk memverifikasi bahwa perubahan telah diterapkan:

describe 'table_name'