tencent cloud

数据加速器 GooseFS

动态与公告
产品动态
产品选型指引
GooseFSx
产品简介
快速入门
购买指南
控制台指南
工具指南
实践教程
Service Level Agreement
词汇表
GooseFS
产品简介
计费概述
快速入门
核心特性
控制台指南
开发者指南
客户端工具
集群配置实践
数据安全
Service Level Agreement
GooseFS-Lite
GooseFS-Lite 工具
实践教程
在 Kubernetes 中使用 GooseFS 加速 Spark 数据访问
使用 GooseFS 以原生 POSIX 语义访问存储桶
GooseFS Distributedload 调优实践
常见问题

文件系统指令介绍

PDF
聚焦模式
字号
最后更新时间: 2025-07-17 17:42:53
GooseFS 命令行接口为用户提供了基本的文件系统操作,可以使用以下命令来得到所有子命令:
goosefs fs [generic options]
文件系统各项指令列表如下:
指令操作
指令说明
cat <path>
打印指定的 GooseFS 路径中的文件内容。
checkConsistency [-r][-t|--threads ] <GooseFS path>
检查 GooseFS 和底层存储的元数据一致性。
checksum <GooseFS path>
计算指定 GooseFS 文件路径的 md5 校验码。
chgrp [-R]<group><path>
修改指定 GooseFS 文件或者文件夹的所属用户组信息,支持通过 -R 递归修改指定目录下所有文件的所属用户组。
chmod [-R]<mode><path>
修改指定 GooseFS 文件或者文件夹的访问权限信息,支持通过 -R 递归修改指定目录下所有文件的访问权限。
chown [-R]<owner>[:<group>]<path>
修改指定 GooseFS 文件或者文件夹的所有者信息,支持通过 -R 递归修改指定目录下所有文件的所有者。
copyFromLocal [--thread <num>] [--buffersize <bytes>] <src> <remoteDst>
将指定的本地路径拷贝到指定的 GooseFS 文件路径上,可以设置该指令的并发数和缓冲区大小,调整拷贝速率。
copyToLocal [--buffersize <bytes>] <src> <localDst>
将指定的 GooseFS 文件路径拷贝到指定的本地路径,可以设置缓冲区大小。
count [-h]<path>
统计指定 GooseFS 路径的文件及文件夹总数。
cp [-R][--buffersize ] <src> <dst>
将指定的 GooseFS 路径拷贝到另一个指定的 GooseFS 路径上,支持递归拷贝,支持调整缓冲区大小。
decompress [-a]<path>[-C <targetDir>]
将指定 GooseFS 路径上的文件解压缩到目标目录下。
distributedCp [--active-jobs <num>] [--batch-size <num>] <src> <dst>
分布式拷贝数据,将指定的 GooseFS 路径并发拷贝到另一个指定的 GooseFS 路径上,支持设置作业数和每批次的拷贝数量。
distributedLoad [-ignoreCap][-dryrun][-A][--replication ][--active-jobs <num>] [--batch-size <num>] [--expire-time] <path>
分布式预热数据,将指定 GooseFS 路径的数据从底层存储中预热到缓存集群中,支持设置缓存副本数、作业数和每批次的拷贝数等参数。
distributedMv <src><dst>
分布式移动数据,将指定的 GooseFS 路径并发移动到另一个指定的 GooseFS 路径上。
du [-h|-s|-g|-m]<path>
输出指定 GooseFS 文件/文件夹的大小。
free [-f]<path>
释放指定 GooseFS 文件/文件夹的缓存数据,该操作不会删除底层存储中的数据。
getCapacityBytes
获取 GooseFS 的集群总容量大小。
getSyncPathList
获取当前活跃的自动同步进程列表。
getUsedBytes
获取 GooseFS 已缓存的容量大小。
getfacl <path>
获取指定 GooseFS 文件路径的 Posix acl。
head [-c <bytes>]<path>
输出指定 GooseFS 文件开头的指定长度内容,默认输出开头的1KB内容。
help [<command>]
获取指定文件系统指令的帮助信息。
leader
获取当前 GooseFS 集群的主 Master 节点信息。
listDecompressJobs <namespace>[-f <Running|Success|Failed|Pending>][-s <asc|desc>][-n <resultNums>][-p <pageIndex>]
列出指定 GooseFS 命名空间下正在解压缩的任务列表,支持状态、升降序、每页打印的任务数以及任务索引等参数。
load [--local] <path>
预热数据,将指定 GooseFS 路径的数据从底层存储加载到集群中。
loadMetadata [-R][-F]<path>
预热元数据,将指定 GooseFS 路径的元数据信息加载到集群中,如果路径为目录,支持递归加载。
location <path>
输出包含指定 GooseFS文件的节点列表。
ls [-d|-f|-p|-R|-h|--sort=option|--timestamp=option|-r|-a] <path> ...
输出指定 GooseFS 路径下的所有文件和目录信息,支持递归列出等操作。
masterInfo
输出 GooseFS Master 节点的容灾信息,例如 leader 节点信息、所有 master 节点列表以及配置的 zookeeper 地址(如有配置)等。
mkdir <path1>[path2]...[pathn]
在制定的路径下创建文件夹,多个路径用空格或者 tab 键分隔;如果其中有任意路径已存在,那么该操作会抛出异常。
mount [--readonly] [--shared] [--option <key=val>] <goosefsPath> <ufsURI>
将指定的底层存储路径挂载到 GooseFS 命名空间的指定路径下。如果指定路径已存在,那么挂载操作会抛出异常。挂载成功后,对该挂载点下的文件操作会同时作用于底层存储上的对应路径。
mv <src><dst>
将指定的 GooseFS 路径并发移动到另一个指定的 GooseFS 路径上。如果目标路径已存在,该操作会抛出异常。
persist [-p|--parallelism <#>] [-t|--timeout <milliseconds>] [-w|--wait <milliseconds>] <path> [<path> ...]
将仅存在于 GooseFS 上的文件或者文件夹持久化到底层存储上,支持设置并发度、超时时间等参数。
pin <path> media1 media2 media3 ...
将指定 GooseFS 上的文件或者文件夹锁定到 GooseFS 集群中,避免被淘汰。如果指定路径为文件夹则默认递归锁定文件夹下所有文件。
queryDecompress <path>[<jobId>]
查询指定 GooseFS 文件路径、指定任务id的解压缩任务。
rm [-R][-U][--goosefsOnly] <path>
删除指定 GooseFS 文件路径的文件,支持递归删除,支持设定是否只删除缓存中的文件。
setReplication [--max <num> | --min <num>] <path>
设置指定 GooseFS 上文件路径的副本数,支持设定副本数的最大值和最小值。
setTtl [--action delete_only_goosefs|delete|free] <path> <time to live>
设置指定 GooseFS 上文件路径的TTL,支持设置到期删除操作类型,包括删除底层存储文件,删除本地文件,释放缓存。
setfacl [-d][-R][--set | -m | -x <acl_entries> <path>] | [-b | -k <path>]
设置指定GooseFS上文件路径的权限信息,支持递归设置。
startSync <path>
启动指定 GooseFS 文件路径的自动同步进程。
stat [-f <format>]<path>
统计指定 GooseFS 路径的文件信息。
stopSync <path>
停止指定 GooseFS 文件路径的自动同步进程。
tail [-c <bytes>]<path>
输出指定 GooseFS 文件末尾的指定长度内容,默认输出最后的1KB内容。
test [-d|-f|-e|-s|-z]<path>
测试指定 GooseFS 路径的属性,如果属性正确返回0,否则返回1。
touch <path>
在指定的 GooseFS 路径上创建一个空文件。
unmount <goosefsPath>
解除指定的文件挂载点。
unpin <path>
将指定 GooseFS 上的文件或者文件夹解锁,解锁后可以被集群淘汰。如果指定路径为文件夹则默认递归解锁文件夹下所有文件。该操作为 pin 操作的反向操作。
unsetTtl <path>
删除指定 GooseFS 文件路径的TTL信息。
updateMount [--readonly] [--shared] [--option <key=val>] <goosefsPath>
更新指定 GooseFS 文件路径的挂载信息。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈