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 2021/08/27 03:47:52 UTC

[GitHub] [ozone] cku328 commented on a change in pull request #2582: HDDS-5564. feature/PrefixFSO.md translation

cku328 commented on a change in pull request #2582:
URL: https://github.com/apache/ozone/pull/2582#discussion_r697131307



##########
File path: hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
##########
@@ -0,0 +1,61 @@
+---
+title: "基于前缀的文件系统优化"
+weight: 2
+menu:
+   main:
+      parent: 特性
+summary: 支持Supports atomic rename and delete operation.

Review comment:
       I think it translates to `原子的`.
   
   

##########
File path: hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
##########
@@ -0,0 +1,61 @@
+---
+title: "基于前缀的文件系统优化"
+weight: 2
+menu:
+   main:
+      parent: 特性
+summary: 支持Supports atomic rename and delete operation.
+---
+<!---
+  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.om.enable.filesystem.paths` 启用时有效,这意味着对 Hadoop 文件系统的兼容性优先于对 S3 的兼容性,某些不规范的 S3 键名将会被拒绝或规范化。
+
+当 Ozone 中的桶主要通过兼容 Hadoop 的接口使用,尤其是涉及到较深目录层级下的大量文件时,强烈推荐开启该特性。
+
+## OzoneManager 元数据布局格式
+OzoneManager 支持两种元数据布局格式:简单布局格式和基于前缀的布局格式。
+
+在简单布局格式中,OM 采用全路径名来存储每个键的元数据。在基于前缀的优化布局格式中,OM 将中间目录的元数据存储在  `DirectoryTable` 中,将文件的元数据存储在 `FileTable` 中,如下图所示。两张表中的主键要么是目录名,要么是以父目录唯一标识符为前缀的文件名, 形如 `<parent
+     unique-id>/<filename>`。
+     
+![FSO Format](PrefixFSO-Format.png)
+
+
+### 基于前缀布局的目录删除操作 ###
+下图描述了进行目录删除操作时 OM 的元数据变化。
+![FSO Delete](PrefixFSO-Delete.png)
+
+### 基于前缀布局的目录重命名操作 ###
+下图描述了进行目录重命名操作时 OM 的元数据变化。
+![FSO Rename](PrefixFSO-Rename.png)
+
+## 配置
+该特性默认未启用,可以通过在 `ozone-site.xml` 进行如下配置启用:

Review comment:
       ```suggestion
   该特性默认未启用,可以通过在 `ozone-site.xml` 进行如下配置来启用:
   ```
   I think it will read more smoothly.

##########
File path: hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
##########
@@ -0,0 +1,61 @@
+---
+title: "基于前缀的文件系统优化"
+weight: 2
+menu:
+   main:
+      parent: 特性
+summary: 支持Supports atomic rename and delete operation.
+---
+<!---
+  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.om.enable.filesystem.paths` 启用时有效,这意味着对 Hadoop 文件系统的兼容性优先于对 S3 的兼容性,某些不规范的 S3 键名将会被拒绝或规范化。
+
+当 Ozone 中的桶主要通过兼容 Hadoop 的接口使用,尤其是涉及到较深目录层级下的大量文件时,强烈推荐开启该特性。
+
+## OzoneManager 元数据布局格式
+OzoneManager 支持两种元数据布局格式:简单布局格式和基于前缀的布局格式。
+
+在简单布局格式中,OM 采用全路径名来存储每个键的元数据。在基于前缀的优化布局格式中,OM 将中间目录的元数据存储在  `DirectoryTable` 中,将文件的元数据存储在 `FileTable` 中,如下图所示。两张表中的主键要么是目录名,要么是以父目录唯一标识符为前缀的文件名, 形如 `<parent

Review comment:
       Would it be better to replace `全路径` with `完整路径`?
   I think the `existing` in the original text should be mentioned.




-- 
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-unsubscribe@ozone.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org