La Section 12.3.1 mostró cómo se pueden convertir los documentos de texto sin procesar en valores de tsvector. PostgreSQL también proporciona funciones y operadores que se pueden utilizar para manipular documentos que ya están en formato tsvector.

Una lista completa de las funciones relacionadas con tsvector está disponible en la Table 9.43.

La Section 12.3.2 mostró cómo se pueden convertir las consultas de texto sin procesar en valores de tsquery. La herramienta de búsqueda de texto de PostgreSQL también proporciona funciones y operadores que se pueden utilizar para manipular consultas que ya están en formato 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'

Cuando utilizas una columna separada para almacenar la representación tsvector de tus documentos, es necesario crear un trigger para actualizar la columna tsvector cuando cambian las columnas de contenido del documento. Hay dos funciones de trigger integradas disponibles para esto, o puedes escribir la tuya propia.

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

Estas funciones de trigger calculan automáticamente una columna tsvector a partir de una o más columnas de texto, bajo el control de los parámetros especificados en el comando CREATE TRIGGER. Un ejemplo de su uso es:

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;
   title    |         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');
   title    |         body
------------+-----------------------
 title here | the body text is here

Una vez creado este trigger, cualquier cambio en title o body se reflejará automáticamente en tsv, sin que la aplicación tenga que preocuparse por ello.

El primer argumento del trigger debe ser el nombre de la columna tsvector que se va a actualizar. El segundo argumento especifica la configuración de búsqueda de texto que se utilizará para realizar la conversión. Para tsvector_update_trigger, el nombre de la configuración simplemente se proporciona como el segundo argumento del trigger. Debe estar calificado con el esquema, como se muestra arriba, para que el comportamiento del trigger no cambie con los cambios en search_path. Para tsvector_update_trigger_column, el segundo argumento del trigger es el nombre de otra columna de la tabla, que debe ser de tipo regconfig. Esto permite realizar una selección de configuración por fila. Los argumentos restantes son los nombres de las columnas de texto (de tipo text, varchar o char). Estas se incluirán en el documento en el orden proporcionado. Los valores NULL se omitirán (pero las otras columnas se seguirán indexando).

Una limitación de estos triggers integrados es que tratan todas las columnas de entrada por igual. Para procesar las columnas de manera diferente — por ejemplo, para dar un peso diferente al título que al cuerpo — es necesario escribir un trigger personalizado. Aquí tienes un ejemplo utilizando PL/pgSQL como lenguaje del trigger:

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();

Ten en cuenta que es importante especificar el nombre de la configuración explícitamente cuando creas valores de tsvector dentro de los triggers, de modo que el contenido de la columna no se vea afectado por los cambios en default_text_search_config. No hacer esto probablemente provocará problemas como que los resultados de búsqueda cambien después de un volcado y restauración.

La función ts_stat es útil para verificar tu configuración y para encontrar palabras candidatas a palabras vacías (stop-words).

ts_stat(sqlquery text, [ weights text, ]
        OUT word text, OUT ndoc integer,
        OUT nentry integer) returns setof record

sqlquery es un valor de texto que contiene una consulta SQL que debe devolver una sola columna de tipo tsvector. ts_stat ejecuta la consulta y devuelve estadísticas sobre cada lexema (palabra) distinto contenido en los datos tsvector. Las columnas devueltas son:

Si se proporciona weights, solo se cuentan las apariciones que tienen uno de esos pesos.

Por ejemplo, para encontrar las diez palabras más frecuentes en una colección de documentos:

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

Lo mismo, pero contando solo las apariciones de palabras con peso A o B:

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