金仓数据库KingbaseES DBMS_UTILITY.GET_HASH_VALUE详解

1.关键字

Get_hash_value

2.功能

对于指定的字符串，返回范围在[base, base+hase_size-1]的散列值

3.语法

FUNCTION GET_HASH_VALUE(

NAME VARCHAR2,

BASE NUMBER,

HASH_SIZE NUMBER

)RETURN NUMBER;

4.参数详解

NAME：指定的要被 HASH 的字符串

BASE： 返回的 HASH 值的基准值，即返回值的最小值

HASH_SIZE： 指定的 HASH 表的大小

5.返回值

基于输入字符串的哈希

6.异常

BASE参数为NULL，则报错“bad argument”。

HASH_SIZE参数为NULL，则报错“bad argument”。

HASH_SIZE为0时，则报错“bad argument”。

7.使用说明

BASE可为负值。

返会HASH值的最小值为BASE；返回HASH值的最大值BASH+HASH_SIZE-1。

例如，若要获取哈希值介于1000和3047之间的字符串的哈希值，请使用1000作为基值，使用2048作为HASH表大小。对参数使用2的幂效果最佳。

若HASH_SIZE为负值则返回的哈希值不在哈希范围内，哈希值可能为正，也可能为负。

KingbaseES无法hash字符串为NULL的情况。因此约定KingbaseES遇此函数的第一个参数为NULL时且其他参数正常，则直接返回BASH值。

因哈希算法不同，因此Kingbase可不兼容oracle的哈希值。KingbaseES此函数哈希算法主要采用数据库内部string_hash函数

8.示例

SQL> select DBMS_UTILITY.GET_HASH_VALUE('hello world',1,100) from dual;

DBMS_UTILITY.GET_HASH_VALUE('HELLOWORLD',1,100)
-----------------------------------------------
                                             69
--多一个空格
select DBMS_UTILITY.GET_HASH_VALUE('hello world ',1,100) from dual;
SQL> select DBMS_UTILITY.GET_HASH_VALUE('hello world ',1,100) from dual;
DBMS_UTILITY.GET_HASH_VALUE('HELLOWORLD',1,100)
-----------------------------------------------
                                             45
--改变基准值
select DBMS_UTILITY.GET_HASH_VALUE('hello world',2,100) from dual;

SQL> select DBMS_UTILITY.GET_HASH_VALUE('hello world',2,100) from dual;

DBMS_UTILITY.GET_HASH_VALUE('HELLOWORLD',2,100)
-----------------------------------------------
                                             70
--改变哈希范围
select DBMS_UTILITY.GET_HASH_VALUE('hello world',1,99) from dual;
SQL> select DBMS_UTILITY.GET_HASH_VALUE('hello world',1,99) from dual;
DBMS_UTILITY.GET_HASH_VALUE('HELLOWORLD',1,99)
----------------------------------------------
                                            20
SQL> select DBMS_UTILITY.GET_HASH_VALUE('',1,100) from dual;
DBMS_UTILITY.GET_HASH_VALUE('',1,100)
-------------------------------------
                                   41
SQL> select DBMS_UTILITY.GET_HASH_VALUE(NULL,1,100) from dual;
DBMS_UTILITY.GET_HASH_VALUE(NULL,1,100)