Раздел 2.9.3.1 показано, как исходные текстовые документы могут быть преобразованы в tsvector значений. Digital Q.DataBase также предоставляет функции и операторы, которые могут быть использованы для обработки документов, уже представленных в tsvector форме.

Полный список tsvectorсвязанных функций доступен в Таблица 2.6.43.

Раздел 2.9.3.2 было показано, как необработанные текстовые запросы могут быть преобразованы в tsquery значений. Digital Q.DataBase также предоставляет функции и операторы, которые могут быть использованы для управления запросами, уже представленными в формате tsquery форме.

CREATE TABLE aliases (t tsquery primary key, s tsquery);
INSERT INTO aliases VALUES(to_tsquery('supernovae'), to_tsquery('supernovae|sn'));

SELECT ts_rewrite(to_tsquery('supernovae & crab'), 'SELECT * FROM aliases');
           ts_rewrite
---------------------------------
 'crab' & ( 'supernova' | 'sn' )

UPDATE aliases
SET s = to_tsquery('supernovae|sn & !nebulae')
WHERE t = to_tsquery('supernovae');

SELECT ts_rewrite(to_tsquery('supernovae & crab'), 'SELECT * FROM aliases');
                 ts_rewrite
---------------------------------------------
 'crab' & ( 'supernova' | 'sn' & !'nebula' )

SELECT ts_rewrite('a & b'::tsquery,
                  'SELECT t,s FROM aliases WHERE ''a & b''::tsquery @> t');
 ts_rewrite
------------
 'b' & 'c'

При использовании отдельного столбца для хранения tsvector представления документов необходимо создать триггер для обновления значения в данном tsvector столбце при изменении исходного содержимого документа. Для этой задачи доступны две встроенные триггерные функции, либо вы можете разработать собственную.

tsvector_update_trigger(tsvector_column_name,​ config_name, text_column_name [, ... ])
tsvector_update_trigger_column(tsvector_column_name,​ config_column_name, text_column_name [, ... ])

Данные триггерные функции автоматически вычисляют значение tsvector столбца на основе одного или нескольких текстовых полей согласно параметрам, указанным в команде CREATE TRIGGER . Пример их использования:

CREATE TABLE messages (
    title       text,
    body        text,
    tsv         tsvector
);

CREATE TRIGGER tsvectorupdate BEFORE INSERT OR UPDATE
ON messages FOR EACH ROW EXECUTE FUNCTION
tsvector_update_trigger(tsv, 'pg_catalog.english', title, body);

INSERT INTO messages VALUES('title here', 'the body text is here');

SELECT * FROM messages;
   заголовок    |         body          |            tsv
------------+-----------------------+----------------------------
 title here | the body text is here | 'bodi':4 'text':5 'titl':1

SELECT title, body FROM messages WHERE tsv @@ to_tsquery('title & body');
   заголовок    |         body
------------+-----------------------
 title here | the body text is here

После создания данного триггера любое изменение в заголовок или body будет автоматически отражаться в столбце tsv, без необходимости внесения изменений в логику работы приложения.

Первый аргумент триггера должен содержать имя tsvector обновляемого столбца. Второй аргумент определяет конфигурацию текстового поиска, используемую для выполнения преобразования. Для функции tsvector_update_triggerимя конфигурации просто указывается во втором аргументе триггера. Имя конфигурации должно быть квалифицировано именем схемы, как показано выше, чтобы поведение триггера не зависело от изменений в search_path. Для функции tsvector_update_trigger_column, вторым аргументом триггера является имя другого столбца таблицы, который должен иметь тип regconfig. Это позволяет выбирать конфигурацию текстового поиска индивидуально для каждой строки. Остальные аргументы представляют собой имена текстовых столбцов (имеющих тип текстовые, varchar, или char). Указанные значения будут включены в документ в заданном порядке. Значения NULL будут пропущены (при этом индексирование остальных столбцов всё равно будет выполнено).

Ограничение данных встроенных триггеров заключается в том, что все входные столбцы обрабатываются ими одинаково. Для дифференцированной обработки столбцов — например, для присвоения заголовку иного веса, чем основному тексту, — необходимо написать пользовательский триггер. Ниже приведен пример использования языка PL/pgSQL для реализации триггера:

CREATE FUNCTION messages_trigger() RETURNS trigger AS $$
begin
  new.tsv :=
     setweight(to_tsvector('pg_catalog.english', coalesce(new.title,'')), 'A') ||
     setweight(to_tsvector('pg_catalog.english', coalesce(new.body,'')), 'D');
  return new;
end
$$ LANGUAGE plpgsql;

CREATE TRIGGER tsvectorupdate BEFORE INSERT OR UPDATE
    ON messages FOR EACH ROW EXECUTE FUNCTION messages_trigger();

Следует учитывать, что при формировании значений внутри триггеров важно tsvector явно указывать имя конфигурации полнотекстового поиска, чтобы на содержимое столбца не влияли изменения параметров default_text_search_config. Несоблюдение этого требования может привести к возникновению таких проблем, как изменение результатов поиска после выполнения выгрузки и восстановления базы данных.

Функция ts_stat полезна для проверки текущей конфигурации и поиска потенциальных стоп-слов.

ts_stat(sqlquery текстовые, [ weights текстовые, ]
        OUT word текстовые, OUT ndoc integer,
        OUT nentry integer) возвращает setof record

sqlquery представляет собой текстовое значение, содержащее SQL-запрос, который должен возвращать один tsvector столбец. ts_stat выполняет запрос и возвращает статистические данные о каждой уникальной лексеме (слове), содержащейся в tsvector данных. Функция возвращает следующие столбцы:

Если weights указан, учитываются только те вхождения, которые имеют один из данных весов.

Например, чтобы найти десять наиболее часто встречающихся слов в коллекции документов:

SELECT * FROM ts_stat('SELECT vector FROM apod')
ORDER BY nentry DESC, ndoc DESC, word
LIMIT 10;

То же самое, но с подсчётом вхождений слов только с весом A или B:

SELECT * FROM ts_stat('SELECT vector FROM apod', 'ab')
ORDER BY nentry DESC, ndoc DESC, word
LIMIT 10;