All Products
Search
Document Center

ApsaraDB for HBase:Kueri Data

Last Updated:Sep 17, 2026

Selama pengembangan, debugging, atau operasi produksi, Anda sering perlu melakukan kueri data di HBase. Selain menggunakan HBase Shell untuk menulis permintaan Get dan Scan, Lindorm Insight menyediakan entri kueri SQL yang sederhana. Anda dapat menggunakan sintaks SQL untuk melakukan kueri data di tabel lebar ApsaraDB untuk HBase Edisi Performa-tinggi.

Prasyarat

Sebelum memulai, pastikan Anda telah:

Batasan

  • Untuk menjaga keamanan data, setiap kueri hanya dapat mengembalikan maksimal 100 baris.

  • Bidang ROW bersesuaian dengan row key Lindorm. Baik ROW maupun qualifier bertipe varbinary. Jika suatu qualifier tidak termasuk dalam keluarga kolom tertentu, Anda harus menentukan keluarga kolom tersebut.

  • ROW dan COL merupakan bidang tercadang SQL. Anda harus membungkusnya dengan backtick (`) saat menggunakannya dalam kueri. Anda juga harus membungkus qualifier dengan backtick jika menentukan keluarga kolom untuknya.

Kueri kompatibel HBase

Halaman Data Query (Compatible with HBase) memungkinkan Anda melakukan kueri pada tabel tertentu dan menambahkan data ke dalamnya.

Kueri data yang ada

Anda dapat melakukan kueri data yang ada di tabel SQL dan tabel HBase.

  1. Di panel navigasi sebelah kiri, pilih Data Query > Data Query (Compatible with HBase).

  2. Tetapkan kondisi filter, termasuk namespace dan Table.

  3. Opsional: Tentukan keluarga kolom, kunci baris, kunci awal, kunci akhir, dan limit.

  4. Klik Query. Data yang ada di tabel target akan ditampilkan.

Tambahkan data HBase

Anda hanya dapat menambahkan data ke tabel HBase. Fitur ini tidak mendukung tabel SQL.

  1. Klik Add.

  2. Di kotak dialog Add table data, masukkan parameter berikut:

    Parameter

    Deskripsi

    Rowkey

    Kunci baris dari tabel HBase.

    Column Name

    Nama kolom yang akan ditambahkan. Anda harus menentukan keluarga kolom dalam format <nama keluarga kolom:nama kolom>, contohnya f:name.

    Timestamp

    Hanya timestamp Unix yang didukung.

    Value

    Nilai data. Untuk daftar tipe data yang didukung, lihat Tipe data dasar.

  3. Klik Determine untuk menambahkan satu baris.

Edit data yang ada

Anda dapat mengedit data yang ada di tabel SQL dan tabel HBase.

  1. Di kolom Operation pada baris target, klik Edit.image.png

  2. Di kotak dialog Edit Table Data, ubah timestamp dan nilai data.

  3. Klik Determine untuk menyimpan perubahan Anda.

SQL executor

  1. Di panel navigasi sebelah kiri, pilih Data Query > SQL Executor.

  2. Dari daftar drop-down namespace, pilih namespace. Tabel-tabel dalam namespace tersebut akan muncul di sebelah kanan.

  3. Opsional: Dapatkan string heksadesimal. Untuk petunjuknya, lihat Dapatkan string heksadesimal.

  4. Masukkan pernyataan SQL di editor.

  5. Klik Execution.

    Catatan

    Anda juga dapat menjalankan pernyataan tersebut dengan pintasan keyboard. Di Windows, tekan CTRL+ENTER. Di macOS, tekan COMMAND+RETURN.

Dapatkan string heksadesimal

Saat Anda melakukan kueri pada baris tertentu di tabel HBase atau melakukan kueri bersyarat pada bidang varbinary, Anda harus menggunakan string heksadesimal sebagai nilainya. Misalnya, untuk melakukan kueri baris dengan row key r1, klausa WHERE dalam pernyataan SQL Anda harus berupa WHERE ROW='7321', di mana 7321 adalah string heksadesimal untuk r1. Halaman Kueri Data di sistem manajemen kluster menyediakan alat konversi untuk menghasilkan string heksadesimal tersebut.

  1. Di panel navigasi sebelah kiri, pilih Data Query > SQL Executor.

  2. Dari daftar drop-down namespace, pilih namespace. Tabel-tabel dalam namespace tersebut akan muncul di sebelah kanan.

  3. Dapatkan string heksadesimal hasil konversi.

    • Metode 1: Klik Execution untuk melihat struktur tabel target. Masukkan string target di kotak teks Binary to hex string conversion. Hasil konversi akan muncul di bagian atas editor.image.png

    • Metode 2: Aktifkan sakelar HexString lalu klik Execution. Hasil eksekusi akan menampilkan nilai-nilai yang telah dikonversi ke string heksadesimal.

  4. Tulis pernyataan SQL di editor dan ganti nilai aslinya dengan string heksadesimal hasil konversi.

    Misalnya, jika pernyataan kueri aslinya adalah SELECT * FROM task WHERE ROW = "xxxx1";, maka pernyataan yang diperbarui menjadi SELECT * FROM task WHERE ROW = "7878787831";.

  1. Klik Execution.