如何通過HINT設定時間戳記實現多版本資料管理 - Lindorm

本文介紹如何在Lindorm寬表SQL中通過HINT設定時間戳記來實現多版本資料管理。

引擎與版本

HINT文法僅適用於寬表引擎，且引擎版本需為2.3.1及以上版本。

說明

功能介紹

Lindorm寬表引擎中，寫入每條資料時每列都會記錄時間戳記，該時間戳記一般記錄的是資料寫入時的伺服器時間。預設情況下，該時間戳記會作為每列的版本標識，使用者也可以在寫入資料時自訂時間戳記，時間戳記越大說明資料的版本越新。如果寬表的列要儲存多個版本的資料，需要在建立表時設定版本屬性'VERSIONS' = 'n'（n為正整數，表示每列最多保留的版本數）。通過時間戳記查詢多版本的資料時需要指定多版本屬性，多版本的相關屬性如下表：

屬性名稱	說明	適用語句
_l_ts_(N)	自訂時間戳記的值。	UPSERT、SELECT
_l_versions_(N)	表示查詢結果中返回最新的N個版本的資料。	SELECT
_l_ts_min_(N)	用於過濾查詢結果，表示查詢結果中返回時間戳記大於等於N的資料。	SELECT
_l_ts_max_(N)	用於過濾查詢結果，表示查詢結果中返回時間戳記小於N的資料。	SELECT

使用方法

設定時間戳記並查詢資料

Lindorm寬表支援在非主鍵列中設定時間戳記並通過時間戳記查詢指定版本的資料。

建立測試表，指定保留的版本數。語句如下：
```
CREATE TABLE t_test_versions_2 (c1 INT , c2 INT, c3 VARCHAR(50), PRIMARY KEY(c1)) WITH(VERSIONS='5');
```
說明
您可以執行ALTER TABLE table_name SET 'VERSIONS' = 'num';語句為已建立的資料表指定或修改版本數，其中table_name為資料表名稱，num為版本數。

寫入資料。設定時間戳記時需要指定多版本屬性，語句如下：

UPSERT /*+ _l_ts_(1000)  */ INTO t_test_versions_2(c1, c3) values (1, '11');
UPSERT /*+ _l_ts_(2001)  */ INTO t_test_versions_2(c1, c3) values (1, '22');
UPSERT /*+ _l_ts_(1000)  */ INTO t_test_versions_2(c1, c2) values (1, 1);
UPSERT /*+ _l_ts_(2001)  */ INTO t_test_versions_2(c1, c2) values (2, 1);
UPSERT /*+ _l_ts_(2002)  */ INTO t_test_versions_2(c1, c2) values (2, 2);
UPSERT /*+ _l_ts_(2003)  */ INTO t_test_versions_2(c1, c2) values (2, 3);
UPSERT /*+ _l_ts_(2004)  */ INTO t_test_versions_2(c1, c2) values (2, 4);
UPSERT /*+ _l_ts_(2005)  */INTO t_test_versions_2(c1, c2) values (2, 5);
UPSERT /*+ _l_ts_(2006)  */ INTO t_test_versions_2(c1, c2) values (2, 6);

通過時間戳記查詢指定版本的資料。如果要查看時間戳記，需要在列名後加上時間戳記尾碼（即_l_ts）。

樣本一：返回指定時間戳記為1000的資料。

SELECT /*+ _l_ts_(1000) */ c1, c3, c3_l_ts FROM t_test_versions_2 WHERE c1 = 1;

返回結果：

+----+----+---------+
| c1 | c3 | c3_l_ts |
+----+----+---------+
| 1  | 11 | 1000    |
+----+----+---------+

樣本二：查詢時間戳記在[1000,2001)範圍內的資料。

SELECT /*+ _l_ts_min_(1000), _l_ts_max_(2001)  */ c1, c3, c3_l_ts FROM t_test_versions_2 WHERE c1 = 1;

返回結果：

+----+----+---------+
| c1 | c3 | c3_l_ts |
+----+----+---------+
| 1  | 11 | 1000    |
+----+----+---------+

樣本三：返回最新的N個版本的資料，需要指定_l_versions_(N)屬性。

SELECT /*+ _l_versions_(1) */ c1, c3, c3_l_ts FROM t_test_versions_2 WHERE c1 = 1;

返回結果：

+----+----+---------+
| c1 | c3 | c3_l_ts |
+----+----+---------+
| 1  | 22 | 2001    |
+----+----+---------+

樣本四：每列返回最新的兩個版本資料，並且按照時間戳記相同的列合并為一行返回結果集。查詢語句中指定_l_versions_(N)屬性會返回所有非主鍵列的時間戳記資料。

SELECT /*+ _l_versions_(2)  */ c1, c2, c3, c2_l_ts, c3_l_ts FROM t_test_versions_2;

返回結果如下：

+----+------+------+---------+---------+
| c1 |  c2  |  c3  | c2_l_ts | c3_l_ts |
+----+------+------+---------+---------+
| 1  | null | 22   | null    | 2001    |
| 1  | 1    | 11   | 1000    | 1000    |
| 2  | 6    | null | 2006    | null    |
| 2  | 5    | null | 2005    | null    |
+----+------+------+---------+---------+

樣本五：由於建立表時設定版本屬性僅保留5個版本的資料，所以儘管指定_l_versions_(6)屬性也只能返回5個版本的資料。

SELECT /*+ _l_versions_(6)  */ c1, c2, c2_l_ts FROM t_test_versions_2 WHERE c1=2;

返回結果如下：

+----+----+---------+
| c1 | c2 | c2_l_ts |
+----+----+---------+
| 2  | 6  | 2006    |
| 2  | 5  | 2005    |
| 2  | 4  | 2004    |
| 2  | 3  | 2003    |
| 2  | 2  | 2002    |
+----+----+---------+