金仓数据库 KingbaseES 插件参考手册（20. dbms_random）

20. dbms_random

20.1. 插件dbms_random简介

dbms_random是KingbaseES的一个扩展插件，主要提供一组函数产生随机数或者随机字符。

插件需要手动创建，在服务端程序启动时没有默认加载。

• 插件名为 dbms_random

• 插件版本 V1.0

20.2. 插件dbms_random加载方式

启动KingbaseES数据库后执行SQL命令创建插件。

示例

create extension dbms_random;

20.3. 插件dbms_random的参数配置

无需配置任何参数

20.4. 插件dbms_random的使用方法

创建插件后提供一组函数来产生随机数或随机字符。

下表列出了dbms_random系统包并简要的表述了它们。

20.4.1. INITIALIZE Procedure

使用一个种子值来初始化dbms_random包，默认情况下，dbms_random包是根据用户、时间、会话来初始化。Initialize这个函数已经过时，虽然目前受到支持，但考虑历史遗留原因和兼容性保留此初始化方式。

语法格式

dbms_random.initialize(init INTEGER);

参数说明

返回值说明

VOID

示例

CALL dbms_random.initialize(8);

20.4.2. NORMAL Function

产生标准的正态分布函数，此正态分布的标准差为1，期望值为0。

语法格式

dbms_random.normal();

参数说明

无参

返回值说明

DOUBLE

示例

SELECT dbms_random.normal();

20.4.3. RANDOM Function

产生一个随机整数，这个函数已经过时了，虽然目前还支持，但不应该使用它，考虑兼容性保留此函数。

语法格式

dbms_random.random();

参数说明

无参

返回值说明

INTEGER

示例

CALL dbms_random.random();

20.4.4. SEED Procedure

重置种子，类似于initialize函数，initialize函数已经被淘汰。 seed函数同时支持数值和字符作为种子值，而initialize只支持数值。

语法格式

dbms_random.seed(i INTEGER);
dbms_random.seed(t TEXT);

参数说明

返回值说明

示例

CALL dbms_random.seed(8);
CALL dbms_random.seed('test');

20.4.5. STRING Function

获取一个随机字符串，第一个参数是字符串的格式，第二个参数是指字符串的长度。 长度最大为5000，参数如果超过5000会自动以5000处理。

语法格式

dbms_random.string(type TEXT,len INTEGER);

参数说明

返回值说明

TEXT

示例

SELECT dbms_random.string('U',5);
SELECT dbms_random.string('P',2);
SELECT dbms_random.string('x',4);
SELECT dbms_random.string('a',2);
SELECT dbms_random.string('l',3);

20.4.6. TERMINATE Procedure

原功能为使用完dbms_random包的时候执行此函数，但是现在此函数不执行任何功能，为了语法兼容保留。

语法格式

dbms_random.terminate();

参数说明

无参

返回值说明

VOID

示例

CALL dbms_random.terminate();

20.4.7. VALUE Function

第一种无参的使用方式是获取一个大于或者等于0且小于1的随机数，精度为16位的小数。

第二种使用方式可以指定最小值和最大值，返回值的范围大于或者等于low，小于high，精度同为16位小数。

语法格式

dbms_random.value();
dbms_random.value(low INTEGER,high INTEGER);

参数说明

返回值说明

示例

SELECT dbms_random.value();
SELECT dbms_random.value(10,15);

20.5. 插件dbms_random卸载方法

在数据库中执行SQL命令卸载插件。

drop extension dbms_random;

20.6. 插件dbms_random升级方法

dbms_random扩展插件通常随着KingbaseES安装包一并升级。通常情况下用户无须单独升级插件。