Lindorm：Kolom dinamis

Sebelum menggunakan fitur kolom dinamis, perhatikan hal-hal berikut:

• Pastikan versi LindormTable adalah 2.2.19 atau lebih baru. Untuk informasi lebih lanjut, lihat Tingkatkan versi mesin minor dari instance Lindorm.Lindorm

• Data dalam kolom dinamis di LindormTable bertipe VARBINARY. Anda harus mengonversi tipe data kolom dinamis menjadi larik byte ketika menulis atau menanyakan data.

• Jika Anda menggunakan API HBase untuk Java untuk membuat tabel atau menulis data, Anda dapat menggunakan Lindorm SQL untuk menanyakan dan menulis data ke kolom dinamis dalam tabel tersebut.

Anda dapat menggunakan salah satu metode berikut untuk mengaktifkan kolom dinamis:

• Aktifkan kolom dinamis dengan menggunakan klausa WITH saat membuat tabel.

  CREATE TABLE t_dynamic (p1 INT, c1 INT, c2 VARCHAR, PRIMARY KEY(p1)) WITH (DYNAMIC_COLUMNS='true');

• Modifikasi atribut tabel yang ada untuk mengaktifkan kolom dinamis.

  ALTER TABLE t_dynamic SET 'DYNAMIC_COLUMNS' = 'true';

  Verifikasi Hasil

  Eksekusi pernyataan berikut untuk memverifikasi apakah kolom dinamis diaktifkan untuk sebuah tabel:

  SHOW TABLE VARIABLES FROM t_dynamic LIKE 'DYNAMIC_COLUMNS';

  Catatan

  Setelah kolom dinamis diaktifkan, Anda dapat memodifikasi atribut tabel untuk menambahkan kolom baru ke skema tabel. Sebagai contoh, eksekusi pernyataan berikut untuk menambahkan kolom c3 dengan tipe data INT ke skema tabel.

  ALTER TABLE t_dynamic ADD COLUMN c3 int;

  Jika Anda menulis data ke kolom dinamis bernama c3 sebelum menambahkan kolom c3 ke skema tabel, pengecualian akan dikembalikan saat menyisipkan atau menanyakan data INT karena tipe data yang ditulis ke c3 adalah VARBINARY. Pengecualian ini tidak terjadi jika tipe data kolom c3 yang ditambahkan ke skema tabel adalah VARBINARY. Oleh karena itu, perhatikan tipe data saat mengubah skema tabel dengan kolom dinamis yang diaktifkan. Jangan atur nama kolom yang telah ditentukan sebagai nama kolom dinamis yang sudah ada.

Skenario untuk menanyakan data dalam kolom dinamis diklasifikasikan sebagai berikut:

• Bidang yang ingin ditanyakan adalah kolom dinamis yang didefinisikan secara eksplisit. Sintaks untuk menanyakan data dalam tabel dengan kolom dinamis sama dengan sintaks untuk tabel tanpa kolom dinamis. Setelah kolom dinamis diaktifkan, Anda dapat menanyakan data dalam kolom yang tidak didefinisikan dalam skema tabel.

  SELECT p1, c2, c3, c4 FROM t_dynamic WHERE p1 = 1;

  Hasil berikut dikembalikan:

  +----+----+------+------+
  | p1 | c2 |  c3  |  c4  |
  +----+----+------+------+
  | 1  | 1  | 0x41 | null |
  +----+----+------+------+

• Untuk melihat kolom dinamis dalam sebuah tabel, gunakan pernyataan SELECT * dengan klausa LIMIT untuk membatasi ukuran set hasil.

  SELECT * FROM t_dynamic LIMIT 10;

  Hasil berikut dikembalikan:

  +----+------+------+------+----------+
  | p1 |  c1  |  c2  |  c3  |    c4    |
  +----+------+------+------+----------+
  | 1  | null | 1    | 0x41 | null     |
  | 2  | null | null | null | 0xef0011 |
  | 3  | null | null | null | 0xef0011 |
  +----+------+------+------+----------+

  Penting

  Jika Anda menggunakan pernyataan SELECT * dengan klausa LIMIT untuk menanyakan data dalam tabel yang memiliki kolom dinamis diaktifkan, nilai maksimum default LIMIT adalah 5.000. Anda dapat menentukan nilai maksimum sendiri. Jika nilai yang diminta melebihi batas maksimum, sistem akan mengembalikan kesalahan.

• Kolom dinamis digunakan dalam kondisi WHERE.

  Untuk memastikan kinerja kueri, sertakan kolom kunci utama atau kolom kunci indeks dalam kondisi WHERE. Nilai dalam kolom dinamis dalam kondisi WHERE harus berupa hex string.

  Contohnya, jika kolom c4 dalam tabel t_dynamic adalah kolom dinamis, pernyataan berikut dapat dieksekusi untuk kueri yang berhasil:

  SELECT p1, c4 FROM t_dynamic WHERE p1 = 3 AND c4 = x'ef0011';

  Sebaliknya, kueri berikut gagal karena nilai 1 dari kolom c4 dalam kondisi WHERE bukan hex string.

  SELECT p1, c1, c4 FROM t_dynamic WHERE p1 = 2 AND c4 = '1';

Kode Java berikut memberikan contoh cara mengonversi larik byte menjadi hex string:

private static final char[] DIGITS = {
  '0', '1', '2', '3', '4', '5', '6', '7',
  '8', '9', 'a', 'b', 'c', 'd', 'e', 'f'
  };

private static String toHexString(byte[] bytes) {
  char[] chars;
  int j = 0;
  chars = new char[bytes.length * 2];
  for (byte b : bytes) {
    chars[j++] = DIGITS[(b & 0xF0) >> 4];
    chars[j++] = DIGITS[b & 0x0F];
  }
  return new String(chars, 0, j);
}

public void testToHexString() {
  String s = "Hello, world";
  // Anda dapat menggunakan metode getBytes() dari string untuk mendapatkan larik byte yang sesuai dengan string.
  byte[] bytes = s.getBytes(Charset.forName("UTF-8"));
  String hexString = toHexString(bytes);
  System.out.println(hexString); // Outputnya adalah 48656c6c6f2c20776f726c64.
}