对象存储 统一命名空间能力

一、统一命名空间能力概述

GooseFS 通过统一命名空间能力对接不同的底层存储系统，如本地文件系统、腾讯云对象存储（Cloud Object Storage，COS）、腾讯云云 HDFS（Cloud HDFS，CHDFS）等，与这些底层存储系统进行通信，并为上层业务提供统一的访问接口和文件协议。业务侧只需使用 GooseFS 的访问接口，即可访问存储在不同底层存储系统中的数据。

上图显示了统一命名空间的工作原理。你可以通过 GooseFS 创建命名空间的指令 create ns ，将 COS 和 云 HDFS 的指定文件目录挂载到 GooseFS 中，然后通过 gfs:// 的这一统一的 schema 访问数据。详细说明如下所示：

·COS 总共有3个存储桶，分别是 bucket-1、bucket-2、bucket-3，其中 bucket-1 有 BU_A 和 BU_B 两个目录，bucket-1 和 bucket-2 均挂载在 GooseFS 中。

·云 HDFS 中有 BU_E、BU_F、BU_G 和 BU_H 共 4 个目录，其中除了 BU_H 其余目录均挂载到 GooseFS 上。

·在 GooseFS 的文件操作中，如果以 gfs:// 这一统一的 schema 访问 BU_A 和 BU_E 这两个目录，均可正常访问，且文件缓存在 GooseFS 的本地文件系统中。

·BU_A 和 BU_E 这两个存储在底层文件系统（COS、云 HDFS）中的目录已经挂载到 GooseFS 中，如果文件已经缓存在 GooseFS 的上，可以通过 gfs:// 这一统一的 schema 访问（例如 hadoop fs ls gfs://BU_A ）；也可以通过各个远端文件系统的命名空间访问（例如 hadoop fs ls cosn://bucket-1/BU_A ）。

·如果文件未被缓存在 GooseFS 上，此时通过 gfs:// 这一形式访问则会失败，因为文件未被缓存在本地文件系统中，但仍然可以通过底层存储系统的命名空间访问。

二、使用统一命名空间能力

你可以通过 ns 操作在 GooseFS 中创建命名空间，并将底层存储系统映射到 GooseFS 上，目前支持的底层存储系统包括 COS、云 HDFS、本地 HDFS 等。创建命名空间的操作与 Linux 文件系统中挂载文件卷盘类似。创建命名空间后，GooseFS 可以为客户端提供一个具有统一访问语义的文件系统。目前 GooseFS 命名空间的操作指令集如下：

$ goosefs nsUsage: goosefs ns [generic options] [create <namespace> <CosN/Chdfs path> <–wPolicy <1-6>> <–rPolicy <1-5>> [–readonly] [–shared] [–secret fs.cosn.userinfo.secretId=<************************************>] [–secret fs.cosn.userinfo.secretKey=<xxxxxxxxxx>] [–attribute fs.ofs.userinfo.appid=1200000000][–attribute fs.cosn.bucket.region=<ap-xxx>/fs.cosn.bucket.endpoint_suffix=<cos.ap-xxx.myqcloud.com>]] [delete <namespace>] [help [<command>]] [ls [-r|–sort=option|–timestamp=option]] [setPolicy [–wPolicy <1-6>] [–rPolicy <1-5>] <namespace>] [setTtl [–action delete|free] <namespace> <time to live>] [stat <namespace>] [unsetPolicy <namespace>] [unsetTtl <namespace>]

上述指令集中各项指令的能力简述如下：

三、创建和删除命名空间

通过 GooseFS 创建命名空间操作，可以将频繁访问的热数据从远端存储系统缓存到本地高性能存储节点中，为本地计算业务提供高性能的数据访问。如下指令展示了将 COS 中的存储桶 example-bucket、存储桶中的 example-prefix 目录以及云 HDFS 文件系统分别映射到 test_cos、test_cos_prefix 和 test_chdfs 等命名空间下。

# 将 COS 存储桶 example-bucket 映射到 test_cos 命名空间中$ goosefs ns create test_cos cosn://example-bucket-1250000000/ –wPolicy 1 –rPolicy 1 –secret fs.cosn.userinfo.secretId=************************************ –secret fs.cosn.userinfo.secretKey=xxxxxxxxxx –attribute fs.cosn.bucket.region=ap-guangzhou –attribute fs.cosn.bucket.endpoint_suffix=cos.ap-guangzhou.myqcloud.com # 将 COS 存储桶 example-bucket 的 example-prefix 目录映射到 test_cos_prefix 命名空间中$ goosefs ns create test_cos_prefix cosn://example-bucket-1250000000/example-prefix/ –wPolicy 1 –rPolicy 1 –secret fs.cosn.userinfo.secretId=************************************ –secret fs.cosn.userinfo.secretKey=xxxxxxxxxx –attribute fs.cosn.bucket.region=ap-guangzhou –attribute fs.cosn.bucket.endpoint_suffix=cos.ap-guangzhou.myqcloud.com# 将 云HDFS 文件系统 f4ma0l3qabc-Xy3 映射到 test_chdfs 命名空间中$ goosefs ns create test_chdfs ofs://f4ma0l3qabc-Xy3/ –wPolicy 1 –rPolicy 1 –attribute fs.ofs.userinfo.appid=1250000000

创建成功后，可以通过 goosefs fs ls 指令查看目录详情：

$ goosefs fs ls /test_cos

对于不需要使用的命名空间，可以通过 delete 指令来删除：

$ goosefs ns delete test_cosDelete the namespace: test_cos

四、设置缓存策略

用户可通过 setPolicy 和 unsetPolicy 设置指定命名空间的缓存策略。设置缓存策略的指令集如下：

$goosefs ns setPolicy [–wPolicy <1-6>] [–rPolicy <1-5>] <namespace>

其中各项参数的含义如下：

·wPolicy：写缓存策略，支持6种写缓存策略。

·rPolicy：读缓存策略，支持5种读缓存策略。

·namespace：指定的命名空间。

目前 GooseFS 支持的读写缓存策略分别如下：

写缓存策略

注意：说明：

读缓存策略

注意：说明：

注意：Read_Type：指用户调用 SDK 或者 API 从 GooseFS 中读取数据时指定的文件缓存策略，对单个文件生效。

结合目前大数据的业务实践，我们推荐的读写缓存策略组合主要如下：

如下示例展示了将指定命名空间 test_cos 的读写缓存策略分别设置为 CACHE_THROUGH 和 CACHE_CONSISTENT：

$ goosefs ns setPolicy –wPolicy 3 –rPolicy 5 test_cos

注意：除了在创建命名空间时指定缓存策略，用户还可以通过在读写文件时，针对指定文件设置 ReadType 或者 Write_Type，或者通过 properties 配置文件配置全局缓存策略。多个策略同时存在的时候，优先级为用户自定义优先级 > Namespace 读写策略 > 配置文件的全局缓存策略配置。其中，针对读策略会采用用户自定义 ReadType 和 Namespace 的 DirReadPolicy 的组合生效，即数据流读策略采用用户自定义 ReadType，元数据采用 Namespace 的策略。

注意：例如，GooseFS 中存在一个 COSN 命名空间，读策略为 CACHE_CONSISTENT；假设在该命名空间中存在一个 test.txt 的文件。客户端读取 test.txt 时，ReadType 指定了 CACHE_PROMOTE。那么整个读取行为就是同步元数据并且 CACHE_PROMOTE。

如果需要重置读写缓存策略，可以通过 unsetPolicy 指令实现，如下策略展示了重置 test_cos 命名空间的读写缓存策略：

$ goosefs ns unsetPolicy test_cos

五、设置 TTL

TTL 用于管理缓存在 GooseFS 本地节点的数据，配置 TTL 参数可以让缓存数据在指定的时间后执行指定的操作，例如 delete 或者 free 操作。目前设置 TTL 的操作指令如下：

$ goosefs ns setTtl [–action delete|free] <namespace> <time to live>

其中各项参数的含义如下：

·action：缓存时间到期后执行的操作，目前支持 delete 和 free 两种操作。delete 操作会删除缓存和 UFS 上的数据，free 操作只会删除缓存上的数据。

·namespace：指定的命名空间。

·time to live：数据缓存时间，单位毫秒。

如下示例展示了将指定命名空间 test_cos 的策略设置为60秒到期后删除：

$ goosefs ns setTtl –action free test_cos 60000

六、元数据信息管理

本小节介绍 GooseFS 如何管理元数据，包括元数据的同步、更新等内容。GooseFS 为用户提供了统一命名空间能力，用户可以通过统一的 gfs:// 的路径来访问不同底层存储系统上的文件，只需要指定好底层存储系统的路径即可。我们推荐你使用 GooseFS 作为统一的数据接入层，统一从 GooseFS 进行数据读写，保障元数据信息的一致性。

七、元数据同步概述

你可以通过在 conf/goosefs-site.properties 配置文件中修改元数据同步周期来管理元数据同步周期，配置参数如下：

goosefs.user.file.metadata.sync.interval=<INTERVAL>

同步周期支持如下3种入参：

·入参数值为-1：代表元数据在首次加载到 GooseFS 中后就不再进行更新。

·入参数值为0：代表 GooseFS 会在每次读写操作后都更新元数据。

·入参数值为正整数：代表 GooseFS 会按照指定的时间间隔，周期性地更新元数据。

你可以综合考虑你的节点数量、GooseFS 集群和底层存储的 I/O 距离、底层存储类型等因素，选择合适的同步周期。通常：

·GooseFS 集群节点数量越多，元数据同步延迟越大。

·GooseFS 集群所处的机房和底层存储的物理距离越远，元数据同步延迟越大。

·底层存储系统对元数据同步延迟的影响主要视系统请求 QPS 负载情况而定，QPS 负载越高则同步延迟相对更低。

八、配置方式

1. 通过命令行配置
你可以通过命令行的方式设置元数据信息同步周期：

goosefs fs ls -R -Dgoosefs.user.file.metadata.sync.interval=0 <path to sync>

2. 通过配置文件配置
对于大规模的 Goosefs 集群而言，你可以通过 goosefs-site.properties 配置文件批量配置集群中 Master 节点的元数据信息同步周期，其他节点的同步周期会默认按照该周期值执行。

goosefs.user.file.metadata.sync.interval=1m

注意：很多业务会选择按照目录来区分数据的用途，不同目录的数据访问频次并不全部相同。元数据同步周期可以按照不同目录设置不同的周期值，对于一些经常变化的目录，可以将该目录的元数据同步周期设置为较短的时间（如5分钟），对于极少变化或者不变化的目录，可以将同步周期设置为-1，这样 GooseFS 不会自动同步该目录的元数据。

九、推荐配置

根据业务访问模式的差异，你可以设置不同的元数据同步周期：