如果您需要使用動(dòng)態(tài)列功能，請(qǐng)注意以下幾點(diǎn)：

• 確保云原生多模數(shù)據(jù)庫 Lindorm寬表引擎為2.2.19及以上版本，具體操作請(qǐng)參見升級(jí)小版本。

• Lindorm寬表中動(dòng)態(tài)列類型均為VARBINARY，查詢動(dòng)態(tài)列和寫入動(dòng)態(tài)列時(shí)都必須將動(dòng)態(tài)列類型轉(zhuǎn)化成字節(jié)數(shù)組。

• 通過Lindorm SQL管理動(dòng)態(tài)列，查詢動(dòng)態(tài)列和寫入動(dòng)態(tài)列操作支持以云數(shù)據(jù)庫HBase兼容方式創(chuàng)建和寫入的表。

動(dòng)態(tài)列的開啟可以通過以下兩種方式：

• 在創(chuàng)建表格時(shí)通過WITH子句開啟動(dòng)態(tài)列功能。

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

• 通過修改表的屬性開啟動(dòng)態(tài)列功能。

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

  結(jié)果驗(yàn)證

  您可以通過以下語句驗(yàn)證表是否已成功開啟動(dòng)態(tài)列功能。

  SHOW TABLE VARIABLES FROM t_dynamic LIKE 'DYNAMIC_COLUMNS';

  說明

  開啟動(dòng)態(tài)列后，您可以修改表的屬性或者在表的Schema中增加新的列，例如執(zhí)行以下語句表示新增c3列，數(shù)據(jù)類型為INT。

  ALTER TABLE t_dynamic ADD COLUMN c3 int;

  如果您在此之前寫入過名為c3的動(dòng)態(tài)列，由于寫入的數(shù)據(jù)類型均為VARBINARY，查詢數(shù)據(jù)和寫入數(shù)據(jù)時(shí)會(huì)拋出異常，如果新增列的數(shù)據(jù)類型為VARBINARY就不會(huì)出現(xiàn)這個(gè)異常。因此，變更動(dòng)態(tài)列表的Schema時(shí)需要注意數(shù)據(jù)類型不同的情況，盡量避免預(yù)定義列和動(dòng)態(tài)列重名。

查詢動(dòng)態(tài)列的場景分為以下幾種：

• 顯式指定查詢字段為動(dòng)態(tài)列。查詢動(dòng)態(tài)列表的語法與查詢普通列表的語法一致，開啟動(dòng)態(tài)列之后，可以查詢沒有預(yù)先在Schema中定義的列，如下示例，c3和c4是創(chuàng)建表后新增的動(dòng)態(tài)列。

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

  返回結(jié)果如下：

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

• 不確定表中已包含哪些動(dòng)態(tài)列時(shí)，可以使用SELECT *查詢動(dòng)態(tài)列表。Lindorm SQL為了保證結(jié)果集元數(shù)據(jù)的正確性，強(qiáng)制要求在此類查詢語句后添加LIMIT子句來限定結(jié)果集的大小。

  SELECT * FROM t_dynamic LIMIT 10;

  返回結(jié)果如下：

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

  重要

  對(duì)于動(dòng)態(tài)列表的SELECT *查詢操作，LIMIT的默認(rèn)最大值為5000，超過最大值會(huì)報(bào)錯(cuò)。

• 在WHERE條件中使用動(dòng)態(tài)列。

  為了確保查詢語句的性能WHERE條件中需包含主鍵或索引列，如果您希望在查詢的過濾條件中使用動(dòng)態(tài)列進(jìn)行過濾，那么使用SQL文本查詢時(shí)，動(dòng)態(tài)列的過濾條件必須指定為HexString；使用綁參方式進(jìn)行查詢時(shí)，過濾條件建議直接指定為原始的字節(jié)數(shù)組。

  例如表t_dynamic中c4為動(dòng)態(tài)列，那么查詢成功的語句如下示例：

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

  作為對(duì)比，下述查詢示例中由于給動(dòng)態(tài)列c4指定的過濾條件1不是一個(gè)HexString，所以該查詢執(zhí)行失敗。

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

在Java中，使用下述代碼可以將一個(gè)字節(jié)數(shù)組轉(zhuǎn)換為HexString。

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";
  // 對(duì)于字符串類型，可以直接使用String的getBytes方法獲得對(duì)象對(duì)應(yīng)的byte[]
  byte[] bytes = s.getBytes(Charset.forName("UTF-8"));
  String hexString = toHexString(bytes);
  System.out.println(hexString); //打印結(jié)果為： 48656c6c6f2c20776f726c64
}