Aether/alembic/versions/20251220_1500_add_usage_composite_indexes.py

"""add usage table composite indexes for query optimization

Revision ID: b2c3d4e5f6g7
Revises: a1b2c3d4e5f6
Create Date: 2025-12-20 15:00:00.000000+00:00

"""
from alembic import op
from sqlalchemy import inspect, text

# revision identifiers, used by Alembic.
revision = 'b2c3d4e5f6g7'
down_revision = 'a1b2c3d4e5f6'
branch_labels = None
depends_on = None


def index_exists(table_name: str, index_name: str) -> bool:
    """检查索引是否存在"""
    bind = op.get_bind()
    inspector = inspect(bind)
    indexes = [idx['name'] for idx in inspector.get_indexes(table_name)]
    return index_name in indexes


def upgrade() -> None:
    """为 usage 表添加复合索引以优化常见查询

    使用 CONCURRENTLY 创建索引以避免锁表，
    但需要在 AUTOCOMMIT 模式下执行（不能在事务内）
    """
    conn = op.get_bind()
    engine = conn.engine

    # 使用新连接并设置 AUTOCOMMIT 模式以支持 CREATE INDEX CONCURRENTLY
    with engine.connect().execution_options(isolation_level="AUTOCOMMIT") as autocommit_conn:
        # 1. user_id + created_at 复合索引 (用户用量查询)
        if not index_exists('usage', 'idx_usage_user_created'):
            autocommit_conn.execute(text(
                "CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_usage_user_created "
                "ON usage (user_id, created_at)"
            ))

        # 2. api_key_id + created_at 复合索引 (API Key 用量查询)
        if not index_exists('usage', 'idx_usage_apikey_created'):
            autocommit_conn.execute(text(
                "CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_usage_apikey_created "
                "ON usage (api_key_id, created_at)"
            ))

        # 3. provider + model + created_at 复合索引 (模型统计查询)
        if not index_exists('usage', 'idx_usage_provider_model_created'):
            autocommit_conn.execute(text(
                "CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_usage_provider_model_created "
                "ON usage (provider, model, created_at)"
            ))


def downgrade() -> None:
    """删除复合索引"""
    if index_exists('usage', 'idx_usage_provider_model_created'):
        op.drop_index('idx_usage_provider_model_created', table_name='usage')

    if index_exists('usage', 'idx_usage_apikey_created'):
        op.drop_index('idx_usage_apikey_created', table_name='usage')

    if index_exists('usage', 'idx_usage_user_created'):
        op.drop_index('idx_usage_user_created', table_name='usage')