You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@ozone.apache.org by GitBox <gi...@apache.org> on 2020/01/22 06:04:02 UTC
[GitHub] [hadoop-ozone] iamabug opened a new pull request #477: HDDS-2745.
shell/KeyCommands.md translation
iamabug opened a new pull request #477: HDDS-2745. shell/KeyCommands.md translation
URL: https://github.com/apache/hadoop-ozone/pull/477
## What changes were proposed in this pull request?
one .md file
## What is the link to the Apache JIRA
https://issues.apache.org/jira/browse/HDDS-2745
## How was this patch tested?
hugo server -D
----------------------------------------------------------------
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:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: ozone-issues-unsubscribe@hadoop.apache.org
For additional commands, e-mail: ozone-issues-help@hadoop.apache.org
[GitHub] [hadoop-ozone] iamabug commented on a change in pull request #477:
HDDS-2745. shell/KeyCommands.md translation
Posted by GitBox <gi...@apache.org>.
iamabug commented on a change in pull request #477: HDDS-2745. shell/KeyCommands.md translation
URL: https://github.com/apache/hadoop-ozone/pull/477#discussion_r369383414
##########
File path: hadoop-hdds/docs/content/shell/KeyCommands.zh.md
##########
@@ -0,0 +1,138 @@
+---
+title: 键命令
+summary: 键命令帮助你管理键和对象的生命周期
+weight: 4
+---
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+
+Ozone shell 提供以下键命令：
+
+ * [下载](#下载)
+ * [上传](#上传)
+ * [删除](#删除)
+ * [查看](#查看)
+ * [列举](#列举)
+ * [重命名](#重命名)
+
+
+### 下载
+
+`key get` 命令从 Ozone 集群下载一个键到本地文件系统。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| Uri | 键名，格式为 **/volume/bucket/key**
+| FileName | 下载到本地后的文件名
+
+
+{{< highlight bash >}}
+ozone sh key get /hive/jan/sales.orc sales.orc
+{{< /highlight >}}
+
+从 _/hive/jan_ 桶中下载 sales.orc 文件，写入到本地名为 sales.orc 的文件。
+
+### 上传
+
+`key put` 命令从本地文件系统上传一个文件到指定的桶。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| Uri | 键名，格式为 **/volume/bucket/key**
+| FileName | 待上传的本地文件
+| -r, \-\-replication | 可选，上传后的副本数，合法值为 ONE 或者 THREE，如果不设置，将采用集群配置中的默认值。
+
+{{< highlight bash >}}
+ozone sh key put /hive/jan/corrected-sales.orc sales.orc
+{{< /highlight >}}
+
+上述命令将 sales.orc 文件作为新键上传到 _/hive/jan/corrected-sales.orc_ 。
+
+### 删除
+
+`key delete` 命令用来从桶中删除指定键。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| Uri | 键名
+
+{{< highlight bash >}}
+ozone sh key delete /hive/jan/corrected-sales.orc
+{{< /highlight >}}
+
+上述命令会将 _/hive/jan/corrected-sales.orc_ 这个键删除。
+
+
+### 查看
+
+`key info` 命令返回指定键的信息。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| Uri | 键名
+
+{{< highlight bash >}}
+ozone sh key info /hive/jan/sales.orc
+{{< /highlight >}}
+
+上述命令会打印出 _/hive/jan/sales.orc_ 键的相关信息。
+
+### 列举
+
+用户通过 `key list` 命令列出一个桶中的所有键。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| -l, \-\-length | 返回结果的最大数量，默认值为 1000
+| -p, \-\-prefix | 可选，只有匹配指定前缀的键会被返回
Review comment:
original doc says,
```
Optional, Only buckets that match this prefix will be returned.
```
I guess it should be
```
Optional, Only keys that match this prefix will be returned.
```
Am I right ?
----------------------------------------------------------------
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:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: ozone-issues-unsubscribe@hadoop.apache.org
For additional commands, e-mail: ozone-issues-help@hadoop.apache.org
[GitHub] [hadoop-ozone] xiaoyuyao commented on issue #477: HDDS-2745.
shell/KeyCommands.md translation
Posted by GitBox <gi...@apache.org>.
xiaoyuyao commented on issue #477: HDDS-2745. shell/KeyCommands.md translation
URL: https://github.com/apache/hadoop-ozone/pull/477#issuecomment-578212143
LGTM, +1. I will merge it shortly.
----------------------------------------------------------------
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:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: ozone-issues-unsubscribe@hadoop.apache.org
For additional commands, e-mail: ozone-issues-help@hadoop.apache.org
[GitHub] [hadoop-ozone] xiaoyuyao commented on a change in pull request
#477: HDDS-2745. shell/KeyCommands.md translation
Posted by GitBox <gi...@apache.org>.
xiaoyuyao commented on a change in pull request #477: HDDS-2745. shell/KeyCommands.md translation
URL: https://github.com/apache/hadoop-ozone/pull/477#discussion_r370303812
##########
File path: hadoop-hdds/docs/content/shell/KeyCommands.zh.md
##########
@@ -0,0 +1,138 @@
+---
+title: 键命令
+summary: 键命令帮助你管理键和对象的生命周期
+weight: 4
+---
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+
+Ozone shell 提供以下键命令：
+
+ * [下载](#下载)
+ * [上传](#上传)
+ * [删除](#删除)
+ * [查看](#查看)
+ * [列举](#列举)
+ * [重命名](#重命名)
+
+
+### 下载
+
+`key get` 命令从 Ozone 集群下载一个键到本地文件系统。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| Uri | 键名，格式为 **/volume/bucket/key**
+| FileName | 下载到本地后的文件名
+
+
+{{< highlight bash >}}
+ozone sh key get /hive/jan/sales.orc sales.orc
+{{< /highlight >}}
+
+从 _/hive/jan_ 桶中下载 sales.orc 文件，写入到本地名为 sales.orc 的文件。
+
+### 上传
+
+`key put` 命令从本地文件系统上传一个文件到指定的桶。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| Uri | 键名，格式为 **/volume/bucket/key**
+| FileName | 待上传的本地文件
+| -r, \-\-replication | 可选，上传后的副本数，合法值为 ONE 或者 THREE，如果不设置，将采用集群配置中的默认值。
+
+{{< highlight bash >}}
+ozone sh key put /hive/jan/corrected-sales.orc sales.orc
+{{< /highlight >}}
+
+上述命令将 sales.orc 文件作为新键上传到 _/hive/jan/corrected-sales.orc_ 。
+
+### 删除
+
+`key delete` 命令用来从桶中删除指定键。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| Uri | 键名
+
+{{< highlight bash >}}
+ozone sh key delete /hive/jan/corrected-sales.orc
+{{< /highlight >}}
+
+上述命令会将 _/hive/jan/corrected-sales.orc_ 这个键删除。
+
+
+### 查看
+
+`key info` 命令返回指定键的信息。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| Uri | 键名
+
+{{< highlight bash >}}
+ozone sh key info /hive/jan/sales.orc
+{{< /highlight >}}
+
+上述命令会打印出 _/hive/jan/sales.orc_ 键的相关信息。
+
+### 列举
+
+用户通过 `key list` 命令列出一个桶中的所有键。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| -l, \-\-length | 返回结果的最大数量，默认值为 1000
Review comment:
默认值为 1000=>默认值为 100
If the English version has 1000, that needs to be fixed too.
----------------------------------------------------------------
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:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: ozone-issues-unsubscribe@hadoop.apache.org
For additional commands, e-mail: ozone-issues-help@hadoop.apache.org
[GitHub] [hadoop-ozone] xiaoyuyao commented on a change in pull request
#477: HDDS-2745. shell/KeyCommands.md translation
Posted by GitBox <gi...@apache.org>.
xiaoyuyao commented on a change in pull request #477: HDDS-2745. shell/KeyCommands.md translation
URL: https://github.com/apache/hadoop-ozone/pull/477#discussion_r370304095
##########
File path: hadoop-hdds/docs/content/shell/KeyCommands.zh.md
##########
@@ -0,0 +1,138 @@
+---
+title: 键命令
+summary: 键命令帮助你管理键和对象的生命周期
+weight: 4
+---
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+
+Ozone shell 提供以下键命令：
+
+ * [下载](#下载)
+ * [上传](#上传)
+ * [删除](#删除)
+ * [查看](#查看)
+ * [列举](#列举)
+ * [重命名](#重命名)
+
+
+### 下载
+
+`key get` 命令从 Ozone 集群下载一个键到本地文件系统。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| Uri | 键名，格式为 **/volume/bucket/key**
+| FileName | 下载到本地后的文件名
+
+
+{{< highlight bash >}}
+ozone sh key get /hive/jan/sales.orc sales.orc
+{{< /highlight >}}
+
+从 _/hive/jan_ 桶中下载 sales.orc 文件，写入到本地名为 sales.orc 的文件。
+
+### 上传
+
+`key put` 命令从本地文件系统上传一个文件到指定的桶。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| Uri | 键名，格式为 **/volume/bucket/key**
+| FileName | 待上传的本地文件
+| -r, \-\-replication | 可选，上传后的副本数，合法值为 ONE 或者 THREE，如果不设置，将采用集群配置中的默认值。
+
+{{< highlight bash >}}
+ozone sh key put /hive/jan/corrected-sales.orc sales.orc
+{{< /highlight >}}
+
+上述命令将 sales.orc 文件作为新键上传到 _/hive/jan/corrected-sales.orc_ 。
+
+### 删除
+
+`key delete` 命令用来从桶中删除指定键。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| Uri | 键名
+
+{{< highlight bash >}}
+ozone sh key delete /hive/jan/corrected-sales.orc
+{{< /highlight >}}
+
+上述命令会将 _/hive/jan/corrected-sales.orc_ 这个键删除。
+
+
+### 查看
+
+`key info` 命令返回指定键的信息。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| Uri | 键名
+
+{{< highlight bash >}}
+ozone sh key info /hive/jan/sales.orc
+{{< /highlight >}}
+
+上述命令会打印出 _/hive/jan/sales.orc_ 键的相关信息。
+
+### 列举
+
+用户通过 `key list` 命令列出一个桶中的所有键。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| -l, \-\-length | 返回结果的最大数量，默认值为 1000
+| -p, \-\-prefix | 可选，只有匹配指定前缀的键会被返回
Review comment:
Yes, Please fix the English Document too.
----------------------------------------------------------------
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:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: ozone-issues-unsubscribe@hadoop.apache.org
For additional commands, e-mail: ozone-issues-help@hadoop.apache.org
[GitHub] [hadoop-ozone] xiaoyuyao commented on a change in pull request
#477: HDDS-2745. shell/KeyCommands.md translation
Posted by GitBox <gi...@apache.org>.
xiaoyuyao commented on a change in pull request #477: HDDS-2745. shell/KeyCommands.md translation
URL: https://github.com/apache/hadoop-ozone/pull/477#discussion_r370301817
##########
File path: hadoop-hdds/docs/content/shell/KeyCommands.zh.md
##########
@@ -0,0 +1,138 @@
+---
+title: 键命令
+summary: 键命令帮助你管理键和对象的生命周期
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:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: ozone-issues-unsubscribe@hadoop.apache.org
For additional commands, e-mail: ozone-issues-help@hadoop.apache.org
[GitHub] [hadoop-ozone] xiaoyuyao merged pull request #477: HDDS-2745.
shell/KeyCommands.md translation
Posted by GitBox <gi...@apache.org>.
xiaoyuyao merged pull request #477: HDDS-2745. shell/KeyCommands.md translation
URL: https://github.com/apache/hadoop-ozone/pull/477
----------------------------------------------------------------
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:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: ozone-issues-unsubscribe@hadoop.apache.org
For additional commands, e-mail: ozone-issues-help@hadoop.apache.org
[GitHub] [hadoop-ozone] iamabug commented on issue #477: HDDS-2745.
shell/KeyCommands.md translation
Posted by GitBox <gi...@apache.org>.
iamabug commented on issue #477: HDDS-2745. shell/KeyCommands.md translation
URL: https://github.com/apache/hadoop-ozone/pull/477#issuecomment-577023747
@xiaoyuyao Could you help review this ? Thanks
----------------------------------------------------------------
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:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: ozone-issues-unsubscribe@hadoop.apache.org
For additional commands, e-mail: ozone-issues-help@hadoop.apache.org
[GitHub] [hadoop-ozone] xiaoyuyao commented on a change in pull request
#477: HDDS-2745. shell/KeyCommands.md translation
Posted by GitBox <gi...@apache.org>.
xiaoyuyao commented on a change in pull request #477: HDDS-2745. shell/KeyCommands.md translation
URL: https://github.com/apache/hadoop-ozone/pull/477#discussion_r370301297
##########
File path: hadoop-hdds/docs/content/shell/KeyCommands.zh.md
##########
@@ -0,0 +1,138 @@
+---
+title: 键命令
+summary: 键命令帮助你管理键和对象的生命周期
+weight: 4
+---
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+
+Ozone shell 提供以下键命令：
+
+ * [下载](#下载)
+ * [上传](#上传)
+ * [删除](#删除)
+ * [查看](#查看)
+ * [列举](#列举)
+ * [重命名](#重命名)
+
+
+### 下载
+
+`key get` 命令从 Ozone 集群下载一个键到本地文件系统。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| Uri | 键名，格式为 **/volume/bucket/key**
+| FileName | 下载到本地后的文件名
+
+
+{{< highlight bash >}}
+ozone sh key get /hive/jan/sales.orc sales.orc
+{{< /highlight >}}
+
+从 _/hive/jan_ 桶中下载 sales.orc 文件，写入到本地名为 sales.orc 的文件。
+
+### 上传
+
+`key put` 命令从本地文件系统上传一个文件到指定的桶。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| Uri | 键名，格式为 **/volume/bucket/key**
+| FileName | 待上传的本地文件
+| -r, \-\-replication | 可选，上传后的副本数，合法值为 ONE 或者 THREE，如果不设置，将采用集群配置中的默认值。
+
+{{< highlight bash >}}
+ozone sh key put /hive/jan/corrected-sales.orc sales.orc
+{{< /highlight >}}
+
+上述命令将 sales.orc 文件作为新键上传到 _/hive/jan/corrected-sales.orc_ 。
+
+### 删除
+
+`key delete` 命令用来从桶中删除指定键。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| Uri | 键名
+
+{{< highlight bash >}}
+ozone sh key delete /hive/jan/corrected-sales.orc
+{{< /highlight >}}
+
+上述命令会将 _/hive/jan/corrected-sales.orc_ 这个键删除。
+
+
+### 查看
+
+`key info` 命令返回指定键的信息。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| Uri | 键名
+
+{{< highlight bash >}}
+ozone sh key info /hive/jan/sales.orc
+{{< /highlight >}}
+
+上述命令会打印出 _/hive/jan/sales.orc_ 键的相关信息。
+
+### 列举
+
+用户通过 `key list` 命令列出一个桶中的所有键。
+
+***参数：***
+
+| 参数名 | 说明 |
+|--------------------------------|-----------------------------------------|
+| -l, \-\-length | 返回结果的最大数量，默认值为 1000
+| -p, \-\-prefix | 可选，只有匹配指定前缀的键会被返回
Review comment:
Good catch. Please fix the English document as well.
----------------------------------------------------------------
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:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: ozone-issues-unsubscribe@hadoop.apache.org
For additional commands, e-mail: ozone-issues-help@hadoop.apache.org