名称

gerrit query-查询更改搜索索引

简介

ssh标准-p<端口><主机>gerrit查询[--格式{TEXT|JSON}][--当前匹配集][-修补程序集|--所有批准][-文件][-评论][--承诺消息][--依赖项][--提交记录][--所有审阅者][--开始<n>|-S<n>][--无限制][--]<查询>[限制:<n>]

说明

查询更改搜索索引并返回描述更改的结果匹配输入查询的。显示最近更新的更改在旧的更改之前,其顺序与web界面。对于每个匹配的更改,结果都包含数据对于更改的最新修补程序集,即使查询与旧补丁集(例如,旧补丁集的sha1修订版)。

查询返回的结果数量可能会受到限制“limit:”运算符。如果未提供限制,则为内部默认值限制用于防止结果集爆炸。为了获得结果超出限制,可以使用“--start”标志恢复跳过一定数量的结果后的查询。

此命令的非选项参数用空格和然后解析为查询。这简化了对SSH允许操作符出现在不同的参数中。

查询运算符可以使用匹配的大括号引用值(例如。审阅者:{Developer Group})用2回避问题shell引用的级别(调用方shell调用SSH和SSH服务器中的命令行解析器)。

选项

--格式

结果的格式设置方法。文本是默认值,呈现人类可读的显示。JSON格式收益更改属性,一行每个匹配记录,转义嵌入LF。

--当前匹配集

在结果中包含有关当前修补程序集的信息。请注意,只有当当前调用者可以看到补丁集。

--补丁程序集

包括有关调用者可见的所有修补程序集的信息。如果与--current-patch-set标志结合使用,则当前补丁设置信息将输出两次,每个字段一次。

--所有批准

包括有关调用者可以看到的所有补丁集的信息包含每个修补程序集的批准信息。如果与结合--current-patch-set标志,然后是当前补丁集信息将输出两次,每个字段一次。

--文件

支持列出带有补丁集的文件及其属性(添加、修改、删除、重命名、复制)和大小信息(插入和删除的数量)。请注意,此选项需要--current-patch-set或--patch-sets选项以提供任何文件信息。

--评论

包括所有更改的注释。如果与--patch-sets标志,然后包含所有内联/文件注释调用者可以看到的每个补丁集。

--承诺信息

在更改描述中包含完整提交消息。

--依赖关系

显示依赖于或需要的修补程序集的信息,每个补丁集。

--所有评论员

显示添加到更改中的所有审阅者的姓名和电子邮件(无论他们是否对该变更进行了投票)。

--提交记录

显示有关更改的提交记录信息包括变更是否符合提交标准(包括每个评审标签的信息)。

--启动
-S公司

要跳过的更改数。

--无限制

返回所有结果,覆盖默认限制。

极限:<n>

要返回的最大结果数。这实际上是一个查询运算符,而不是命令行选项。如果更多不止一个极限:提供了运算符,最小极限将用于剪切结果集。

访问

对Gerrit具有SSH访问权限的任何用户。

脚本

此命令用于脚本。

示例

在tools/gerrit项目中查找两个最近打开的更改:

$ssh-p 29418 review.example.com gerrit查询--format=JSON状态:打开项目:工具/gerrit限制:2{“项目”:“工具/gerrit”,…}{“项目”:“工具/gerrit”,…}{“type”:“stats”,“rowCount”:2,“runningTimeMilliseconds:15}

跳过更改次数:

$ssh-p 29418 review.example.com gerrit query--format=JSON--start 42状态:打开项目:tools/gerrit limit:2{“项目”:“工具/gerrit”,…}{“项目”:“工具/gerrit”,…}{“type”:“stats”,“rowCount”:1,“runningTimeMilliseconds:15}

方案

JSON消息由引用改变,补丁程序集,解释以及其他适当的属性。

请注意,JSON消息中可能缺少任何字段,因此消费者这个JSON流应该适当地处理这个问题。

另请参阅


的一部分Gerrit代码审查