This is an automated email from the ASF dual-hosted git repository.
xiaochenzhou pushed a commit to branch dev
in repository https://gitbox.apache.org/repos/asf/seatunnel.git
The following commit(s) were added to refs/heads/dev by this push:
new 7ae6111b0d [Improve][Doc] Update table_path examples for clarity and
consistency (#10202)
7ae6111b0d is described below
commit 7ae6111b0d24a6f2a73d4f4d4a34a68923988064
Author: Jast <[email protected]>
AuthorDate: Sat Dec 20 17:54:53 2025 +0800
[Improve][Doc] Update table_path examples for clarity and consistency
(#10202)
---
docs/en/connector-v2/source/Mysql.md | 2 +-
docs/en/connector-v2/source/Oracle.md | 2 +-
docs/en/connector-v2/source/PostgreSQL.md | 2 +-
docs/en/connector-v2/source/SqlServer.md | 2 +-
docs/zh/connector-v2/source/Mysql.md | 2 +-
docs/zh/connector-v2/source/Oracle.md | 2 +-
docs/zh/connector-v2/source/PostgreSQL.md | 2 +-
docs/zh/connector-v2/source/SqlServer.md | 2 +-
8 files changed, 8 insertions(+), 8 deletions(-)
diff --git a/docs/en/connector-v2/source/Mysql.md
b/docs/en/connector-v2/source/Mysql.md
index eec04de707..3c9b9ac96b 100644
--- a/docs/en/connector-v2/source/Mysql.md
+++ b/docs/en/connector-v2/source/Mysql.md
@@ -84,7 +84,7 @@ Read external data source data through JDBC.
| fetch_size | Int | No | 0
| For queries that return a large number of objects,you can
configure<br/> the row fetch size used in the query toimprove performance
by<br/> reducing the number database hits required to satisfy the selection
criteria.<br/> Zero means use jdbc default value.
[...]
| properties | Map | No | -
| Additional connection configuration parameters,when properties and
URL have the same parameters, the priority is determined by the <br/>specific
implementation of the driver. For example, in MySQL, properties take precedence
over the URL.
[...]
| use_regex | Boolean | No | false
| Control regular expression matching for table_path. When set to
`true`, the table_path will be treated as a regular expression pattern. When
set to `false` or not specified, the table_path will be treated as an exact
path (no regex matching).
[...]
-| table_path | String | No | -
| The path to the full path of table, you can use this configuration
instead of `query`. <br/>examples: <br/>mysql: "testdb.table1" <br/>oracle:
"test_schema.table1" <br/>sqlserver: "testdb.test_schema.table1"
<br/>postgresql: "testdb.test_schema.table1"
[...]
+| table_path | String | No | -
| The path to the full path of table, you can use this configuration
instead of `query`. <br/>example: <br/>"testdb.table1"
[...]
| table_list | Array | No | -
| The list of tables to be read, you can use this configuration instead
of `table_path` example: ```[{ table_path = "testdb.table1"}, {table_path =
"testdb.table2", query = "select * id, name from testdb.table2"}]```
[...]
| where_condition | String | No | -
| Common row filter conditions for all tables/queries, must start with
`where`. for example `where id > 100`
[...]
| split.size | Int | No | 8096
| The split size (number of rows) of table, captured tables are split
into multiple splits when read of table.
[...]
diff --git a/docs/en/connector-v2/source/Oracle.md
b/docs/en/connector-v2/source/Oracle.md
index bd1bf02685..332e9852e8 100644
--- a/docs/en/connector-v2/source/Oracle.md
+++ b/docs/en/connector-v2/source/Oracle.md
@@ -77,7 +77,7 @@ Read external data source data through JDBC.
| fetch_size | Int | No | 0 | For
queries that return a large number of objects,you can configure<br/> the row
fetch size used in the query toimprove performance by<br/> reducing the number
database hits required to satisfy the selection criteria.<br/> Zero means use
jdbc default value. |
| properties | Map | No | - |
Additional connection configuration parameters,when properties and URL have the
same parameters, the priority is determined by the <br/>specific implementation
of the driver. For example, in Oracle, properties take precedence over the URL.
|
| use_regex | Boolean | No | false |
Control regular expression matching for table_path. When set to `true`, the
table_path will be treated as a regular expression pattern. When set to `false`
or not specified, the table_path will be treated as an exact path (no regex
matching). |
-| table_path | String | No | -
| The path to the full path of table, you can use this configuration
instead of `query`. <br/>examples: <br/>mysql: "testdb.table1" <br/>oracle:
"test_schema.table1" <br/>sqlserver: "testdb.test_schema.table1"
<br/>postgresql: "testdb.test_schema.table1"
[...]
+| table_path | String | No | -
| The path to the full path of table, you can use this configuration
instead of `query`. <br/>example: <br/>"test_schema.table1"
[...]
| table_list | Array | No | -
| The list of tables to be read, you can use this configuration instead
of `table_path` example: ```[{ table_path = "testdb.table1"}, {table_path =
"testdb.table2", query = "select * id, name from testdb.table2"}]```
[...]
| where_condition | String | No | -
| Common row filter conditions for all tables/queries, must start with
`where`. for example `where id > 100`
[...]
| split.size | Int | No | 8096
| The split size (number of rows) of table, captured tables are split
into multiple splits when read of table.
[...]
diff --git a/docs/en/connector-v2/source/PostgreSQL.md
b/docs/en/connector-v2/source/PostgreSQL.md
index 85e486eca9..2090dec3db 100644
--- a/docs/en/connector-v2/source/PostgreSQL.md
+++ b/docs/en/connector-v2/source/PostgreSQL.md
@@ -91,7 +91,7 @@ Read external data source data through JDBC.
| fetch_size | Int | No | 0
| For queries that return a large number of objects,you can
configure<br/> the row fetch size used in the query toimprove performance
by<br/> reducing the number database hits required to satisfy the selection
criteria.<br/> Zero means use jdbc default value.
[...]
| properties | Map | No | -
| Additional connection configuration parameters,when properties and
URL have the same parameters, the priority is determined by the <br/>specific
implementation of the driver. For example, in MySQL, properties take precedence
over the URL.
[...]
| use_regex | Boolean | No | false
| Control regular expression matching for table_path. When set to
`true`, the table_path will be treated as a regular expression pattern. When
set to `false` or not specified, the table_path will be treated as an exact
path (no regex matching).
[...]
-| table_path | String | No | -
| The path to the full path of table, you can use this configuration
instead of `query`. <br/>examples: <br/>mysql: "testdb.table1" <br/>oracle:
"test_schema.table1" <br/>sqlserver: "testdb.test_schema.table1"
<br/>postgresql: "testdb.test_schema.table1"
[...]
+| table_path | String | No | -
| The path to the full path of table, you can use this configuration
instead of `query`. <br/>example: <br/>"testdb.test_schema.table1"
[...]
| table_list | Array | No | -
| The list of tables to be read, you can use this configuration instead
of `table_path` example: ```[{ table_path = "testdb.table1"}, {table_path =
"testdb.table2", query = "select * id, name from testdb.table2"}]```
[...]
| where_condition | String | No | -
| Common row filter conditions for all tables/queries, must start with
`where`. for example `where id > 100`
[...]
| split.size | Int | No | 8096
| The split size (number of rows) of table, captured tables are split
into multiple splits when read of table.
[...]
diff --git a/docs/en/connector-v2/source/SqlServer.md
b/docs/en/connector-v2/source/SqlServer.md
index 21ab93f776..b038506937 100644
--- a/docs/en/connector-v2/source/SqlServer.md
+++ b/docs/en/connector-v2/source/SqlServer.md
@@ -84,7 +84,7 @@ Read external data source data through JDBC.
| fetch_size | Int | No | 0
| For queries that return a large number of objects,you can configure<br/>
the row fetch size used in the query toimprove performance by<br/> reducing the
number database hits required to satisfy the selection criteria.<br/> Zero
means use jdbc default value.
[...]
| properties | Map | No | -
| Additional connection configuration parameters,when properties and URL
have the same parameters, the priority is determined by the <br/>specific
implementation of the driver. For example, in MySQL, properties take precedence
over the URL.
[...]
| use_regex | Boolean| No | false
| Control regular expression matching for table_path. When set to `true`,
the table_path will be treated as a regular expression pattern. When set to
`false` or not specified, the table_path will be treated as an exact path (no
regex matching).
[...]
-| table_path | String | No | -
| The path to the full path of table, you can use this configuration
instead of `query`. <br/>examples: <br/>mysql: "testdb.table1" <br/>oracle:
"test_schema.table1" <br/>sqlserver: "testdb.test_schema.table1"
<br/>postgresql: "testdb.test_schema.table1"
[...]
+| table_path | String | No | -
| The path to the full path of table, you can use this configuration
instead of `query`. <br/>example: <br/>"testdb.test_schema.table1"
[...]
| table_list | Array | No | -
| The list of tables to be read, you can use this configuration instead of
`table_path` example: ```[{ table_path = "testdb.table1"}, {table_path =
"testdb.table2", query = "select * id, name from testdb.table2"}]```
[...]
| where_condition | String | No | -
| Common row filter conditions for all tables/queries, must start with
`where`. for example `where id > 100`
[...]
| split.size | Int | No | 8096
| The split size (number of rows) of table, captured tables are split into
multiple splits when read of table.
[...]
diff --git a/docs/zh/connector-v2/source/Mysql.md
b/docs/zh/connector-v2/source/Mysql.md
index c7ee83b436..0e6c3cb6b8 100644
--- a/docs/zh/connector-v2/source/Mysql.md
+++ b/docs/zh/connector-v2/source/Mysql.md
@@ -84,7 +84,7 @@ import ChangeLog from '../changelog/connector-jdbc.md';
| fetch_size | Int | 否 | 0 |
对于返回大量对象的查询，可以配置查询的行提取大小，以通过减少满足选择条件所需的数据库访问次数来提高性能。<br/>设置为零表示使用 `JDBC` 的默认值。
|
| properties | Map | 否 | - |
额外的连接配置参数，当属性和 URL 中有相同的参数时，优先级由驱动程序的具体实现决定。<br/>例如，在 MySQL 中，属性优先于 URL。
|
| use_regex | Boolean | 否 | false |
控制表路径的正则表达式匹配。当设置为true时，table_path 将被视为正则表达式模式。当设置为false或未指定时，table_path
将被视为精确路径（不进行正则匹配）。
|
-| table_path | String | 否 | - |
表的完整路径，您可以使用此配置代替 `query`。<br/>示例：<br/>mysql: "testdb.table1"<br/>oracle:
"test_schema.table1"<br/>sqlserver: "testdb.test_schema.table1"<br/>postgresql:
"testdb.test_schema.table1" |
+| table_path | String | 否 | - |
表的完整路径，您可以使用此配置代替 `query`。<br/>示例：<br/>"testdb.table1"
|
| table_list | Array | 否 | - |
要读取的表的列表，您可以使用此配置代替 `table_path`，示例如下： ```[{ table_path = "testdb.table1"},
{table_path = "testdb.table2", query = "select * id, name from
testdb.table2"}]``` |
| where_condition | String | 否 | - |
所有表/查询的通用行过滤条件，必须以 `where` 开头。例如 `where id > 100`。
|
| split.size | Int | 否 | 8096 |
表的分割大小（行数），当读取表时，捕获的表会被分割成多个分片。
|
diff --git a/docs/zh/connector-v2/source/Oracle.md
b/docs/zh/connector-v2/source/Oracle.md
index 216d08be6a..0c44fa6692 100644
--- a/docs/zh/connector-v2/source/Oracle.md
+++ b/docs/zh/connector-v2/source/Oracle.md
@@ -77,7 +77,7 @@ import ChangeLog from '../changelog/connector-jdbc.md';
| fetch_size | Int | 否 | 0 |
对于返回大量对象的查询，您可以配置查询中使用的行提取大小，以通过减少满足选择条件所需的数据库命中次数来提高性能。零表示使用 jdbc 默认值。 |
| properties | Map | 否 | - | 其他连接配置参数，当 properties 和 URL
具有相同参数时，优先级由驱动程序的具体实现确定。例如，在 Oracle 中，properties 优先于 URL。 |
| use_regex | Boolean | 否 | false | 控制 table_path 的正则表达式匹配。设置为 `true`
时，table_path 将被视为正则表达式模式。设置为 `false` 或未指定时，table_path 将被视为精确路径（无正则表达式匹配）。 |
-| table_path | String | 否 | - | 表的完整路径，您可以使用此配置代替 `query`。 |
+| table_path | String | 否 | - | 表的完整路径，您可以使用此配置代替
`query`。<br/>示例：<br/>"test_schema.table1" |
| table_list | Array | 否 | - | 要读取的表列表，您可以使用此配置代替 `table_path`。 |
| where_condition | String | 否 | - | 所有表/查询的通用行过滤条件，必须以 `where` 开头。 |
| split.size | Int | 否 | 8096 | 一个分割中有多少行。 |
diff --git a/docs/zh/connector-v2/source/PostgreSQL.md
b/docs/zh/connector-v2/source/PostgreSQL.md
index 6c1858b35b..2e567b20f6 100644
--- a/docs/zh/connector-v2/source/PostgreSQL.md
+++ b/docs/zh/connector-v2/source/PostgreSQL.md
@@ -91,7 +91,7 @@ import ChangeLog from '../changelog/connector-jdbc.md';
| fetch_size | Int | 否 | 0
| 对于返回大量对象的查询，您可以配置<br/> 用于查询的行抓取大小，以通过减少所需的数据库访问次数来提高性能。<br/> 0 表示使用 JDBC
默认值。
[...]
| properties | Map | 否 | -
| 其他连接配置参数，当属性和 URL 具有相同参数时，<br/> 优先级由驱动程序的具体实现决定。在 MySQL 中，属性优先于 URL。
[...]
| use_regex | Boolean | 否 | false
| 控制表路径的正则表达式匹配。当设置为true时，table_path 将被视为正则表达式模式。当设置为false或未指定时，table_path
将被视为精确路径（不进行正则匹配）。
|
-| table_path | String | 否 | -
| 表的完整路径，您可以使用此配置替代 `query`。<br/> 示例：<br/> mysql: "testdb.table1" <br/>
oracle: "test_schema.table1" <br/> sqlserver: "testdb.test_schema.table1" <br/>
postgresql: "testdb.test_schema.table1"
[...]
+| table_path | String | 否 | -
| 表的完整路径，您可以使用此配置替代 `query`。<br/> 示例：<br/> "testdb.test_schema.table1"
|
| table_list | Array | 否 | -
| 要读取的表列表，您可以使用此配置替代 `table_path` 示例：```[{ table_path = "testdb.table1"},
{table_path = "testdb.table2", query = "select * id, name from
testdb.table2"}]```
[...]
| where_condition | String | 否 | -
| 所有表/查询的通用行过滤条件，必须以 `where` 开头。 例如 `where id > 100`
[...]
| split.size | Int | 否 | 8096
| 表的拆分大小（行数），被捕获的表在读取时被拆分为多个拆分。
[...]
diff --git a/docs/zh/connector-v2/source/SqlServer.md
b/docs/zh/connector-v2/source/SqlServer.md
index ffce89f942..7caa46dfc2 100644
--- a/docs/zh/connector-v2/source/SqlServer.md
+++ b/docs/zh/connector-v2/source/SqlServer.md
@@ -84,7 +84,7 @@ import ChangeLog from '../changelog/connector-jdbc.md';
| fetch_size | Int | 否 | 0
|
对于返回大量对象的查询，你可以配置<br/>查询中使用的行获取大小来提高性能，<br/>通过减少满足选择条件所需的数据库命中次数。<br/>零表示使用
jdbc 默认值。
|
| properties | Map | 否 | -
| 额外的连接配置参数，当 properties 和 URL 具有相同参数时，优先级由<br/>驱动的具体实现决定。例如，在 MySQL
中，properties 优先于 URL。
|
| use_regex | Boolean | 否 | false
| 控制 table_path 的正则表达式匹配。当设置为 `true` 时，table_path 将被视为正则表达式模式。当设置为 `false`
或未指定时，table_path 将被视为精确路径（不进行正则匹配）。
|
-| table_path | String | 否 | -
| 表的完整路径，您可以使用此配置代替 `query`。<br/>示例：<br/>mysql: "testdb.table1"<br/>oracle:
"test_schema.table1"<br/>sqlserver: "testdb.test_schema.table1"<br/>postgresql:
"testdb.test_schema.table1"
|
+| table_path | String | 否 | -
| 表的完整路径，您可以使用此配置代替 `query`。<br/>示例：<br/>"testdb.test_schema.table1"
|
| table_list | Array | 否 | -
| 要读取的表列表，您可以使用此配置代替 `table_path`。示例：```[{ table_path = "testdb.table1"},
{table_path = "testdb.table2", query = "select * id, name from
testdb.table2"}]```
|
| where_condition | String | 否 | -
| 所有表/查询的通用行过滤条件，必须以 `where` 开头。例如 `where id > 100`
|
| split.size | Int | 否 | 8096
| 表的分割大小（行数），读取表时，捕获的表会被分割为多个分割。
|
