Skip to content

Commit b5a66ae

Browse files
author
Cary Huang
committed
updates
1 parent a9ef873 commit b5a66ae

File tree

5 files changed

+69
-11
lines changed

5 files changed

+69
-11
lines changed

docs/en/getting-started/quick_start.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -388,7 +388,7 @@ postgres=# SELECT * from inventory.orders;
388388
389389
**Sqlserver:**
390390
```bash
391-
docker exec -i mysql mysql -D inventory -umysqluser -pmysqlpwd -e "INSERT INTO orders(order_date, purchaser, quantity, product_id) VALUES ('2025-12-12', 1002, 10000, 102)"
391+
docker exec -i sqlserver /opt/mssql-tools18/bin/sqlcmd -U sa -P 'Password!' -d testDB -C -Q "INSERT INTO orders(order_date, purchaser, quantity, product_id) VALUES ('2025-12-12', 1002, 10000, 102)"
392392
393393
```
394394

docs/en/user-guide/configure_olr.md

Lines changed: 32 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,16 @@
22

33
## **Overview**
44

5-
In addition to LogMiner-based replication, **SynchDB** supports **Openlog Replicator (OLR)** as a data source for Oracle connectors. This integration enables low-latency, redo log–based change data capture from Oracle databases via a standalone replication server.
5+
In addition to LogMiner-based Oracle replication, **SynchDB** supports **Openlog Replicator (OLR)** as a data source for Debezium-based Oracle connectors (type = `oracle`). This integration enables low-latency, redo log–based change data capture from Oracle databases via a standalone replication server.
66

7-
This guide details the configuration steps necessary to associate an Oracle connector with an OLR endpoint using `synchdb_add_olr_conninfo()` and `synchdb_del_olr_conninfo()`.
7+
Furthermore, Synchdb also supports `native` Openlog Replicator connector, which does not rely on Debezium. This is a OLR client written purely in C that eliminates the JNI overheads.
8+
9+
This guide details the configuration steps necessary to:
10+
11+
* associate an Oracle connector with an OLR endpoint
12+
* or create a native Openlog Replicator Connector
13+
14+
Both can be done using `synchdb_add_olr_conninfo()` and `synchdb_del_olr_conninfo()`.
815

916
## **Requirements**
1017

@@ -15,10 +22,29 @@ This guide details the configuration steps necessary to associate an Oracle conn
1522

1623
Refer to this [external guide](https://highgo.atlassian.net/wiki/external/OTUzY2Q2OWFkNzUzNGVkM2EyZGIyMDE1YzVhMDdkNWE) for details on deploying Openlog Replicator via Docker.
1724

25+
## **`synchdb_add_conninfo()`**
26+
27+
To create a **Debezium-based** or **Native** Openlog Replicator, users first have to create the connector with `synchdb_add_conninfo()` but with different `connector type`. For example:
28+
29+
```sql
30+
SELECT synchdb_add_conninfo('olrconn',
31+
'ora19c',
32+
1521,
33+
'DBZUSER',
34+
'dbz',
35+
'FREE',
36+
'postgres',
37+
'null',
38+
'null',
39+
'olr'); -- 'olr' for native openlog replicator or 'oracle' for debezium based openlog replicator connector
40+
41+
```
42+
43+
More on creating a connector can be found [here](https://docs.synchdb.com/user-guide/create_a_connector/)
1844

1945
## **`synchdb_add_olr_conninfo()`**
2046

21-
Registers an Openlog Replicator endpoint for an existing Oracle connector.
47+
With a connector created, the user then registers an Openlog Replicator endpoint for an existing Oracle connector.
2248

2349
**Signature:**
2450

@@ -64,4 +90,6 @@ SELECT synchdb_del_olr_conninfo('oracleconn');
6490

6591
* When both LogMiner and OLR configurations exist, SynchDB defaults to using Openlog Replicator for change capture.
6692
* Restarting the connector is required after modifying its OLR configuration.
67-
* The Oracle instance and OLR must remain synchronized in SCN progression and resetlogs identity for consistency.
93+
* The Oracle instance and OLR must remain synchronized in SCN progression and resetlogs identity for consistency.
94+
* If OLR connection info exists, and connector type is `oracle` then it will use Debezium based Openlog Replicator client to stream changes.
95+
* If OLR connection info exists, and connector type is `olr` then it will use native Openlog Replicator client to stream changes.

docs/zh/getting-started/quick_start.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -391,7 +391,7 @@ postgres=# SELECT * from inventory.orders;
391391
392392
**Sqlserver:**
393393
```bash
394-
docker exec -i mysql mysql -D inventory -umysqluser -pmysqlpwd -e "INSERT INTO orders(order_date, purchaser, quantity, product_id) VALUES ('2025-12-12', 1002, 10000, 102)"
394+
docker exec -i sqlserver /opt/mssql-tools18/bin/sqlcmd -U sa -P 'Password!' -d testDB -C -Q "INSERT INTO orders(order_date, purchaser, quantity, product_id) VALUES ('2025-12-12', 1002, 10000, 102)"
395395

396396
```
397397

docs/zh/user-guide/configure_olr.md

Lines changed: 34 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,16 @@
22

33
## **概述**
44

5-
除了基于 LogMiner 的复制功能外**SynchDB** 还支持将 **Openlog Replicator (OLR)** 作为 Oracle 连接器的数据源。此集成功能支持通过独立的复制服务器从 Oracle 数据库捕获低延迟、基于重做日志的变更数据
5+
除了基于 LogMiner 的 Oracle 复制功能外**SynchDB** 还支持将 **Openlog Replicator (OLR)** 作为基于 Debezium 的 Oracle 连接器(类型为 `oracle`)的数据源。此集成支持通过独立的复制服务器从 Oracle 数据库捕获基于重做日志的低延迟变更数据
66

7-
本指南详细介绍了使用 `synchdb_add_olr_conninfo()``synchdb_del_olr_conninfo()` 将 Oracle 连接器与 OLR 端点关联的配置步骤。
7+
此外,Synchdb 还支持原生 Openlog Replicator 连接器,该连接器不依赖于 Debezium。这是一个纯 C 语言编写的 OLR 客户端,可消除 JNI 开销。
8+
9+
本指南详细介绍了以下配置步骤:
10+
11+
* 将 Oracle 连接器与 OLR 端点关联
12+
* 或创建原生 Openlog Replicator 连接器
13+
14+
这两个操作都可以使用 `synchdb_add_olr_conninfo()``synchdb_del_olr_conninfo()` 完成。
815

916
## **要求**
1017

@@ -15,9 +22,29 @@
1522

1623
有关通过 Docker 部署 Openlog Replicator 的详细信息,请参阅此[外部指南](https://highgo.atlassian.net/wiki/external/OTUzY2Q2OWFkNzUzNGVkM2EyZGIyMDE1YzVhMDdkNWE)
1724

25+
## **`synchdb_add_conninfo()`**
26+
27+
要创建**基于 Debezium 的****原生** Openlog Replicator,用户首先必须使用 `synchdb_add_conninfo()` 创建连接器,但要选择不同的“连接器类型”。例如:
28+
29+
```sql
30+
SELECT synchdb_add_conninfo('olrconn',
31+
'ora19c',
32+
1521,
33+
'DBZUSER',
34+
'dbz',
35+
'FREE',
36+
'postgres',
37+
'null',
38+
'null',
39+
'olr'); -- 原生 Openlog Replicator 连接器为“olr”,基于 Debezium 的 Openlog Replicator 连接器为“oracle”。
40+
41+
```
42+
43+
更多关于创建连接器的信息,请访问[此处](https://docs.synchdb.com/user-guide/create_a_connector/)
44+
1845
## **`synchdb_add_olr_conninfo()`**
1946

20-
为现有的 Oracle 连接器注册 Openlog Replicator 端点。
47+
创建连接器后,用户可以为现有的 Oracle 连接器注册一个 Openlog Replicator 端点。
2148

2249
**签名:**
2350

@@ -63,4 +90,7 @@ SELECT synchdb_del_olr_conninfo('oracleconn');
6390

6491
* 当 LogMiner 和 OLR 配置同时存在时,SynchDB 默认使用 Openlog Replicator 进行更改捕获。
6592
* 修改连接器的 OLR 配置后,需要重新启动连接器。
66-
* Oracle 实例和 OLR 必须在 SCN 进程和 resetlogs 标识方面保持同步,以保持一致性。
93+
* Oracle 实例和 OLR 必须在 SCN 进程和 resetlogs 标识方面保持同步,以保持一致性。
94+
* 如果 OLR 连接信息存在,且连接器类型为“oracle”,则它将使用基于 Debezium 的 Openlog Replicator 客户端来传输更改。
95+
* 如果 OLR 连接信息存在,且连接器类型为“olr”,则它将使用原生 Openlog Replicator 客户端来传输更改。
96+
* 有关 Openlog Replicator 的更多信息,请访问[此处](https://github.com/bersler/OpenLogReplicator)

mkdocs.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,7 @@ plugins:
126126
Oracle CDC to PostgreSQL: Oracle CDC 到 PostgreSQL
127127
Table Snapshot and Re-snapshot: 表快照和重新快照
128128
JMX Monitor Settings: JMX 监视器设置
129-
JVM Memory Usage: JVM内存使用情况
129+
JVM Memory Usage: JVM 内存使用情况
130130
Attribute View: 属性视图
131131
JMX Exporter Settings: JMX exporter 设置
132132
Configure Openlog Replicator for Oracle Connector: 为 Oracle Connector 配置 Openlog Replicator

0 commit comments

Comments
 (0)