在全文檢索系統中，文件是搜尋的單位；例如，雜誌文章或電子郵件訊息。文本搜尋引擎必須能夠解析文件，並將詞位（關鍵字）與其父文件建立關聯。之後，這些關聯會被用來搜尋包含查詢詞的文件。

對於 PostgreSQL 內的搜尋，文件通常是資料庫表格中一列的文字欄位，或者可能是這些欄位的組合（串聯），可能儲存在多個表格中或動態取得。換句話說，可以從不同的部分建構文件以進行索引，並且可能不會作為整體儲存在任何地方。例如：

SELECT title || ' ' ||  author || ' ' ||  abstract || ' ' || body AS document
FROM messages
WHERE mid = 12;

SELECT m.title || ' ' || m.author || ' ' || m.abstract || ' ' || d.body AS document
FROM messages m, docs d
WHERE m.mid = d.did AND m.mid = 12;

另一種可能性是將文件儲存為檔案系統中的簡單文字檔案。在這種情況下，資料庫可用於儲存全文索引並執行搜尋，並且可以使用唯一的識別符號從檔案系統中檢索文件。然而，從資料庫外部檢索檔案需要超級使用者權限或特殊功能支援，因此這通常不如將所有資料保留在 PostgreSQL 中方便。此外，將所有內容保留在資料庫中可以輕鬆存取文件元資料，以協助索引和顯示。

為了文本搜尋的目的，每個文件都必須簡化為經過預處理的 tsvector 格式。搜尋和排名完全在文件的 tsvector 表示上執行 — 只有在選擇文件向使用者顯示時才需要檢索原始文本。因此，我們經常將 tsvector 視為文件，但它當然只是完整文件的緊湊表示。

PostgreSQL 中的全文搜尋基於匹配運算子 @@，如果 tsvector（文件）與 tsquery（查詢）匹配，則返回 true。先寫入哪種資料類型無關緊要：

SELECT 'a fat cat sat on a mat and ate a fat rat'::tsvector @@ 'cat & rat'::tsquery;
 ?column?
----------
 t

SELECT 'fat & cow'::tsquery @@ 'a fat cat sat on a mat and ate a fat rat'::tsvector;
 ?column?
----------
 f

正如上面的例子所暗示的那樣，tsquery 不僅僅是原始文本，就像 tsvector 一樣。 tsquery 包含搜尋詞，它們必須是已經標準化的詞位，並且可以使用 AND、OR、NOT 和 FOLLOWED BY 運算子組合多個詞。（有關語法詳細信息，請參閱 第 8.11.2 節。）函數 to_tsquery、plainto_tsquery 和 phraseto_tsquery 有助於將使用者編寫的文本轉換為適當的 tsquery，主要是通過標準化文本中出現的單詞。同樣，to_tsvector 用於解析和標準化文件字串。因此，在實踐中，文本搜尋匹配看起來更像這樣：

SELECT to_tsvector('fat cats ate fat rats') @@ to_tsquery('fat & rat');
 ?column?
----------
 t

請注意，如果寫成以下形式，此匹配將不會成功：

SELECT 'fat cats ate fat rats'::tsvector @@ to_tsquery('fat & rat');
 ?column?
----------
 f

因為這裡不會對單詞 rats 進行標準化。tsvector 的元素是詞位，它們被認為已經標準化，因此 rats 不匹配 rat。

@@ 運算子也支援 text 輸入，允許在簡單情況下跳過將文本字串顯式轉換為 tsvector 或 tsquery。可用的變體是：

tsvector @@ tsquery
tsquery  @@ tsvector
text @@ tsquery
text @@ text

我們已經看到了前兩個。形式 text @@ tsquery 等效於 to_tsvector(x) @@ y。形式 text @@ text 等效於 to_tsvector(x) @@ plainto_tsquery(y)。

在 tsquery 中，&（AND）運算子指定其兩個參數都必須出現在文件中才能匹配。類似地，|（OR）運算子指定其參數中至少有一個必須出現，而 !（NOT）運算子指定其參數必須不出現才能匹配。例如，查詢 fat & ! rat 匹配包含 fat 但不包含 rat 的文件。

可以使用 <-> (FOLLOWED BY) tsquery 運算子搜尋短語，該運算子僅在其參數具有相鄰且以給定順序的匹配項時才匹配。例如：

SELECT to_tsvector('fatal error') @@ to_tsquery('fatal <-> error');
 ?column?
----------
 t

SELECT to_tsvector('error is not fatal') @@ to_tsquery('fatal <-> error');
 ?column?
----------
 f

FOLLOWED BY 運算子有一個更通用的版本，其形式為 <N>，其中 N 是一個整數，代表匹配詞位的位置之間的差異。 <1> 與 <-> 相同，而 <2> 允許在匹配項之間恰好出現一個其他詞位，依此類推。 phraseto_tsquery 函數使用此運算子建構 tsquery，該 tsquery 可以在某些單詞是停用詞時匹配多詞短語。例如：

SELECT phraseto_tsquery('cats ate rats');
       phraseto_tsquery
-------------------------------
 'cat' <-> 'ate' <-> 'rat'

SELECT phraseto_tsquery('the cats ate the rats');
       phraseto_tsquery
-------------------------------
 'cat' <-> 'ate' <2> 'rat'

有時有用的一種特殊情況是，可以使用 <0> 來要求兩個模式匹配同一個單詞。

可以使用括號來控制 tsquery 運算子的巢狀結構。如果沒有括號，| 的綁定性最弱，然後是 &，然後是 <->，! 的綁定性最強。

值得注意的是，在 FOLLOWED BY 運算子的參數中，AND/OR/NOT 運算子的意義與不在 FOLLOWED BY 運算子中時略有不同，因為在 FOLLOWED BY 中，比對的確切位置非常重要。例如，通常 !x 只比對不包含任何 x 的文件。但 !x <-> y 會比對 y，如果它不是緊接在 x 之後；文件中其他地方出現 x 並不會阻止比對。另一個例子是，x & y 通常只需要 x 和 y 都出現在文件中某個地方，但 (x & y) <-> z 需要 x 和 y 在相同位置比對，且緊接在 z 之前。因此，此查詢的行為與 x <-> z & y <-> z 不同，後者會比對包含兩個獨立序列 x z 和 y z 的文件。（這個特定的查詢寫法是無用的，因為 x 和 y 無法在相同位置比對；但在更複雜的情況下，例如前綴比對模式，這種形式的查詢可能會很有用。）

以上都是簡單的文字搜尋範例。如前所述，全文搜尋功能包括執行更多事情的能力：跳過索引某些詞語（停用詞）、處理同義詞，以及使用複雜的解析，例如，根據不只是空白的內容進行解析。此功能由文字搜尋設定控制。PostgreSQL 隨附了許多語言的預定義設定，您可以輕鬆建立自己的設定。（psql 的 \dF 命令會顯示所有可用的設定。）

在安裝過程中，會選取適當的設定，並在 postgresql.conf 中相應地設定 default_text_search_config。如果您對整個叢集使用相同的文字搜尋設定，則可以使用 postgresql.conf 中的值。若要在整個叢集中使用不同的設定，但在任何一個資料庫中使用相同的設定，請使用 ALTER DATABASE ... SET。否則，您可以在每個連線階段中設定 default_text_search_config。

每個依賴設定的文字搜尋函式都有一個可選的 regconfig 引數，以便可以明確指定要使用的設定。僅當省略此引數時，才會使用 default_text_search_config。

為了更容易建立自訂文字搜尋設定，設定是從更簡單的資料庫物件建立的。PostgreSQL 的文字搜尋工具提供了四種與設定相關的資料庫物件類型

文字搜尋剖析器和範本是從低階 C 函式建立的；因此，開發新的剖析器和範本需要 C 程式設計能力，並且需要超級使用者權限才能將其安裝到資料庫中。（在 PostgreSQL 發行版本的 contrib/ 區域中有附加剖析器和範本的範例。）由於字典和設定只是將一些底層剖析器和範本參數化並連接在一起，因此建立新的字典或設定不需要特殊權限。建立自訂字典和設定的範例將在本章稍後出現。