Index Optimization Report

Documentation Index

Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt

Use this file to discover all available pages before exploring further.

Version: 1.0.0
Date: 2026-01-17
Status: ✅ Complete

​

Executive Summary

​

Key Metrics

​

Phase 2A: Foreign Key Indexes

​

Methodology

1. Analysis: Queried pg_stat_user_tables for tables with high sequential scan counts
2. Verification: Cross-referenced with actual schema to identify missing FK indexes
3. Prioritization: Ordered by sequential scan count (highest first)
4. Implementation: Created indexes in 3 batches by priority

​

Migration 1: High Priority (18 indexes)

​

Migration 2: Medium Priority (15 indexes)

​

Migration 3: Standard Priority (27 indexes)

​

Duplicate Index Cleanup

​

Index Verification

​

Check New Indexes

SELECT 
  indexname,
  tablename,
  indexdef
FROM pg_indexes
WHERE schemaname = 'public'
  AND indexname LIKE 'idx_%'
ORDER BY tablename, indexname;

​

Monitor Index Usage

-- Check index usage after 1 week
SELECT * FROM pf_get_unused_indexes();

​

Check for Missing Indexes

-- Find FKs without indexes
SELECT
  tc.table_name,
  kcu.column_name,
  ccu.table_name AS foreign_table_name
FROM information_schema.table_constraints tc
JOIN information_schema.key_column_usage kcu
  ON tc.constraint_name = kcu.constraint_name
JOIN information_schema.constraint_column_usage ccu
  ON ccu.constraint_name = tc.constraint_name
WHERE tc.constraint_type = 'FOREIGN KEY'
  AND NOT EXISTS (
    SELECT 1 FROM pg_indexes
    WHERE tablename = tc.table_name
      AND indexdef LIKE '%' || kcu.column_name || '%'
  )
ORDER BY tc.table_name;

​

Performance Impact

​

Expected Improvements

​

Monitoring Queries

-- Check slow queries
SELECT * FROM pf_get_slow_queries(100, 20);

-- Check table bloat
SELECT * FROM pf_get_table_bloat();

​

Maintenance Recommendations

1. Weekly: Run VACUUM ANALYZE on high-traffic tables (automatic via Supabase)
2. Monthly: Check pf_get_unused_indexes() for indexes to remove
3. Quarterly: Review pf_get_slow_queries() for new indexing opportunities

​

References

• Performance Optimization Log
• RLS Policy Audit
• Database Audit Report