db

type ClickHouseTableDefinition struct {
	TableName       string            // 表名（为空时从 Model 推断）
	Columns         string            // 列定义 SQL 片段（不含外层括号，为空时从 Model 自动生成）
	Model           interface{}       // GORM 模型（Columns 为空时从模型 tag 自动生成列定义，TableName 为空时从模型推断）
	ColumnOverrides map[string]string // 列类型覆盖：字段名→ClickHouse 类型（优先级最高，用于 kind→LowCardinality(String) 等 CH 专属优化）
	OrderBy         string            // ORDER BY 表达式（必填，MergeTree 引擎要求）
	PartitionBy     string            // PARTITION BY 表达式（可选）
	TTL             string            // TTL 表达式（可选）
	Comment         string            // 表注释（可选）
}

type ColumnComment struct {
	Table   string // 表名
	Column  string // 列名
	Comment string // 注释内容
	Type    string // 列类型（MySQL 需要）
}

type GormHandler struct {
	// contains filtered or unexported fields
}

type Handler interface {
	// GetDB 返回 GORM 数据库实例
	GetDB() *gorm.DB

	// IsConnected 检查数据库连接是否有效
	IsConnected() bool
}

type IndexDefinition struct {
	Table   string // 表名
	Name    string // 索引名（可选，为空时自动生成）
	Columns string // 列定义（如 "(col1, col2)" 或 "col1 DESC"）
	Unique  bool   // 是否唯一索引

	// ClickHouse 特有参数
	ClickHouseType        string // ClickHouse 索引类型（如 bloom_filter, minmax, set 等），默认 bloom_filter
	ClickHouseGranularity int    // ClickHouse 索引粒度，默认 1

	// 覆盖索引/部分索引参数（TiDB、PostgreSQL 等支持）
	Storing []string // STORING 子句列列表（覆盖索引，将附加列存入索引避免回表）
	Where   string   // WHERE 条件（部分索引，仅索引满足条件的行）
	// contains filtered or unexported fields
}

type Migrator struct {
	// contains filtered or unexported fields
}

type MigratorConfig struct {
	// Models 需要迁移的模型列表
	Models []interface{}
	// Indexes 需要创建的索引列表
	Indexes []IndexDefinition
	// Comments 表注释列表
	Comments []TableComment
	// MergeTreeTables ClickHouse MergeTree 表定义列表（仅在 ClickHouse 方言下生效）
	MergeTreeTables []ClickHouseTableDefinition
	// Logger 日志记录器（可选，默认使用 go-toolbox/pkg/logger 创建新实例）
	Logger logger.ILogger
	// SkipIndexOnError 索引创建失败时是否跳过（默认 true）
	SkipIndexOnError bool
	// SkipCommentOnError 注释添加失败时是否跳过（默认 true）
	SkipCommentOnError bool
	// SkipMergeTreeOnError MergeTree 建表失败时是否跳过（默认 true）
	SkipMergeTreeOnError bool
}

type TableComment struct {
	Table   string // 表名
	Comment string // 注释内容
}