The create_license_heartbeats_table.sql migration creates a partitioned table for storing real-time license validation data. This table is essential for the Live Dashboard & Analytics functionality.

Features

Monthly partitioning for efficient data management
Automatic creation of current and next month partitions
Optimized indexes for performance
Foreign key relationship with licenses table

Running the Migration

Option 1: Using the Python Script

cd /path/to/v2_adminpanel
python apply_license_heartbeats_migration.py

Option 2: Manual SQL Execution

psql -h postgres -U postgres -d v2_adminpanel -f migrations/create_license_heartbeats_table.sql

Option 3: Docker Exec

docker exec -it v2_adminpanel_postgres psql -U postgres -d v2_adminpanel -f /migrations/create_license_heartbeats_table.sql

Verification

After running the migration, verify the table was created:

-- Check if table exists
SELECT EXISTS (
    SELECT 1 
    FROM information_schema.tables 
    WHERE table_name = 'license_heartbeats'
);

-- List all partitions
SELECT tablename 
FROM pg_tables 
WHERE tablename LIKE 'license_heartbeats_%'
ORDER BY tablename;

Partition Management

The system automatically creates partitions as needed. To manually create future partitions:

from utils.partition_helper import create_future_partitions
import psycopg2

conn = psycopg2.connect(...)
create_future_partitions(conn, 'license_heartbeats', months_ahead=6)

Data Retention

Consider implementing a data retention policy to remove old partitions:

-- Drop partitions older than 3 months
DROP TABLE IF EXISTS license_heartbeats_2025_03;

Troubleshooting

Table already exists: The migration is idempotent and will skip creation if the table exists.
Permission denied: Ensure the database user has CREATE privileges.
Foreign key violation: The licenses table must exist before running this migration.