update

Author: Cary Huang

docs/en/getting-started/quick_start.md

@@ -181,6 +181,19 @@ SELECT * FROM synchdb_conninfo;
 
 More details on creating a connector can be found [here](https://docs.synchdb.com/user-guide/create_a_connector/)
 
+## **Create Object Mappings**
+
+By default, source database names will be mapped to a schema name in destination. Object mappings can be used to change this schema name. Let's change the destination schema for `orders` table from oracle based connectors and leave the rest as default.
+
+```sql
+SELECT synchdb_add_objmap('oracleconn','table','free.c##dbzuser.orders','oracle23ai.orders');
+SELECT synchdb_add_objmap('ora19cconn','table','free.dbzuser.orders','oracle19c.orders');
+SELECT synchdb_add_objmap('olrconn','table','free.dbzuser.orders','olr.orders');
+
+```
+
+More details on creating a object mappings can be found [here](https://docs.synchdb.com/user-guide/object_mapping_rules/)
+
 ## **Create JMX Exporter - Optional**
 
 Here are some examples to enable JMX exporter for monitoring (If Prometheus + Grafana have been pre-deployed by `ezdeploy.sh`):
@@ -265,6 +278,12 @@ More details on connector start can be found [here](https://docs.synchdb.com/use
 
 Use `synchdb_state_view()` to examine all connectors' running states. 
 
+``` SQL
+SELECT * FROM synchdb_state_view;
+
+```
+
+Example outputs:
 ``` SQL
 postgres=# SELECT * FROM synchdb_state_view;
      name      | connector_type |  pid   |        stage        |  state  |   err    |                                           last_dbz_offset
@@ -286,74 +305,89 @@ By default, the connector will perform a `initial` snapshot to capture both the
 
 **MySQL:**
 ```sql
-postgres=# SET search_path=public,inventory;
-SET
-postgres=# \d
-                 List of relations
-  Schema   |        Name        |   Type   | Owner
------------+--------------------+----------+--------
- inventory | addresses          | table    | ubuntu
- inventory | addresses_id_seq   | sequence | ubuntu
- inventory | customers          | table    | ubuntu
- inventory | customers_id_seq   | sequence | ubuntu
- inventory | geom               | table    | ubuntu
- inventory | geom_id_seq        | sequence | ubuntu
- inventory | perf_test_1        | table    | ubuntu
- inventory | products           | table    | ubuntu
- inventory | products_id_seq    | sequence | ubuntu
- inventory | products_on_hand   | table    | ubuntu
- public    | synchdb_att_view   | view     | ubuntu
- public    | synchdb_attribute  | table    | ubuntu
- public    | synchdb_conninfo   | table    | ubuntu
- public    | synchdb_objmap     | table    | ubuntu
- public    | synchdb_state_view | view     | ubuntu
- public    | synchdb_stats_view | view     | ubuntu
-(16 rows)
+\dt inventory.*
+
+```
+
+```sql
+\dt inventory.*
+               List of relations
+  Schema   |       Name       | Type  | Owner
+-----------+------------------+-------+--------
+ inventory | addresses        | table | ubuntu
+ inventory | customers        | table | ubuntu
+ inventory | geom             | table | ubuntu
+ inventory | orders           | table | ubuntu
+ inventory | products         | table | ubuntu
+ inventory | products_on_hand | table | ubuntu
+(6 rows)
 ```
 
 **Sqlserver:**
 ```sql
-postgres=# SET search_path=public,testdb;
-SET
-postgres=# \d
-                  List of relations
- Schema |          Name           |   Type   | Owner
---------+-------------------------+----------+--------
- public | synchdb_att_view        | view     | ubuntu
- public | synchdb_attribute       | table    | ubuntu
- public | synchdb_conninfo        | table    | ubuntu
- public | synchdb_objmap          | table    | ubuntu
- public | synchdb_state_view      | view     | ubuntu
- public | synchdb_stats_view      | view     | ubuntu
- testdb | customers               | table    | ubuntu
- testdb | customers_id_seq        | sequence | ubuntu
- testdb | orders                  | table    | ubuntu
- testdb | orders_order_number_seq | sequence | ubuntu
- testdb | products                | table    | ubuntu
- testdb | products_id_seq         | sequence | ubuntu
- testdb | products_on_hand        | table    | ubuntu
-(13 rows)
-
-```
-
-**Oracle23ai, Oracle19c, and OLR:**
-```sql
-postgres=# SET search_path=public,free;
-SET
-postgres=# \d
-              List of relations
- Schema |        Name        | Type  | Owner
---------+--------------------+-------+--------
- free   | orders             | table | ubuntu
- public | synchdb_att_view   | view  | ubuntu
- public | synchdb_attribute  | table | ubuntu
- public | synchdb_conninfo   | table | ubuntu
- public | synchdb_objmap     | table | ubuntu
- public | synchdb_state_view | view  | ubuntu
- public | synchdb_stats_view | view  | ubuntu
-(7 rows)
+\dt testdb.*
+
+```
+
+```sql
+\dt testdb.*
+             List of relations
+ Schema |       Name       | Type  | Owner
+--------+------------------+-------+--------
+ testdb | customers        | table | ubuntu
+ testdb | orders           | table | ubuntu
+ testdb | products         | table | ubuntu
+ testdb | products_on_hand | table | ubuntu
+(4 rows)
+
+```
+
+**Oracle23ai**
+```sql
+\dt oracle23ai.*
+
+```
+
+```sql
+\dt oracle23ai.*
+          List of relations
+   Schema   |  Name  | Type  | Owner
+------------+--------+-------+--------
+ oracle23ai | orders | table | ubuntu
+(1 row)
+
+```
+
+**Oracle19c**
+```sql
+\dt oracle19c.*
+
+```
+
+```sql
+\dt oracle19c.*
+          List of relations
+  Schema   |  Name  | Type  | Owner
+-----------+--------+-------+--------
+ oracle19c | orders | table | ubuntu
+(1 row)
+```
+
+**OLR**
+```sql
+\dt olr.*
 
 ```
+
+```sql
+\dt olr.*
+        List of relations
+ Schema |  Name  | Type  | Owner
+--------+--------+-------+--------
+ olr    | orders | table | ubuntu
+(1 row)
+```
+
 ## Similate an INSERT Event and Observe CDC
 
 We can use `docker exec` to similate an INSERT for each connector type and observe the Change Data Capture (CDC).
@@ -403,7 +437,26 @@ echo -ne "INSERT INTO orders(order_number, order_date, purchaser, quantity, prod
 ```
 
 ```sql
-postgres=# SELECT * FROM free.orders;
+postgres=# SELECT * FROM oracle23ai.orders;
+ order_number |     order_date      | purchaser | quantity | product_id
+--------------+---------------------+-----------+----------+------------
+        10001 | 2024-01-01 00:00:00 |      1003 |        2 |        107
+        10002 | 2024-01-01 00:00:00 |      1003 |        2 |        107
+        10003 | 2024-01-01 00:00:00 |      1003 |        2 |        107
+        10004 | 2024-01-01 00:00:00 |      1003 |        2 |        107
+        10005 | 2025-12-12 00:00:00 |      1002 |    10000 |        102
+(5 rows)
+
+```
+
+**Oracle19c:**
+```bash
+echo -ne "INSERT INTO orders(order_number, order_date, purchaser, quantity, product_id) VALUES (10005, TO_DATE('2025-12-12', 'YYYY-MM-DD'), 1002, 10000, 102);\n" | docker exec -i ora19c sqlplus DBZUSER/dbz@//localhost:1521/FREE
+
+```
+
+```sql
+postgres=# SELECT * FROM oracle19c.orders;
  order_number |     order_date      | purchaser | quantity | product_id
 --------------+---------------------+-----------+----------+------------
         10001 | 2024-01-01 00:00:00 |      1003 |        2 |        107
@@ -415,14 +468,14 @@ postgres=# SELECT * FROM free.orders;
 
 ```
 
-**Oracle19c and OLR:**
+**OLR:**
 ```bash
 echo -ne "INSERT INTO orders(order_number, order_date, purchaser, quantity, product_id) VALUES (10005, TO_DATE('2025-12-12', 'YYYY-MM-DD'), 1002, 10000, 102);\n" | docker exec -i ora19c sqlplus DBZUSER/dbz@//localhost:1521/FREE
 
 ```
 
 ```sql
-postgres=# SELECT * FROM free.orders;
+postgres=# SELECT * FROM olr.orders;
  order_number |     order_date      | purchaser | quantity | product_id
 --------------+---------------------+-----------+----------+------------
         10001 | 2024-01-01 00:00:00 |      1003 |        2 |        107