to_tsquery for search terms in PostgreSQL - Cheat Sheet & Quick Revision

Recall & Review

beginner

What does the to_tsquery function do in PostgreSQL?

to_tsquery converts a text search query string into a format that PostgreSQL can use to perform full-text searches.

beginner

How do you combine multiple search terms using to_tsquery?

You use the & operator to combine terms with AND, and the | operator to combine terms with OR inside the to_tsquery string.

intermediate

What is the difference between to_tsquery and plainto_tsquery?

to_tsquery expects a query with operators like & or |, while plainto_tsquery treats the input as plain text and automatically combines terms with AND.

beginner

Write a to_tsquery expression to search for documents containing both 'cat' and 'dog'.

to_tsquery('cat & dog')

intermediate

What happens if you use to_tsquery with an empty string?

It returns an empty query that matches nothing, so no rows will be found in a search.

Which operator in to_tsquery means AND?

A :

B &

C !

D |

The & operator means AND in to_tsquery.

What does to_tsquery('cat | dog') search for?

A Documents containing either 'cat' or 'dog'

B Documents containing neither 'cat' nor 'dog'

C Documents containing both 'cat' and 'dog'

D Documents containing the phrase 'cat dog'

The | operator means OR, so it searches for documents containing either 'cat' or 'dog'.

Which function automatically treats input as plain text and combines terms with AND?

A to_tsquery

B ts_rank

C tsvector

D plainto_tsquery

plainto_tsquery treats input as plain text and combines terms with AND automatically.

How would you write a to_tsquery to search for 'apple' but not 'banana'?

A to_tsquery('apple ! banana')

B to_tsquery('apple | banana')

C to_tsquery('apple & !banana')

D to_tsquery('apple & banana')

The ! operator means NOT, so apple & !banana searches for 'apple' but excludes 'banana'.

What type of data does to_tsquery return?

A tsquery type

B Text string

C Integer

D Boolean

to_tsquery returns a tsquery type used for full-text search matching.

Explain how to use to_tsquery to search for multiple terms with AND and OR operators.

Think about how you combine words inside the query string.

Describe the difference between to_tsquery and plainto_tsquery and when to use each.

One expects operators, the other treats input as simple words.

Practice

1. What does the to_tsquery function do in PostgreSQL?

easy

A. It converts search terms into a format for full-text search queries.

B. It creates a new table for storing search terms.

C. It updates text columns with search keywords.

D. It deletes rows that match search terms.

Solution

1. Step 1: Understand the purpose of to_tsquery

   to_tsquery converts plain search words into a special query format that PostgreSQL can use for full-text searching.

2. Step 2: Compare options with the function's role

   Only It converts search terms into a format for full-text search queries. correctly describes this conversion role. Other options describe unrelated database actions.

3. Final Answer:

   It converts search terms into a format for full-text search queries. -> Option A

4. Quick Check:

   to_tsquery = converts search terms [OK]

Hint: Remember: to_tsquery prepares search words for text search [OK]

Common Mistakes:

• Thinking it creates or modifies tables
• Confusing it with data update or delete operations
• Assuming it returns raw text instead of a query format

2. Which of the following is the correct syntax to create a to_tsquery for searching the words 'cat' AND 'dog' using the explicit AND operator?

easy

A. to_tsquery('cat | dog')

B. to_tsquery('cat & dog')

C. to_tsquery('cat dog')

D. to_tsquery('cat && dog')

Solution

1. Step 1: Recall the AND operator in to_tsquery

   The AND operator is represented by & in to_tsquery syntax.

2. Step 2: Match the correct syntax

   to_tsquery('cat & dog') uses & correctly between 'cat' and 'dog'. to_tsquery('cat | dog') uses OR, C misses operator, and D uses invalid &&.

3. Final Answer:

   to_tsquery('cat & dog') -> Option B

4. Quick Check:

   AND = & in to_tsquery [OK]

Hint: Use & for AND, | for OR in to_tsquery strings [OK]

Common Mistakes:

• Using spaces without operators to mean AND
• Using double ampersands (&&) instead of single &
• Confusing OR (|) with AND (&)

3. Given the query:
SELECT to_tsquery('fast & !slow');
What is the expected output?

medium

A. 'fast' | !'slow'

B. Syntax error

C. 'fast' & !'slow'

D. 'fast slow'

Solution

1. Step 1: Understand the operators in the query

   The query uses AND (&) between 'fast' and NOT (!) 'slow'. This means search for 'fast' but exclude 'slow'.

2. Step 2: Check the output format of to_tsquery

   PostgreSQL returns the query as a string with words quoted and operators preserved. So output is 'fast' & !'slow'.

3. Final Answer:

   'fast' & !'slow' -> Option C

4. Quick Check:

   AND = & and NOT = ! in output [OK]

Hint: NOT is !, AND is & in to_tsquery output [OK]

Common Mistakes:

• Confusing OR (|) with AND (&)
• Expecting raw words without quotes
• Thinking the query causes syntax error

4. Identify the error in this query:
SELECT to_tsquery('apple & | orange');

medium

A. Syntax error due to consecutive operators & |

B. No error, valid query

C. Error because words must be uppercase

D. Error because to_tsquery needs two arguments

Solution

1. Step 1: Analyze the operator usage in the query string

   The string has & | operators consecutively without a word between them, which is invalid syntax.

2. Step 2: Confirm PostgreSQL behavior

   PostgreSQL will raise a syntax error because operators must separate valid search terms, not each other.

3. Final Answer:

   Syntax error due to consecutive operators & | -> Option A

4. Quick Check:

   Operators must separate words, not each other [OK]

Hint: Avoid placing operators consecutively without words [OK]

Common Mistakes:

• Assuming multiple operators in a row are allowed
• Thinking case of words matters
• Believing to_tsquery requires multiple arguments

5. You want to search for documents containing the word 'run' but not 'running'. Which to_tsquery expression correctly achieves this?

hard

A. to_tsquery('run ! running')

B. to_tsquery('run | !running')

C. to_tsquery('run & !run')

D. to_tsquery('run & !running')

Solution

1. Step 1: Understand the requirement

   You want documents that contain 'run' but exclude those that contain 'running'. This means AND 'run' and NOT 'running'.

2. Step 2: Choose the correct operator usage

   AND is & and NOT is !. to_tsquery('run & !running') uses these correctly. to_tsquery('run | !running') uses OR which is wrong. to_tsquery('run & !run') excludes 'run' itself. to_tsquery('run ! running') has invalid syntax (missing operator between 'run' and '!').

3. Final Answer:

   to_tsquery('run & !running') -> Option D

4. Quick Check:

   AND = & and NOT = ! for correct filtering [OK]

Hint: Use & for AND, ! for NOT to exclude terms [OK]

Common Mistakes:

• Using OR instead of AND for inclusion
• Excluding the main word accidentally
• Missing operators between words