版本:v5.7
版本说明
支持的 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
- 不同的结构变更对应的执行策略与目的地节点相关,不同节点支持的策略可能不同;
- YaShanDB 结构变更限制较多,更多详细信息请查看官方文档。
:::
添加 YaShanDB 节点的操作步骤
- 点击添加节点,选择了 YaShanDB 节点类型之后,显示 YaShanDB 的基本信息配置模板:
- 版本:YaShanDB 23.4.1
- 连接配置
- 服务器地址:输入节点IP地址及端口号,如172.16.3.68:1690
- 数据库:该数据库配置为连接实例名,进行不要修改该配置;若修改后再配置映射时,可能需要手动刷新映射列表
- 兼容模式:
- yashan模式
- mysql模式
- 认证类型
- 口令认证
- 用户名:输入 YaShanDB 数据库登录的用户名
- 密码:输入用户对应密码
- 口令认证
- 连接参数:用户可自定义连接参数