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:buto/bba或p:buto/ba
• projects:bb
• branch:develop或branch:refs/heads/develop
• change:2311176或change:I03369813660369e983b56dcabe44cb48839be4de0
• commit:4e8ea8d43ab22273e49493484e1e7316f88cd54e3
• ref:refs/changes/76/2311476/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