Gerrit的ssh命令之gerrit query详解

Gerrit的gerrit query命令就是要查询Gerrit的changes数据库。

默认，查询结果是根据changes的更新时间，由近及远排序。

对于有多个patch set的change，默认查询结果只包含最后的patch set。

如果查询结果有很大，则默认只返回有限个查询结果，可以设置limit:参数指定查询结果包含的changes数量。

1. gerrit query命令用法：

ssh -p <port> <host> gerrit query  [--format {TEXT | JSON}]  [--current-patch-set]  [--patch-sets | --all-approvals]  [--files]  [--comments]  [--commit-message]  [--dependencies]  [--submit-records]  [--all-reviewers]  [--start <n> | -S <n>]  <query>  [limit:<n>]

常见选项说明：

• --format=TEXT，默认
• --format=JSON
• --current-patch-set，给出当前patch set的信息
• --patch-sets，给出所有patch set的信息
• --commit-message，给出change的完整commit message
• --all-reviewers，给出所有reviewer的name和email

<query>说明：

• status:open等价于status:pending, is:open, is:pending
• owner:self等价于is:owner
• reviewer:self等价于is:reviewer
• project:bbauto/bba或p:bbauto/bba
• projects:bb
• branch:develop或branch:refs/heads/develop
• change:2311176或change:I03369813660369e983b56dcabe4cb48839be4de0
• commit:4e8ea8d43ab22273e4949348e1e7316f88cd54e3
• ref:refs/changes/76/2311176/1
• message:my_commit_message
• is:visible
• label:Code-Review=2或label:Code-Review=+2或label:Code-Review+2
• label:Verified+1

补充：

• 属性值除了bare words (数字、大小写字母和@-_.)之外，必须使用""或{}包含
• 多个属性之间默认为and关系，还有or关系，或者取反not/-

2.参考文献：

https://gerrit-documentation.storage.googleapis.com/Documentation/2.13.7/cmd-query.html
https://gerrit-documentation.storage.googleapis.com/Documentation/2.13.7/json.html
https://gerrit-documentation.storage.googleapis.com/Documentation/2.13.7/user-search.html