挂载参数说明-云原生数据库 PolarDB(PolarDB)-阿里云帮助中心

挂载命令

使用lakebase-client mount命令挂载文件系统：

lakebase-client mount [选项] <META-URL> <MOUNTPOINT> --subdir=<SUB_DIR>

参数	说明
`META-URL`	元数据引擎地址。您可以通过OpenAPI-DescribePolarFsAttribute获取的完整`META-URL`值，或在PolarDB Agent LakeBase实例的基本信息页面中获取MetaUrl信息。
`MOUNTPOINT`	本地挂载点路径。
`<SUB_DIR>`	可选。填写LakeBase根目录下的子目录相对路径或绝对路径，例如`a/b/c`或`/a/b/c`，表示挂载此子目录到`<MOUNT_POINT>`。不指定则挂载LakeBase根目录。说明 SidecarSet挂载时若不指定子目录，需删除下述YAML文件中的`subPath: <SUB_DIR>`挂载至LakeBase根目录，此时LakeBase根目录下所有目录和文件会对该Pod可见。

META-URL支持在URL Query String中附加连接参数，您可通过--meta-url-query-string参数单独指定Query String，客户端解密后会自动附加。

# 通过--meta-url-query-string指定参数
lakebase-client mount <META-URL> /mnt/lakebase -d --meta-url-query-string "max_open_conns=8&max_idle_conns=8"

参数	默认值	说明
`max_open_conns`	8	数据库最大打开连接数，高并发场景可适当增大。
`max_idle_conns`	8	连接池中最大空闲连接数，建议与`max_open_conns`保持一致。

本组参数用于定义客户端的本地元数据缓存策略。合理配置缓存可有效减少与元数据引擎的交互频次，大幅提升 ls（列目录）、stat（查属性）及 open（开文件）等高频操作的响应速度。

参数	类型	默认值	说明
`--skip-dir-mtime`	string	"100s"	设置目录修改时间（`mtime`）更新的最小间隔。在高频创建或删除文件时，若距上次更新未超此阈值则跳过本次`mtime`修改。通过合并零碎的元数据更新，降低磁盘写放大效应，提升高频写场景下的系统响应速度。
`--attr-cache`	string	"1s"	设置文件属性（如大小、权限、`mtime` 等）在内核中的缓存有效期。过期后，下一次文件属性查询（`stat`）将重新向元数据引擎获取最新数据。
`--entry-cache`	string	"1s"	设置文件名到`inode`映射关系在内核中的缓存有效期。过期后，路径查找（`lookup`）操作将重新向元数据引擎发起查询。
`--dir-entry-cache`	string	"1s"	设置目录项列表（Directory Entry）在内核中的缓存有效期。过期后，读取目录内容（`readdir`）操作将重新向元数据引擎发起查询。
`--open-cache`	string	"0s"	设置已打开文件的属性缓存窗口期。在此时间段内重复执行 `open`/`getattr` 操作将直接读取本地缓存，无需再次查询元数据引擎。设为 `0s` 表示禁用。
`--open-cache-limit`	uint64	10000	设置 `open-cache` 缓存的最大文件数量（软限制）。超出此上限后，系统将采用最久未使用（LRU）原则自动淘汰最早打开的文件。

本组参数用于调优客户端的内存缓冲区、预读（Prefetch）策略及网络并发度，直接决定系统的 I/O 吞吐量与时延表现。

参数	类型	默认值	说明
`--max-fuse-io`	string	"1024K"	设置内核发往客户端的单次读写（`read`/`write`）请求的最大数据块大小。增大该值可有效减少内核态与用户态之间的上下文切换（Context Switch）次数，提升大文件传输效率。实际生效上限受操作系统内核版本约束。
`--buffer-size`	string	"300M"	设置所有并发读写操作共享的全局内存缓冲池大小（最小限制为 `32 MiB`）。系统默认将其中的约 80% 动态分配给预读缓冲区，以平滑网络读取抖动。
`--max-uploads`	int	50	控制后台并发上传数据块到对象存储的`Goroutine`（轻量级协程）数量。增大该值能显著加快数据写入后的持久化（刷盘）速度。但并发过高会成倍增加对象存储的 QPS 压力。