使用 KaiwuDB 开发者中心管理 KWDB
安装部署完 KWDB 以后，用户可以使用 KaiwuDB Developer Center（KaiwuDB 开发者中心）连接和管理 KWDB。本文介绍如何使用 KaiwuDB 开发者中心可视化工具连接 KWDB 数据库、创建 KWDB 数据库、管理数据库对象等操作。
KaiwuDB 开发者中心窗口包含菜单栏、工具栏、导航区、对象窗口、结果窗口以及状态栏。
时序数据
创建时序数据库
前提条件：
用户为 Admin 用户、Admin 角色成员或拥有 DATABASE CREATE 或 ALL 权限。
步骤：
如需创建时序数据库，遵循以下步骤。
在数据库导航区，右键单击时序数据库，然后选择新建时序数据库。
在创建时序数据库窗口，填写数据库名称，根据需要设置数据库生命周期和分区间隔，然后单击确定。默认情况下，数据库的生命周期为
0天，即永不过期，分区间隔默认为10天，即每 10 天进行一次分区。
创建成功后，新建数据库将自动显示在数据库导航区内，继承 KaiwuDB 数据库系统的角色和用户设置。
创建时序表
前提条件：
用户为 Admin 用户、Admin 角色成员或拥有 TABLE CREATE 或 ALL 权限。
步骤：
如需创建时序表，遵循以下步骤。
在数据库导航区，选择要操作的数据库和模式。
右键单击时序表，然后选择新建时序表。
系统将自动创建名为
newtable的表，并打开对象窗口。在属性页签，填写表名，表名的最大长度为 128 字节。根据需要设置表的数据活跃时间、生命周期、分区间隔和描述信息。默认情况下，数据活跃时间为
1天，表示自动对 1 天前的分区进行压缩。生命周期为0天， 即数据永不过期，分区间隔为10天，即每 10 天进行一次分区。在字段页签，新建至少两个字段，设置字段名称、数据类型、长度、是否非空、默认值和描述信息，字段名的最大长度为 128 字节。第一个字段的数据类型必须为
timestamp或timestamptz且非空。支持设置的小数点为 3（毫秒）、6（微秒）和9（纳秒）。默认情况下，小数点为 3（毫秒）。实际上，系统会将timestamp数据类型处理为timestamptz数据类型。
在标签页签添加标签，设置标签名称、数据类型、长度、是否为主标签，是否非空和描述信息，然后单击保存。
说明
- 每张时序表至少需要设置一个主标签，且主标签必须为非空标签。
- 标签名暂时不支持中文字符，最大长度为 128 字节。
在执行修改窗口，确认 SQL 语句无误，然后单击执行。
写入数据
前提条件：
用户为 Admin 用户、Admin 角色成员或拥有目标表的 INSERT 权限。
说明
- 系统支持为指定的列写入数据，对于未指定的列，如果该列支持 NULL 值，系统将自动插入默认值
NULL。如果该列不支持 NULL 值，系统将提示Null value in column %s violates null-null constraints.。 - 输入 TIMESTAMP 或 TIMESTAMPTZ 类型数据时，日期部分需要使用短横线（
-）、空格（）或正斜杠符号（/）分割，时间部分需要使用冒号（:）分割，支持精确到微秒，例如：2023-01-25 10:10:10.123、2023 01 25 10:10:10.123或2023/01/25 10:10:10.123。 - KWDB 支持对具有相同时间戳的数据进行去重处理。默认情况下，后写入的数据会覆盖已存在的具有相同时间戳的数据。用户可通过
SET CLUSTER SETTING ts.dedup.rule=[ merge | override | discard]语句设置数据去重策略。有关详细信息，参见集群参数配置。
步骤：
如需向时序表中写入数据，遵循以下步骤。
在数据库导航区，右键单击需要编辑数据的表，然后选择编辑数据。
在数据页面，单击页面下方的添加新行按钮，向表中加入相应的数据。
如需查看对应的 SQL 语句，单击生成 SQL 语句，然后单击执行。
如果无需查看 SQL 语句，单击保存。
查询数据
在数据库导航区，双击需要查看的时序表，即可查看表的属性和数据信息。
提示
- 如果表中包含大量数据行，可以通过工具栏查看数据的总行数，设置每页显示的行数（默认 100 行），并通过点击第一页、上一页、下一页和最后一页图标来分页查看。
- 设置每页显示行数后，需要点击第一页、上一页、下一页或最后一页图标，以查看生效后的分页效果。
关系数据
创建关系数据库
前提条件：
用户为 Admin 用户、Admin 角色成员或拥有 DATABASE CREATE 或 ALL 权限。
步骤：
如需创建关系数据库，遵循以下步骤。
在数据库导航区，右键单击关系数据库，然后选择新建关系数据库。
在创建数据库窗口，填写数据库名称，然后单击确定。
创建成功后，新建数据库将自动显示在数据库导航区内，继承 KWDB 数据库系统的角色和用户设置。
创建关系表
前提条件：
用户为 Admin 用户、Admin 角色成员或拥有 TABLE CREATE 或 ALL 权限。
步骤：
如需创建关系表，遵循以下步骤。
在数据库导航区，选择要操作的数据库和模式。
右键单击表，然后选择新建表。
系统将自动创建名为
newtable的表，并打开对象窗口。在对象窗口，填写表名、描述信息、添加字段，然后单击保存。
在执行修改窗口，确认 SQL 语句无误，然后单击执行。
写入数据
前提条件：
用户为 Admin 用户、Admin 角色成员或拥有目标表的 INSERT 权限。
步骤
如需向关系表中写入数据或者修改表中数据，遵循以下步骤。
在数据库导航区，右键单击需要修改的表，然后选择编辑表。
在属性页签，编辑字段、约束、外键、索引或权限，然后单击保存。
切换到数据页签，单击表格最下方的添加新行按钮，向表中加入相应的数据。
如需查看相应的 SQL 语句，单击生成 SQL 语句，然后单击执行。
如果无需查看 SQL 语句，单击保存。
查询数据
在数据库导航区，双击要查看的表，即可查看表的属性、数据和 ER 图信息。
下表列出了属性、数据和 ER 图中的信息：
| 页面 | 信息 |
|---|---|
| 属性 | 表名、描述、字段、约束、外键、索引、权限和建表语句等信息。 |
| 数据 | 以网格和文本形式查看表内数据。 |
| ER 图 | 以图形方式展示数据库实体、属性和关系之间的结构和链接。 |
提示
- 如果表中包含大量数据行，可以通过工具栏查看数据的总行数，设置每页显示的行数（默认 100 行），并通过点击第一页、上一页、下一页和最后一页图标来分页查看。
- 设置每页显示行数后，需要点击第一页、上一页、下一页或最后一页图标，以查看生效后的分页效果。