lvyanquan commented on code in PR #3977:
URL: https://github.com/apache/flink-cdc/pull/3977#discussion_r2108787484
##########
docs/content.zh/docs/core-concept/data-pipeline.md:
##########
@@ -111,9 +111,10 @@ under the License.
# Pipeline 配置
下面 是 Data Pipeline 的一些可选配置：
-| 参数 | 含义
| optional/required |
-|-------------------------|-----------------------------------------------------|-------------------|
-| name | 这个 pipeline 的名称，会用在 Flink 集群中作为作业的名称。
| optional |
-| parallelism | pipeline的全局并发度，默认值是1。
| optional |
-| local-time-zone | 作业级别的本地时区。
| optional |
-| execution.runtime-mode | pipeline 的运行模式，包含 STREAMING 和 BATCH，默认值是
STREAMING。 | optional |
\ No newline at end of file
+| 参数 | 含义
| optional/required |
+|------------------------|-----------------------------------------------------|-------------------|
+| name | 这个 pipeline 的名称，会用在 Flink 集群中作为作业的名称。
| optional |
+| parallelism | pipeline的全局并发度，默认值是1。
| optional |
+| local-time-zone | 作业级别的本地时区。
| optional |
+| execution.runtime-mode | pipeline 的运行模式，包含 STREAMING 和 BATCH，默认值是 STREAMING。
| optional |
+| operator.uid.prefix | Pipeline 中算子 UID 的前缀。如果不设置，Flink 会为每个算子生成唯一的 UID。
| optional |
Review Comment:
......
建议设置这个参数以提供稳定和可识别的算子 ID，这有助于有状态升级、问题排查和在 Flink UI 上的诊断。
##########
docs/content/docs/core-concept/data-pipeline.md:
##########
@@ -121,8 +121,9 @@ Note that whilst the parameters are each individually
optional, at least one of
| `local-time-zone` | The local time zone defines current session
time zone id.
| optional |
| `execution.runtime-mode` | The runtime mode of the pipeline includes
STREAMING and BATCH, with the default value being STREAMING.
| optional |
| `schema.change.behavior` | How to handle [changes in schema]({{< ref
"docs/core-concept/schema-evolution" >}}). One of: [`exception`]({{< ref
"docs/core-concept/schema-evolution" >}}#exception-mode), [`evolve`]({{< ref
"docs/core-concept/schema-evolution" >}}#evolve-mode), [`try_evolve`]({{< ref
"docs/core-concept/schema-evolution" >}}#tryevolve-mode), [`lenient`]({{< ref
"docs/core-concept/schema-evolution" >}}#lenient-mode) (default) or
[`ignore`]({{< ref "docs/core-concept/schema-evolution" >}}#ignore-mode). |
optional |
-| `schema.operator.uid` | The unique ID for schema operator. This ID
will be used for inter-operator communications and must be unique across
operators.
| optional |
+| `schema.operator.uid` | The unique ID for schema operator. This ID
will be used for inter-operator communications and must be unique across
operators. **Deprecated**: use `operator.uid.prefix` instead.
| optional |
| `schema-operator.rpc-timeout` | The timeout time for SchemaOperator to wait
downstream SchemaChangeEvent applying finished, the default value is 3 minutes.
| optional |
+| `operator.uid.prefix` | The prefix to use for all pipeline operator
UIDs. If not set, all pipeline operator UIDs will be generated by Flink.
| optional |
Review Comment:
......
It is recommended to set this parameter to ensure stable and recognizable
operator UIDs, which can help with stateful upgrades, troubleshooting, and
Flink UI diagnostics.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscr...@flink.apache.org
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
