Skip to content

Commit a6cb736

Browse files
author
Cary Huang
committed
updates
1 parent afea6e7 commit a6cb736

File tree

2 files changed

+110
-1
lines changed

2 files changed

+110
-1
lines changed

‎docs/en/user-guide/configure_olr.md‎

Lines changed: 55 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Refer to this [external guide](https://highgo.atlassian.net/wiki/external/OTUzY2
2323

2424
SynchDB's OLR support is built against the configuration example below.
2525

26-
26+
**Version 1.3.0**
2727
```json
2828
{
2929
"version": "1.3.0",
@@ -75,6 +75,59 @@ SynchDB's OLR support is built against the configuration example below.
7575

7676
```
7777

78+
**Version 1.8.5**
79+
```json
80+
{
81+
"version": "1.8.5",
82+
"source": [
83+
{
84+
"alias": "SOURCE",
85+
"name": "ORACLE",
86+
"reader": {
87+
"type": "online",
88+
"user": "DBZUSER",
89+
"password": "dbz",
90+
"server": "//ora19c:1521/FREE"
91+
},
92+
"format": {
93+
"type": "json",
94+
"column": 2,
95+
"db": 3,
96+
"interval-dts": 9,
97+
"interval-ytm": 4,
98+
"message": 2,
99+
"rid": 1,
100+
"schema": 7,
101+
"timestamp-all": 1,
102+
"scn-type": 1
103+
},
104+
"memory": {
105+
"min-mb": 64,
106+
"max-mb": 1024,
107+
"swap-path": "/opt/OpenLogReplicator/olrswap"
108+
},
109+
"filter": {
110+
"table": [
111+
{"owner": "DBZUSER", "table": ".*"}
112+
]
113+
},
114+
"flags": 32
115+
}
116+
],
117+
"target": [
118+
{
119+
"alias": "DEBEZIUM",
120+
"source": "SOURCE",
121+
"writer": {
122+
"type": "network",
123+
"uri": "0.0.0.0:7070"
124+
}
125+
}
126+
]
127+
}
128+
129+
```
130+
78131
Please note the following:
79132

80133
- "source"."name": "ORACLE" -> this should match the `olr_source` value when defining OLR parameters via `synchdb_add_olr_conninfo()` (See below)
@@ -83,6 +136,7 @@ Please note the following:
83136
- "source"."reader"."server" -> this should contain the values of `hostname`, `port` and `source database` values when creating a connector via `synchdb_add_conninfo()`
84137
- "source"."filter"."table":[] -> this filters the change events that Openlog Replicator captures. <<<**IMPORTANT**>>>: This is currently the only way to filter change events from Oracle as OLR implementations in SynchDB does not do any filtering at this moment. (The `table` and `snapshot table` values are ignored when creating a connector via `synchdb_add_conninfo()`)
85138
- "format":{} -> the specific paylod format ingested by Debezium based or native Openlog Replicator connector. Use these values as specified.
139+
- "memory"."swap-path" -> this tells OLR where to write swap files in low memory scenario.
86140
- "target".[0]."writer"."type": -> this must specify `network` as both Debezium and native Openlog Replicator connector communicate with Openlog Replicator via network
87141
- "target".[0]."writer"."uri": -> this is the bind host and port Openlog Replicator listens on that SynchDB should be able to access via `olr_host` and `olr_port` when defining OLR parameters via `synchdb_add_olr_conninfo()`.
88142

‎docs/zh/user-guide/configure_olr.md‎

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@
2323

2424
SynchDB 的 OLR 支持基于以下配置示例构建。
2525

26+
**Version 1.3.0**
2627
```json
2728
{
2829
"version": "1.3.0",
@@ -74,6 +75,59 @@ SynchDB 的 OLR 支持基于以下配置示例构建。
7475

7576
```
7677

78+
**Version 1.8.5**
79+
```json
80+
{
81+
"version": "1.8.5",
82+
"source": [
83+
{
84+
"alias": "SOURCE",
85+
"name": "ORACLE",
86+
"reader": {
87+
"type": "online",
88+
"user": "DBZUSER",
89+
"password": "dbz",
90+
"server": "//ora19c:1521/FREE"
91+
},
92+
"format": {
93+
"type": "json",
94+
"column": 2,
95+
"db": 3,
96+
"interval-dts": 9,
97+
"interval-ytm": 4,
98+
"message": 2,
99+
"rid": 1,
100+
"schema": 7,
101+
"timestamp-all": 1,
102+
"scn-type": 1
103+
},
104+
"memory": {
105+
"min-mb": 64,
106+
"max-mb": 1024,
107+
"swap-path": "/opt/OpenLogReplicator/olrswap"
108+
},
109+
"filter": {
110+
"table": [
111+
{"owner": "DBZUSER", "table": ".*"}
112+
]
113+
},
114+
"flags": 32
115+
}
116+
],
117+
"target": [
118+
{
119+
"alias": "DEBEZIUM",
120+
"source": "SOURCE",
121+
"writer": {
122+
"type": "network",
123+
"uri": "0.0.0.0:7070"
124+
}
125+
}
126+
]
127+
}
128+
129+
```
130+
77131
请注意以下几点：
78132

79133
- "source"."name": "ORACLE" -> 通过 `synchdb_add_olr_conninfo()` 定义 OLR 参数时，此字段应与 `olr_source` 值匹配（见下文）
@@ -82,6 +136,7 @@ SynchDB 的 OLR 支持基于以下配置示例构建。
82136
- "source"."reader"."server" -> 通过 `synchdb_add_conninfo()` 创建连接器时，此字段应包含 `hostname`、`port` 和 `source database` 的值
83137
- "source"."filter"."table":[] -> 这会过滤 Openlog Replicator 捕获的变更事件。<<<**重要**>>>：这是目前从 Oracle 过滤变更事件的唯一方法，因为 SynchDB 中的 OLR 实现目前不进行任何过滤。（通过 `synchdb_add_conninfo()` 创建连接器时，`table` 和 `snapshot table` 的值会被忽略。）
84138
- "format":{} -> 基于 Debezium 或原生 Openlog Replicator 连接器提取的特定 Paylod 格式。请按照指定的方式使用这些值。
139+
- “memory”.“swap-path” -> 这告诉 OLR 在内存不足的情况下将交换文件写入哪里。
85140
- "target".[0].."writer"."type": -> 必须指定 `network`，因为 Debezium 和原生 Openlog Replicator 连接器都通过网络与 Openlog Replicator 通信。
86141
- "target".[0].."writer"."uri": -> 这是 Openlog Replicator 监听的绑定主机和端口，SynchDB 应该能够在通过 `synchdb_add_olr_conninfo()` 定义 OLR 参数时通过 `olr_host` 和 `olr_port` 访问该主机和端口。
87142

0 commit comments

Comments
 (0)