ANALYZE for statistics collection in PostgreSQL

Introduction

ANALYZE helps the database learn about the data. It collects information to make queries faster and smarter.

After adding or changing many rows in a table.

Before running complex queries to get better performance.

When the database seems slow or chooses a bad plan.

After loading a large amount of data into a table.

Syntax

PostgreSQL

ANALYZE [VERBOSE] [table_name];

You can run ANALYZE on the whole database or just one table.

VERBOSE shows details about what ANALYZE is doing.

Examples

Collect statistics for all tables in the current database.

PostgreSQL

ANALYZE;

Collect statistics for all tables and show detailed progress.

PostgreSQL

ANALYZE VERBOSE;

Collect statistics only for the 'customers' table.

PostgreSQL

ANALYZE customers;

Collect statistics for the 'orders' table and show details.

PostgreSQL

ANALYZE VERBOSE orders;

Sample Program

This creates a table, adds some rows, then runs ANALYZE with VERBOSE to collect statistics and show progress.

PostgreSQL

CREATE TABLE products (id SERIAL PRIMARY KEY, name TEXT, price NUMERIC);
INSERT INTO products (name, price) VALUES ('Pen', 1.20), ('Notebook', 2.50), ('Eraser', 0.80);
ANALYZE VERBOSE products;

Important Notes

ANALYZE does not lock the table, so other users can still read and write while it runs.

Regularly running ANALYZE helps keep query speed good as data changes.

PostgreSQL also runs ANALYZE automatically sometimes, but manual runs can help after big changes.

Summary

ANALYZE collects data about tables to help the database plan queries better.

You can run it on the whole database or specific tables.

Use VERBOSE to see what ANALYZE is doing step-by-step.

Practice

1. What is the main purpose of the ANALYZE command in PostgreSQL?

easy

A. To create indexes on tables

B. To delete old data from tables

C. To backup the database

D. To collect statistics about tables for query planning

Solution

1. Step 1: Understand ANALYZE function

   The ANALYZE command collects statistics about the contents of tables.

2. Step 2: Purpose of statistics

   These statistics help the database decide the best way to run queries efficiently.

3. Final Answer:

   To collect statistics about tables for query planning -> Option D

4. Quick Check:

   ANALYZE = collect statistics [OK]

Hint: ANALYZE gathers table stats to improve query plans [OK]

Common Mistakes:

• Confusing ANALYZE with data deletion
• Thinking ANALYZE creates indexes
• Assuming ANALYZE backs up data

2. Which of the following is the correct syntax to run ANALYZE on a specific table named employees with detailed output?

easy

A. ANALYZE VERBOSE employees;

B. ANALYZE employees VERBOSE;

C. ANALYZE TABLE employees VERBOSE;

D. ANALYZE VERBOSE ON employees;

Solution

1. Step 1: Recall ANALYZE syntax

   The correct syntax is ANALYZE [VERBOSE] table_name; with VERBOSE before the table name.

2. Step 2: Check each option

   ANALYZE VERBOSE employees; matches the correct syntax exactly. Others have incorrect order or extra keywords.

3. Final Answer:

   ANALYZE VERBOSE employees; -> Option A

4. Quick Check:

   ANALYZE VERBOSE table_name; = ANALYZE VERBOSE employees; [OK]

Hint: VERBOSE goes right after ANALYZE before table name [OK]

Common Mistakes:

• Placing VERBOSE after table name
• Adding TABLE keyword (not used)
• Using ON keyword incorrectly

3. Given the following commands run in PostgreSQL:

ANALYZE VERBOSE employees;
ANALYZE sales;

What will be the output behavior?

medium

A. No output for either table

B. Detailed output for employees table, no output for sales table

C. Detailed output for both tables

D. Error because VERBOSE cannot be used with ANALYZE

Solution

1. Step 1: Understand VERBOSE effect

   Using VERBOSE with ANALYZE shows detailed progress messages for that command.

2. Step 2: Analyze commands separately

   The first command shows detailed output for employees. The second command runs normally without verbose output for sales.

3. Final Answer:

   Detailed output for employees table, no output for sales table -> Option B

4. Quick Check:

   VERBOSE shows details only when used [OK]

Hint: VERBOSE shows details only for that ANALYZE command [OK]

Common Mistakes:

• Expecting output for all ANALYZE commands
• Thinking VERBOSE causes errors
• Assuming no output means failure

4. You run ANALYZE VERBOSE mytable; but get an error: ERROR: relation "mytable" does not exist. What is the most likely cause?

medium

A. The table name is misspelled or does not exist

B. ANALYZE cannot be run with VERBOSE

C. You need to run ANALYZE on the whole database first

D. The database is in read-only mode

Solution

1. Step 1: Understand the error message

   The error says the relation (table) "mytable" does not exist, meaning PostgreSQL cannot find it.

2. Step 2: Identify common causes

   This usually happens if the table name is misspelled or the table was not created.

3. Final Answer:

   The table name is misspelled or does not exist -> Option A

4. Quick Check:

   Relation not found = wrong or missing table name [OK]

Hint: Check table name spelling if relation not found error appears [OK]

Common Mistakes:

• Thinking VERBOSE causes the error
• Assuming ANALYZE must run on whole database first
• Ignoring error details about relation

5. You want to improve query performance on a large table orders that changes frequently. Which approach using ANALYZE is best?

hard

A. Run ANALYZE VERBOSE orders; only once after creating the table

B. Run ANALYZE; on the whole database once a year

C. Run ANALYZE orders; regularly and use VERBOSE to monitor progress

D. Avoid running ANALYZE because it locks the table

Solution

1. Step 1: Consider table size and update frequency

   Large, frequently changing tables benefit from regular statistics updates to keep query plans accurate.

2. Step 2: Use ANALYZE regularly with VERBOSE

   Running ANALYZE orders; regularly updates stats. Adding VERBOSE helps monitor progress during analysis.

3. Step 3: Evaluate other options

   Running ANALYZE once a year is too infrequent. Running only once after creation misses ongoing changes. ANALYZE does not lock tables for long.

4. Final Answer:

   Run ANALYZE orders; regularly and use VERBOSE to monitor progress -> Option C

5. Quick Check:

   Regular ANALYZE keeps stats fresh for big tables [OK]

Hint: Regular ANALYZE keeps stats fresh; VERBOSE shows progress [OK]

Common Mistakes:

• Running ANALYZE too rarely
• Thinking ANALYZE locks tables extensively
• Ignoring VERBOSE usefulness for monitoring