跳到主要内容
版本:v5.13

版本说明

支持的 YaShanDB 的版本如下:

节点版本要求权限要求其他要求
数据源节点+ JDBC 读取支持23.4.1(企业版)的yashan模式以及mysql模式,支持单机部署
+ YStream 读取支持23.4.1(企业版)的yashan模式,支持单机部署
+ JDBC
- 权限:CREATE SESSION、SELECT
+ Ystream
- 权限:用户权限CREATE SESSION,SELECT ANY TABLE,YSTREAM_CAPTURE;赋予用户对系统视图 V_$YSTREAM_SERVER、V_$DATABASE 的SELECT 权限
YStream仅支持解析归档模式下生成的redo和归档日志,使用YStream时,必须打开数据库归档,否则创建YStream服务时报错。在YashanDB主库开启附加日志
目的地节点+ JDBC 写入支持23.4.1(企业版)的yashan模式以及mysql模式,支持单机部署+ SELECT ANY TABLE
+ INSERT ANY TABLE
+ UPDATE ANY TABL
+ DELETE ANY TABLE
+ ALTER ANY TABLE
+ DROP ANY TABLE
+ CREATE ANY TABLE
+ CREATE ANY INDEX
+ CREATE SESSION
+ 赋予用户对系统表 DBA_TABLESPACES 的 SELECT 权限

节点特性

表​

表类型YaShan模式MySQL模式其他要求
HEAP 表✔️✔️
LSC 表✔️❌+ YaShan模式目的地新建 LSC 表所选数据库字符集必须设置为UTF8
+ YaShan模式目的地新建 LSC 表时,必须在存储配置中,选择该表的表空间
TAC 表✔️❌+ YaShan模式目的地新建 TAC 表所选数据库字符集必须设置为UTF8

索引​

源节点​

索引类型YaShan模式MySQL模式其他要求
普通索引✔️✔️
唯一索引✔️✔️
反转索引✔️❌
函数索引✔️❌+ YaShan模式做源时,若目的地节点不支持函数索引则无法自动映射

目的地节点​

索引类型YaShan模式MySQL模式其他要求
普通索引✔️✔️
唯一索引✔️✔️
反转索引✔️❌
函数索引✔️❌

数据类型​

YaShan模式​

数据类型读取写入其他要求
TINYINT✔️✔️
SMALLINT✔️✔️
INTEGER✔️✔️
BIGINT✔️✔️
FLOAT✔️✔️
DOUBLE✔️✔️
NUMBER✔️✔️
BIT✔️✔️
CHAR✔️✔️
VARCHAR✔️✔️
NCHAR✔️✔️
NVARCHAR✔️✔️
BOOLEAN✔️✔️
DATE✔️✔️
TIME✔️✔️
TIMESTAMP✔️✔️
BLOB✔️✔️
CLOB✔️✔️
NCLOB✔️✔️
RAW✔️✔️
JSON✔️✔️

MySQL模式​

数据类型读取写入其他要求
TINYINT✔️✔️
TINYINT_UNSIGNED✔️✔️
SMALLINT✔️✔️
SMALLINT_UNSIGNED✔️✔️
MEDIUMINT✔️✔️
MEDIUMINT_UNSIGNED✔️✔️
INTEGER✔️✔️
INTEGER_UNSIGNED✔️✔️
BIGINT✔️✔️
BIGINT_UNSIGNED✔️✔️
FLOAT✔️✔️
FLOAT_UNSIGNED✔️✔️
DOUBLE✔️✔️
DOUBLE_UNSIGNED✔️✔️
DECIMAL✔️✔️
DECIMAL_UNSIGNED✔️✔️
CHAR✔️✔️
VARCHAR✔️✔️
TINYTEXT✔️✔️
TEXT✔️✔️
MEDIUMTEXT✔️✔️
LONGTEXT✔️✔️
TINYBLOB✔️✔️
BLOB✔️✔️
MEDIUMBLOB✔️✔️
LONGBLOB✔️✔️
DATE✔️✔️
TIME✔️✔️
TIMESTAMP✔️✔️
DATETIME✔️✔️
BINARY✔️✔️
VARBINARY✔️✔️

数据写入策略​

DML操作YStream读取JDBC读取限制
INSERT设置逻辑主键表:
+ INSERT
+ MERGE
+ IGNORE
无主键表:
+ INSERT
+ IGNORE
设置逻辑主键表:
+ INSERT
+ MERGE
+ IGNORE
无主键表:
+ INSERT
+ IGNORE
YaShanDB作为目的地节点时有以下限制:
+ MERGE 适用于单机 HEAP/TAC 表和共享集群部署(语句中的merge_update_clause和merge_insert_clause至少要定义一个)。
+ 不能对 TAC 执行 UPDATE 操作。
+ 对 LSC 表更新数据时,约束如下:
- 不能对 LSC表执行跨分区更新。
- 更新 LSC 表冷数据的数据,需要开启 ROW MOVEMENT
详细限制说明请查看官方文档
UPDATE设置逻辑主键表:
+ UPDATE
+ MERGE
+ IGNORE
无主键表:
+ INSERT
+ IGNORE
- JDBC读取不支持设置源 UPDATE 操作的相应写入策略
DELETE设置逻辑主键表:
+ DELETE
+ MERGE
+ IGNORE
无主键表:
+ INSERT
+ IGNORE
- JDBC读取不支持设置源DELETE 操作的相应写入策略

结构变化策略​

结构变更YStream读取JDBC读取限制
数据源删除正在同步的表
+ 暂停
+ 持续扫描并保留数据目的地表和数据
+ 删除映射并保留数据目的地表和数据
+ 暂停
+ 持续扫描并保留数据目的地表和数据
+ 删除映射并保留数据目的地表和数据

数据源清空正在同步的表的数据
****
+ 暂停
+ 忽略,不在目的地清空数据
+ 自动在目的地清空同步的表的数据
- JDBC读取不支持该结构变化
数据源正在同步的表新增字段+ 暂停
+ 忽略新增字段
+ 为新增字段建立映射并同步新增字段
+ 暂停
+ 忽略新增字段
+ 为新增字段建立映射并同步新增字段
数据源正在同步的表中字段被删除+ 暂停
+ 删除映射但保留目的地表中字段和数据,并写入空值
+ 删除映射并删除目的地表中字段和数据
+ 暂停
+ 删除映射但保留目的地表中字段和数据,并写入空值
+ 删除映射并删除目的地表中字段和数据
+ 如果删除的列字段已被定义为主键组合中的一项,则不允许删除此列,但可以删除整个主键对应的列组合。
+ 如果删除的列字段已被定义为索引对象中的一项,则删除此列字段后,其对应的索引对象也被删除。
+ LSC表中,不允许删除被定义为排序键的列字段。
数据源正在同步的表中的字段被重命名+ 暂停
+ 忽略,不在目的地重命名该字段
+ 自动重命名该字段
- JDBC读取不支持该结构变化
数据源正在同步的字段变化(类型、精度、标度)+ 暂停
+ 忽略,按照当前字段映射继续同步
+ 按照源的字段变化,重新匹配语义映射规则,继续同步
+ 暂停
+ 忽略,按照当前字段映射继续同步
+ 按照源的字段变化,重新匹配语义映射规则,继续同步
LSC表不允许修改列字段的数据类型,HEAP表和TAC表列字段数据类型修改规则如下:
+ 索引所在列:
- 若为空表(即无数据),允许将其修改为除LOB/JSON/UDT/XMLTYPE外的数据类型。
- 若为非空表,则不允许修改其数据类型。
+ 变长存储的字符型列(仅适用于TAC表):不允许在数据库进行回滚时,修改其数据类型。
+ 函数索引或AC所在列:不允许修改其数据类型。
+ 原数据类型为LOB/JSON/UDT/XMLTYPE的其他列:不允许修改其数据类型。
+ 原数据类型为字符型的其他空列:允许将其修改为除LOB/JSON/UDT/XMLTYPE外的其他数据类型。
+ 原数据类型为字符型的其他非空列:允许修改为不同字符型,但仍需遵顼以下规则:
- 不允许CHAR/VARCHAR与NCHAR/NVARCHAR交叉修改。
- 当按长度属性从大向小修改时,必须保证该列现有数据的长度均未超过目标数据类型的上限,否则无法修改成功并提示相应错误。HEAP表不允许跨存储方式修改数据类型,例如HEAP表不允许将列数据类型从
- VARCHAR(3200)(采用普通字符串存储)修改为VARCHAR(8004)(会自动转换为LOB型存储),而TAC表允许此操作。存储方式介绍请查阅字符型。
- 原数据类型为其他数据类型的其他空列:允许将其修改为除LOB/JSON/UDT/XMLTYPE外的其他数据类型。
+ 原数据类型为其他数据类型的其他非空列:
- 不允许跨大类修改数据类型,例如不允许将数值型修改为字符型。
- 同一数据大类中,除字符型外其他类型只允许按值域、精度、长度等属性从小向大修改数据类型,例如不允许将INT修改为指定了精度的NUMBER,不允许将DATE修改为TIME。

:::color3

  1. 不同的结构变更对应的执行策略与目的地节点相关,不同节点支持的策略可能不同;
  2. YaShanDB 结构变更限制较多,更多详细信息请查看官方文档。

:::

添加 YaShanDB 节点的操作步骤

  • 点击添加节点,选择了 YaShanDB 节点类型之后,显示 YaShanDB 的基本信息配置模板:
    • 版本:YaShanDB 23.4.1
  • 连接配置
    • 服务器地址:输入节点IP地址及端口号,如172.16.3.68:1690
    • 数据库:该数据库配置为连接实例名,进行不要修改该配置;若修改后再配置映射时,可能需要手动刷新映射列表
  • 兼容模式:
    • yashan模式
    • mysql模式
  • 认证类型
    • 口令认证
      • 用户名:输入 YaShanDB 数据库登录的用户名
      • 密码:输入用户对应密码
  • 连接参数:用户可自定义连接参数