文件是全文搜尋系統中的搜尋單位；例如，雜誌文章或電子郵件訊息。文本搜尋引擎必須能夠剖析文件，並儲存詞位（關鍵字）與其父文件的關聯。稍後，這些關聯用於搜尋包含查詢單字的文件。

對於在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 運算符的嵌套。 如果沒有括號，則 | 的綁定最弱，然後是 &，然後是 <->，而 ! 的綁定最強。

值得注意的是，當 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/ 區域中，有一些附加剖析器和範本的範例。）由於字典和配置只是將一些底層剖析器和範本參數化並連接在一起，因此無需特殊權限即可建立新的字典或配置。建立自訂字典和配置的範例將在本章稍後介紹。