
# 账本数据库的函数
#### get_dn_hist_relhash(text, text)
描述：返回指定防篡改用户表的表级数据hash值。该函数集中式暂不支持。
参数类型：text
返回值类型：hash16
#### ledger_hist_check(text, text)
描述：校验指定防篡改用户表的表级数据hash值与其对应历史表hash一致性。
参数类型：text
返回值类型：Boolean
示例：
```
--创建schema。
gaussdb=# CREATE SCHEMA ledgernsp WITH BLOCKCHAIN;
--创建表。
gaussdb=# CREATE TABLE ledgernsp.tab(a int, b text);
--插入数据。
gaussdb=# INSERT INTO ledgernsp.tab values(generate_series(1, 10000), 'test');
gaussdb=# SELECT ledger_hist_check('ledgernsp','tab');
 ledger_hist_check
-------------------
 t
(1 row)
```
#### ledger_hist_repair(text, text)
描述：修复指定防篡改用户表对应的历史表hash值，使之与用户表hash一致，返回hash差值。
参数类型：text
返回值类型：hash16
示例：
```
gaussdb=# SELECT ledger_hist_repair('ledgernsp','tab');
 ledger_hist_repair
--------------------
 0000000000000000
(1 row)
```
#### ledger_hist_archive(text, text)
描述：归档指定防篡改用户表对应的历史表至审计日志目录中hist_back文件夹下。如果用户历史表名称中带有'/'符号，归档所生成的文件名中将会把'/'替换为'_'。
参数类型：text
返回值类型：Boolean
示例：
```
gaussdb=# SELECT ledger_hist_archive('ledgernsp','tab');
 ledger_hist_archive
---------------------
 t
(1 row)
```
#### ledger_gchain_check(text, text)
描述：校验指定防篡改用户表对应的历史表hash与全局历史表对应的relhash一致性。
参数类型：text
返回值类型：Boolean
示例：
```
gaussdb=# SELECT ledger_gchain_check('ledgernsp','tab'); 
 ledger_gchain_check
---------------------
 t
(1 row)
```
#### ledger_gchain_repair(text, text)
描述：修复指定防篡改用户表在全局历史表中的relhash，使之与其历史表hash一致，返回指定表的hash总和。
参数类型：text
返回值类型：hash16
示例：
```
gaussdb=# SELECT ledger_gchain_repair('ledgernsp','tab'); 
 ledger_gchain_repair
----------------------
 da30c1260af5be50
(1 row)
```
#### ledger_gchain_archive(void)
描述：归档全局历史表至审计日志目录中hist_back文件夹下。
参数类型：void
返回值类型：Boolean
示例：
```
gaussdb=# SELECT ledger_gchain_archive(); 
 ledger_gchain_archive
-----------------------
 t
(1 row)
```
#### hash16in(cstring)
描述：将输入16进制字符串转化成内部hash16形式。
参数类型：cstring
返回值类型：hash16
#### hash16out(hash16)
描述：将内部hash16类型的数据转码转化为16进制cstring类型。
参数类型：hash16
返回值类型：cstring
#### hash32in(cstring)
描述：将输入16进制字符串（32个字符）转化成内部类型hash32形式。
参数类型：cstring
返回值类型：hash32
#### hash32out(hash32)
描述：将内部hash32类型的数据转码转化为16进制cstring类型。
参数类型：hash32
返回值类型：cstring
