# 查询重写
ts_rewrite函数族可以从tsquery中搜索一个特定的目标子查询，并在该子查询每次出现的地方都替换为另一个子查询。 实际上这只是通过字符串替换而得到的一个特定tsquery版本。目标子查询和替换查询组合起来可以被认为是一个重写规则。一组类似的重写规则可以为搜索提供强大的帮助。例如，可以使用同义词扩大搜索范围（例如，new york, big apple, nyc, gotham）或限制搜索范围在用户直接感兴趣的热点话题上。
- ts_rewrite (query tsquery, target tsquery, substitute tsquery) returns tsquery ts_rewrite的这种形式只适用于一个单一的重写规则：任何出现目标子查询的地方都被无条件替换。例如：
  ```
  SELECT ts_rewrite('a & b'::tsquery, 'a'::tsquery, 'c'::tsquery);
   ts_rewrite
  ------------
   'b' & 'c'
  ```
  
- ts_rewrite (query tsquery, select text) returns tsquery ts_rewrite的这种形式接受一个起始查询和SQL查询命令。 这里的查询命令是文本字符串形式，必须产生两个tsquery列。查询结果的每一行，第一个字段的值（目标子查询） 都会被第二个字段（替代子查询）替换。
  ![](https://support.huaweicloud.com/sqlreference-911-dws/public_sys-resources/note_3.0-zh-cn.png)
  当多个规则需要重写时，重写顺序非常重要； 因此在实践中需要使用ORDER BY将源查询按照某些字段进行排序。
  例如：举一个现实生活中天文学上的例子。将使用表驱动的重写规则扩大supernovae的查询范围：
  ```
  CREATE TABLE tsearch.aliases (id int, t tsquery, s tsquery);
  INSERT INTO tsearch.aliases VALUES(1, to_tsquery('supernovae'), to_tsquery('supernovae|sn'));
  SELECT ts_rewrite(to_tsquery('supernovae & crab'), 'SELECT t, s FROM tsearch.aliases');
             ts_rewrite            
  ---------------------------------
   'crab' & ( 'supernova' | 'sn' )
  ```
  可以通过更新表修改重写规则：
  ```
  UPDATE tsearch.aliases
  SET s = to_tsquery('supernovae|sn & !nebulae')
  WHERE t = to_tsquery('supernovae');
  SELECT ts_rewrite(to_tsquery('supernovae & crab'), 'SELECT t, s FROM tsearch.aliases');
                   ts_rewrite                  
  ---------------------------------------------
   'crab' & ( 'supernova' | 'sn' & !'nebula' )
  ```
  需要重写的规则越多，重写操作就越慢。因为它要检查每一个可能匹配的规则。为了过滤明显的非候选规则，可以使用tsquery类型的操作符来实现。在下面的例子中， 只选择那些可能与原始查询匹配的规则：
  ```
  SELECT ts_rewrite('a & b'::tsquery, 'SELECT t,s FROM tsearch.aliases WHERE ''a & b''::tsquery @> t');
   ts_rewrite 
  ------------
   'b' & 'a'
  (1 row)
  DROP TABLE ts_rewrite;
  ```