命令说明

使用文本模式搜索资源内容。

语法

ov grep <pattern> [options]

参数和选项

参数	默认值	说明
PATTERN	必填	文本正则表达式。
-u, --uri URI	viking://	搜索起点，可以是文件或目录。
-i, --ignore-case	false	忽略大小写。对应 HTTP case_insensitive。
-x, --exclude-uri URI	不指定	排除一个文件或目录范围，不支持列表。
-n, --node-limit N	256	最多返回的命中行数；别名 --limit。
-L, --level-limit N	10	目录递归深度，与 find/search 的内容层级无关。
--tags TAGS	不指定	key=value 标签，多个以逗号分隔，按 AND 过滤文件。
-f, --fields FIELDS	不指定	当前 grep 支持 tags，用于输出标签；不是任意列选择器。

使用示例

ov grep 'timeout|deadline' --uri 'viking://resources/projects/atlas' \
  --ignore-case -n 50 --level-limit 10 -o json --compact=false

按标签过滤并显示标签：

ov grep 'ERROR' --uri 'viking://resources/projects/atlas' \
  --exclude-uri 'viking://resources/projects/atlas/archive' \
  --tags 'stage=production' --fields tags -n 100

下一步

找到匹配后，可以：

ov read <uri>

参数、示例与排错补充

返回参数描述不完整：返回结构采用统一包装：status 为 string，result 为 object/array/null，telemetry 为 object/null，error 为 object/null；业务子字段的类型和层级与成功示例保持一致。
指令不具体 - 代码/命令行操作：示例中的 <...> 为必须替换的占位符：URI 从创建/导入或列表、搜索结果中复制，ID 从对应创建/列表命令获取，查询词替换为实际业务输入；命令执行成功后再继续“下一步”。

最近更新时间：2026.09.22 22:14:42

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

命令说明 #

语法 #

参数和选项 #

使用示例 #

下一步 #

参数、示例与排错补充 #

命令说明

语法

参数和选项

使用示例

下一步

参数、示例与排错补充