#knife-psearch Partial search plugin for knife with support for grouping matches based on attributes.
Introduction
Partial search only returns the the part of the json objects you specify instead of returning the complete objecttree and filter client side as the original search plugin does. This makes searching much much faster for large data. partial_search.rb is copied from the partial_search cookbook from opscode.
201 nodes:
$ time knife search node 'name:\*' -a languages.php.version
real 0m13.881s
$ time knife psearch node 'name:\*' -a languages.php.version
real 0m3.592s
In addition psearch has a group functionalty that enables you to group host by some attribute.
Requirements
Psearch uses the new partial search api included in chef-server 11.
##Example searches
###Search and group results
List all nodes with PHP installed and group output based on PHP version
knife psearch node "name:*" -g languages.php.version
Same search, but do not include servers that don't have the languages.php.version attribute set
knife psearch node "name:*" -g languages.php.version -n
###Standard Partial searches
By default psearch will return the node name on all searches. You can specify additional attributes to include with the -a flag. Multiple attributes is separated by a comma.
Show ipaddress and roles on all nodes
knife psearch node "name:*" -a ipaddress,roles
##Installation
Copy psearch.rb, partial_search.rb to $HOME/.chef/plugins