klion26 commented on a change in pull request #8300: [FLINK-11638][docs-zh]
Translate Savepoints page into Chinese
URL: https://github.com/apache/flink/pull/8300#discussion_r280980635
##########
File path: docs/ops/state/savepoints.zh.md
##########
@@ -78,160 +68,158 @@ source-id | State of StatefulSource
mapper-id | State of StatefulMapper
{% endhighlight %}
-In the above example, the print sink is stateless and hence not part of the
savepoint state. By default, we try to map each entry of the savepoint back to
the new program.
+在上面的示例中，print sink 是无状态的，因此不是 Savepoint 状态的一部分。默认情况下，我们尝试将 Savepoint
的每个条目映射回新程序。
-## Operations
+## 算子
-You can use the [command line client]({{ site.baseurl
}}/ops/cli.html#savepoints) to *trigger savepoints*, *cancel a job with a
savepoint*, *resume from savepoints*, and *dispose savepoints*.
+你可以使用[命令行客户端]({{site.baseurl}}/zh/ops/cli.html#Savepoint)来*触发 Savepoint
*，*取消具有 Savepoint *的作业，*从 Savepoint *恢复，以及*部署 Savepoint *。
-With Flink >= 1.2.0 it is also possible to *resume from savepoints* using the
webui.
+使用 Flink >= 1.2.0，还可以使用 webui *从 Savepoint 恢复*。
-### Triggering Savepoints
+### 触发 Savepoint
-When triggering a savepoint, a new savepoint directory is created where the
data as well as the meta data will be stored. The location of this directory
can be controlled by [configuring a default target directory](#configuration)
or by specifying a custom target directory with the trigger commands (see the
[`:targetDirectory` argument](#trigger-a-savepoint)).
+当触发 Savepoint 时，将创建一个新的 Savepoint
目录，其中存储数据和元数据。可以通过[配置默认目标目录](#configuration)或使用触发器命令指定自定义目标目录(参见[`:targetDirectory
`参数](#trigger-a-savepoint)来控制该目录的位置。
<div class="alert alert-warning">
-<strong>Attention:</strong> The target directory has to be a location
accessible by both the JobManager(s) and TaskManager(s) e.g. a location on a
distributed file-system.
+<strong>注意:</strong>目标目录必须是 JobManager(s) 和 TaskManager(s)
都可以访问的位置，例如分布式文件系统上的位置。
</div>
-For example with a `FsStateBackend` or `RocksDBStateBackend`:
+例如，使用 `FsStateBackend` 或 `RocksDBStateBackend` ：
{% highlight shell %}
-# Savepoint target directory
-/savepoints/
+# Savepoint 目标目录
+/Savepoint/
-# Savepoint directory
-/savepoints/savepoint-:shortjobid-:savepointid/
+# Savepoint 目录
+/Savepoint/savepoint-:shortjobid-:savepointid/
-# Savepoint file contains the checkpoint meta data
-/savepoints/savepoint-:shortjobid-:savepointid/_metadata
+# Savepoint 文件包含 Checkpoint元数据
+/Savepoint/savepoint-:shortjobid-:savepointid/_metadata
-# Savepoint state
-/savepoints/savepoint-:shortjobid-:savepointid/...
+# Savepoint 状态
+/Savepoint/savepoint-:shortjobid-:savepointid/...
{% endhighlight %}
<div class="alert alert-info">
- <strong>Note:</strong>
-Although it looks as if the savepoints may be moved, it is currently not
possible due to absolute paths in the <code>_metadata</code> file.
-Please follow <a
href="https://issues.apache.org/jira/browse/FLINK-5778";>FLINK-5778</a> for
progress on lifting this restriction.
+ <strong>注意:</strong>
+虽然看起来好像可以移动 Savepoint ，但由于<code> _metadata </ code>文件中的绝对路径，目前无法进行保存。
+请按照<a href="https://issues.apache.org/jira/browse/FLINK-5778";> FLINK-5778
</a>了解取消此限制的进度。
</div>
-
-Note that if you use the `MemoryStateBackend`, metadata *and* savepoint state
will be stored in the `_metadata` file. Since it is self-contained, you may
move the file and restore from any location.
+请注意，如果使用 `MemoryStateBackend`，则元数据*和* Savepoint 状态将存储在`_metadata`文件中。
由于它是自包含的，你可以移动文件并从任何位置恢复。
<div class="alert alert-warning">
- <strong>Attention:</strong> It is discouraged to move or delete the last
savepoint of a running job, because this might interfere with failure-recovery.
Savepoints have side-effects on exactly-once sinks, therefore
- to ensure exactly-once semantics, if there is no checkpoint after the last
savepoint, the savepoint will be used for recovery.
+ <strong>注意:</strong> 不建议移动或删除正在运行作业的最后一个 Savepoint
，因为这可能会干扰故障恢复。因此，Savepoint 对完全一次的接收器有副作用，为了确保精确的一次语义，如果在最后一个 Savepoint 之后没有
Checkpoint ，那么将使用 Savepoint 进行恢复。
</div>
-#### Trigger a Savepoint
+
+#### 触发 Savepoint
{% highlight shell %}
$ bin/flink savepoint :jobId [:targetDirectory]
{% endhighlight %}
-This will trigger a savepoint for the job with ID `:jobId`, and returns the
path of the created savepoint. You need this path to restore and dispose
savepoints.
+这将触发ID为`：jobId`的作业的Savepoint，并返回创建的 Savepoint 的路径。 你需要此路径来还原和部署 Savepoint 。
-#### Trigger a Savepoint with YARN
+#### 使用 YARN 触发 Savepoint
{% highlight shell %}
$ bin/flink savepoint :jobId [:targetDirectory] -yid :yarnAppId
{% endhighlight %}
-This will trigger a savepoint for the job with ID `:jobId` and YARN
application ID `:yarnAppId`, and returns the path of the created savepoint.
+这将触发 ID 为`：jobId` 和 YARN 应用程序 ID `：yarnAppId`的作业的 Savepoint，并返回创建的 Savepoint
的路径。
-#### Cancel Job with Savepoint
+#### 使用 Savepoint 取消作业
{% highlight shell %}
$ bin/flink cancel -s [:targetDirectory] :jobId
{% endhighlight %}
-This will atomically trigger a savepoint for the job with ID `:jobid` and
cancel the job. Furthermore, you can specify a target file system directory to
store the savepoint in. The directory needs to be accessible by the
JobManager(s) and TaskManager(s).
+这将自动触发 ID 为`:jobid` 的作业的 Savepoint，并取消该作业。此外，你可以指定一个目标文件系统目录来存储 Savepoint
。该目录需要被 JobManager(s) 和 TaskManager(s) 访问。
-### Resuming from Savepoints
+### 从 Savepoint 恢复
{% highlight shell %}
$ bin/flink run -s :savepointPath [:runArgs]
{% endhighlight %}
-This submits a job and specifies a savepoint to resume from. You may give a
path to either the savepoint's directory or the `_metadata` file.
+这将提交作业并指定要从中恢复的 Savepoint 。 你可以给出 Savepoint 目录或`_metadata`文件的路径。
-#### Allowing Non-Restored State
+#### 允许非恢复状态
-By default the resume operation will try to map all state of the savepoint
back to the program you are restoring with. If you dropped an operator, you can
allow to skip state that cannot be mapped to the new program via
`--allowNonRestoredState` (short: `-n`) option:
+默认情况下，resume 操作将尝试将 Savepoint 的所有状态映射回你要还原的程序。
如果删除了运算符，则可以通过`--allowNonRestoredState`（short：`-n`）选项跳过无法映射到新程序的状态：
{% highlight shell %}
$ bin/flink run -s :savepointPath -n [:runArgs]
{% endhighlight %}
-### Disposing Savepoints
+### 处理 Savepoint
Review comment:
`处理` --> `删除`?
----------------------------------------------------------------
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.
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
With regards,
Apache Git Services
