You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@flink.apache.org by ja...@apache.org on 2020/03/05 03:44:22 UTC
[flink] branch master updated (0362d20 -> 0428b10)
This is an automated email from the ASF dual-hosted git repository.
jark pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/flink.git.
from 0362d20 [FLINK-16414][table] Fix sql validation failed when using udaf/udtf has no getResultType (#11302)
new 59b6584 [FLINK-16133][docs-zh] Translate /ops/filesystems/azure.zh.md
new 0428b10 [FLINK-16132][docs-zh] Translate /ops/filesystems/oss.zh.md into Chinese
The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
docs/ops/filesystems/azure.md | 4 ++--
docs/ops/filesystems/azure.zh.md | 40 ++++++++++++++++--------------------
docs/ops/filesystems/oss.md | 4 ++--
docs/ops/filesystems/oss.zh.md | 44 ++++++++++++++++++++--------------------
4 files changed, 43 insertions(+), 49 deletions(-)
[flink] 02/02: [FLINK-16132][docs-zh] Translate
/ops/filesystems/oss.zh.md into Chinese
Posted by ja...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
jark pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/flink.git
commit 0428b103663ccd489f3f7eff81ec838a6bfcc7ca
Author: Qingsheng Ren <re...@gmail.com>
AuthorDate: Tue Feb 25 15:04:43 2020 +0800
[FLINK-16132][docs-zh] Translate /ops/filesystems/oss.zh.md into Chinese
This closes #11231
---
docs/ops/filesystems/oss.md | 4 ++--
docs/ops/filesystems/oss.zh.md | 44 +++++++++++++++++++++---------------------
2 files changed, 24 insertions(+), 24 deletions(-)
diff --git a/docs/ops/filesystems/oss.md b/docs/ops/filesystems/oss.md
index 6b2be11..c34bd19 100644
--- a/docs/ops/filesystems/oss.md
+++ b/docs/ops/filesystems/oss.md
@@ -52,7 +52,7 @@ env.setStateBackend(new FsStateBackend("oss://<your-bucket>/<object-name>"));
### Shaded Hadoop OSS file system
-To use `flink-oss-fs-hadoop,` copy the respective JAR file from the `opt` directory to a directory in `plugins` directory of your Flink distribution before starting Flink, e.g.
+To use `flink-oss-fs-hadoop`, copy the respective JAR file from the `opt` directory to a directory in `plugins` directory of your Flink distribution before starting Flink, e.g.
{% highlight bash %}
mkdir ./plugins/oss-fs-hadoop
@@ -82,7 +82,7 @@ An alternative `CredentialsProvider` can also be configured in the `flink-conf.y
# Read Credentials from OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET
fs.oss.credentials.provider: com.aliyun.oss.common.auth.EnvironmentVariableCredentialsProvider
{% endhighlight %}
-Other credential providers can be found under https://github.com/aliyun/aliyun-oss-java-sdk/tree/master/src/main/java/com/aliyun/oss/common/auth.
+Other credential providers can be found under [here](https://github.com/aliyun/aliyun-oss-java-sdk/tree/master/src/main/java/com/aliyun/oss/common/auth).
diff --git a/docs/ops/filesystems/oss.zh.md b/docs/ops/filesystems/oss.zh.md
index a937546..91bb173 100644
--- a/docs/ops/filesystems/oss.zh.md
+++ b/docs/ops/filesystems/oss.zh.md
@@ -1,6 +1,6 @@
---
-title: "Aliyun 对象存储服务 (OSS)"
-nav-title: Aliyun OSS
+title: "阿里云对象存储服务 (OSS)"
+nav-title: 阿里云 OSS
nav-parent_id: filesystems
nav-pos: 2
---
@@ -23,66 +23,66 @@ specific language governing permissions and limitations
under the License.
-->
-## OSS: Object Storage Service
+## OSS：对象存储服务
-[Aliyun Object Storage Service](https://www.aliyun.com/product/oss) (Aliyun OSS) is widely used, particularly popular among China’s cloud users, and it provides cloud object storage for a variety of use cases.
-You can use OSS with Flink for **reading** and **writing data** as well in conjunction with the [streaming **state backends**]({{ site.baseurl }}/ops/state/state_backends.html)
+[阿里云对象存储服务](https://www.aliyun.com/product/oss) (Aliyun OSS) 使用广泛，尤其在中国云用户中十分流行，能提供多种应用场景下的云对象存储。OSS 可与 Flink 一起使用以读取与存储数据，以及与[流 State Backend]({{ site.baseurl }}/zh/ops/state/state_backends.html) 结合使用。
* This will be replaced by the TOC
{:toc}
-You can use OSS objects like regular files by specifying paths in the following format:
+通过以下格式指定路径，OSS 对象可类似于普通文件使用：
{% highlight plain %}
oss://<your-bucket>/<object-name>
{% endhighlight %}
-Below shows how to use OSS in a Flink job:
+以下代码展示了如何在 Flink 作业中使用 OSS：
{% highlight java %}
-// Read from OSS bucket
+// 读取 OSS bucket
env.readTextFile("oss://<your-bucket>/<object-name>");
-// Write to OSS bucket
+// 写入 OSS bucket
stream.writeAsText("oss://<your-bucket>/<object-name>")
-// Use OSS as FsStatebackend
+// 将 OSS 用作 FsStatebackend
env.setStateBackend(new FsStateBackend("oss://<your-bucket>/<object-name>"));
{% endhighlight %}
-### Shaded Hadoop OSS file system
+### Shaded Hadoop OSS 文件系统
-To use `flink-oss-fs-hadoop,` copy the respective JAR file from the `opt` directory to a directory in `plugins` directory of your Flink distribution before starting Flink, e.g.
+为使用 `flink-oss-fs-hadoop`，在启动 Flink 之前，将对应的 JAR 文件从 `opt` 目录复制到 Flink 发行版中的 `plugin` 目录下的一个文件夹中，例如：
{% highlight bash %}
mkdir ./plugins/oss-fs-hadoop
cp ./opt/flink-oss-fs-hadoop-{{ site.version }}.jar ./plugins/oss-fs-hadoop/
{% endhighlight %}
-`flink-oss-fs-hadoop` registers default FileSystem wrappers for URIs with the *oss://* scheme.
+`flink-oss-fs-hadoop` 为使用 *oss://* scheme 的 URI 注册了默认的文件系统包装器。
-#### Configurations setup
+#### 配置设置
-After setting up the OSS FileSystem wrapper, you need to add some configurations to make sure that Flink is allowed to access your OSS buckets.
+在设置好 OSS 文件系统包装器之后，需要添加一些配置以保证 Flink 有权限访问 OSS buckets。
-To allow for easy adoption, you can use the same configuration keys in `flink-conf.yaml` as in Hadoop's `core-site.xml`
+为了简单使用，可直接在 `flink-conf.yaml` 中使用与 Hadoop `core-site.xml` 相同的配置关键字。
-You can see the configuration keys in the [Hadoop OSS documentation](http://hadoop.apache.org/docs/current/hadoop-aliyun/tools/hadoop-aliyun/index.html).
+可在 [Hadoop OSS 文档](http://hadoop.apache.org/docs/current/hadoop-aliyun/tools/hadoop-aliyun/index.html) 中查看配置关键字。
-There are some required configurations that must be added to `flink-conf.yaml` (**Other configurations defined in Hadoop OSS documentation are advanced configurations which used by performance tuning**):
+一些配置必须添加至 `flink-conf.yaml` （**在 Hadoop OSS 文档中定义的其它配置为用作性能调优的高级配置**）：
{% highlight yaml %}
-fs.oss.endpoint: Aliyun OSS endpoint to connect to
+fs.oss.endpoint: 连接的 Aliyun OSS endpoint
fs.oss.accessKeyId: Aliyun access key ID
fs.oss.accessKeySecret: Aliyun access key secret
{% endhighlight %}
-An alternative `CredentialsProvider` can also be configured in the `flink-conf.yaml`, e.g.
+备选的 `CredentialsProvider` 也可在 `flink-conf.yaml` 中配置，例如：
{% highlight yaml %}
-# Read Credentials from OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET
+# 从 OSS_ACCESS_KEY_ID 和 OSS_ACCESS_KEY_SECRET 读取凭据 (Credentials)
fs.oss.credentials.provider: com.aliyun.oss.common.auth.EnvironmentVariableCredentialsProvider
{% endhighlight %}
-Other credential providers can be found under https://github.com/aliyun/aliyun-oss-java-sdk/tree/master/src/main/java/com/aliyun/oss/common/auth.
+
+其余的凭据提供者（credential providers）可在[这里](https://github.com/aliyun/aliyun-oss-java-sdk/tree/master/src/main/java/com/aliyun/oss/common/auth)中找到。
[flink] 01/02: [FLINK-16133][docs-zh] Translate
/ops/filesystems/azure.zh.md
Posted by ja...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
jark pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/flink.git
commit 59b65844e285009b60dd9481dd2aec0458dd7094
Author: Qingsheng Ren <re...@gmail.com>
AuthorDate: Thu Feb 27 15:54:33 2020 +0800
[FLINK-16133][docs-zh] Translate /ops/filesystems/azure.zh.md
This closes #11232
---
docs/ops/filesystems/azure.md | 4 ++--
docs/ops/filesystems/azure.zh.md | 40 +++++++++++++++++-----------------------
2 files changed, 19 insertions(+), 25 deletions(-)
diff --git a/docs/ops/filesystems/azure.md b/docs/ops/filesystems/azure.md
index d63c9d6..e24b112 100644
--- a/docs/ops/filesystems/azure.md
+++ b/docs/ops/filesystems/azure.md
@@ -53,7 +53,7 @@ env.setStateBackend(new FsStateBackend("wasb://<your-container>@$<your-azure-acc
### Shaded Hadoop Azure Blob Storage file system
-To use `flink-azure-fs-hadoop,` copy the respective JAR file from the `opt` directory to the `plugins` directory of your Flink distribution before starting Flink, e.g.
+To use `flink-azure-fs-hadoop`, copy the respective JAR file from the `opt` directory to the `plugins` directory of your Flink distribution before starting Flink, e.g.
{% highlight bash %}
mkdir ./plugins/azure-fs-hadoop
@@ -74,7 +74,7 @@ in `flink-conf.yaml` via:
fs.azure.account.key.<account_name>.blob.core.windows.net: <azure_storage_key>
{% endhighlight %}
-Alternatively, the the filesystem can be configured to read the Azure Blob Storage key from an
+Alternatively, the filesystem can be configured to read the Azure Blob Storage key from an
environment variable `AZURE_STORAGE_KEY` by setting the following configuration keys in
`flink-conf.yaml`.
diff --git a/docs/ops/filesystems/azure.zh.md b/docs/ops/filesystems/azure.zh.md
index 4d81b55..0257bd8 100644
--- a/docs/ops/filesystems/azure.zh.md
+++ b/docs/ops/filesystems/azure.zh.md
@@ -1,6 +1,6 @@
---
-title: "Azure Blob Storage"
-nav-title: Azure Blob Storage
+title: "Azure Blob 存储"
+nav-title: Azure Blob 存储
nav-parent_id: filesystems
nav-pos: 3
---
@@ -23,60 +23,54 @@ specific language governing permissions and limitations
under the License.
-->
-[Azure Blob Storage](https://docs.microsoft.com/en-us/azure/storage/) is a Microsoft-managed service providing cloud storage for a variety of use cases.
-You can use Azure Blob Storage with Flink for **reading** and **writing data** as well in conjunction with the [streaming **state backends**]({{ site.baseurl }}/ops/state/state_backends.html)
+[Azure Blob 存储](https://docs.microsoft.com/en-us/azure/storage/) 是一项由 Microsoft 管理的服务，能提供多种应用场景下的云存储。
+Azure Blob 存储可与 Flink 一起使用以**读取**和**写入数据**，以及与[流 State Backend]({{ site.baseurl }}/zh/ops/state/state_backends.html) 结合使用。
* This will be replaced by the TOC
{:toc}
-You can use Azure Blob Storage objects like regular files by specifying paths in the following format:
+通过以下格式指定路径，Azure Blob 存储对象可类似于普通文件使用：
{% highlight plain %}
wasb://<your-container>@$<your-azure-account>.blob.core.windows.net/<object-path>
-// SSL encrypted access
+// SSL 加密访问
wasbs://<your-container>@$<your-azure-account>.blob.core.windows.net/<object-path>
{% endhighlight %}
-See below for how to use Azure Blob Storage in a Flink job:
+参见以下代码了解如何在 Flink 作业中使用 Azure Blob 存储：
{% highlight java %}
-// Read from Azure Blob storage
+// 读取 Azure Blob 存储
env.readTextFile("wasb://<your-container>@$<your-azure-account>.blob.core.windows.net/<object-path>");
-// Write to Azure Blob storage
+// 写入 Azure Blob 存储
stream.writeAsText("wasb://<your-container>@$<your-azure-account>.blob.core.windows.net/<object-path>")
-// Use Azure Blob Storage as FsStatebackend
+// 将 Azure Blob 存储用作 FsStatebackend
env.setStateBackend(new FsStateBackend("wasb://<your-container>@$<your-azure-account>.blob.core.windows.net/<object-path>"));
{% endhighlight %}
-### Shaded Hadoop Azure Blob Storage file system
+### Shaded Hadoop Azure Blob 存储文件系统
-To use `flink-azure-fs-hadoop,` copy the respective JAR file from the `opt` directory to the `plugins` directory of your Flink distribution before starting Flink, e.g.
+为使用 flink-azure-fs-hadoop，在启动 Flink 之前，将对应的 JAR 文件从 opt 目录复制到 Flink 发行版中的 plugin 目录下的一个文件夹中，例如：
{% highlight bash %}
mkdir ./plugins/azure-fs-hadoop
cp ./opt/flink-azure-fs-hadoop-{{ site.version }}.jar ./plugins/azure-fs-hadoop/
{% endhighlight %}
-`flink-azure-fs-hadoop` registers default FileSystem wrappers for URIs with the *wasb://* and *wasbs://* (SSL encrypted access) scheme.
+`flink-azure-fs-hadoop` 为使用 *wasb://* 和 *wasbs://* (SSL 加密访问) 的 URI 注册了默认的文件系统包装器。
-### Credentials Configuration
-
-Hadoop's Azure Filesystem supports configuration of credentials via the Hadoop configuration as
-outlined in the [Hadoop Azure Blob Storage documentation](https://hadoop.apache.org/docs/current/hadoop-azure/index.html#Configuring_Credentials).
-For convenience Flink forwards all Flink configurations with a key prefix of `fs.azure` to the
-Hadoop configuration of the filesystem. Consequentially, the azure blob storage key can be configured
-in `flink-conf.yaml` via:
+### 凭据配置
+Hadoop 的 Azure 文件系统支持通过 Hadoop 配置来配置凭据，如 [Hadoop Azure Blob Storage 文档](https://hadoop.apache.org/docs/current/hadoop-azure/index.html#Configuring_Credentials) 所述。
+为方便起见，Flink 将所有的 Flink 配置添加 `fs.azure` 键前缀后转发至文件系统的 Hadoop 配置中。因此，可通过以下方法在 `flink-conf.yaml` 中配置 Azure Blob 存储密钥：
{% highlight yaml %}
fs.azure.account.key.<account_name>.blob.core.windows.net: <azure_storage_key>
{% endhighlight %}
-Alternatively, the the filesystem can be configured to read the Azure Blob Storage key from an
-environment variable `AZURE_STORAGE_KEY` by setting the following configuration keys in
-`flink-conf.yaml`.
+或者通过在 `flink-conf.yaml` 中设置以下配置键，将文件系统配置为从环境变量 `AZURE_STORAGE_KEY` 读取 Azure Blob 存储密钥：
{% highlight yaml %}
fs.azure.account.keyprovider.<account_name>.blob.core.windows.net: org.apache.flink.fs.azurefs.EnvironmentVariableKeyProvider