数据库设计文档

TimescaleDB 数据库结构、索引策略与自动化运维

概览

• 数据库: TimescaleDB（基于 PostgreSQL 16）
• 数据库名: crypto_data
• 容器名: crypto_timescaledb
• 版本: 1.2（含交易模块表结构）

表结构详解

1. klines — K 线数据表（Hypertable）

存储多币种、多周期的 K 线 OHLCV 数据。

• 主键: (time, symbol, timeframe)
• Chunk: 7 天
• 保留: 90 天自动清理
• 压缩: 7 天后按 symbol, timeframe 分段压缩

2. symbol_metadata — 币种元数据

3. analysis_results — 分析结果表（Hypertable）

• Chunk: 30 天
• 保留: 永久
• 压缩: 30 天后按 symbol 分段压缩

4. trading_signals — 交易信号记录（Hypertable）

5. pair_positions — 配对仓位表

6. trade_orders — 订单明细（Hypertable）

7. daily_trading_stats — 每日交易统计

索引策略

klines 表（6 个索引）

analysis_results 表（6 个索引）

交易模块索引

连续聚合视图

daily_analysis_stats

自动汇总每日分析统计：

SELECT
    time_bucket('1 day', analysis_time) AS day,
    symbol, base_symbol,
    COUNT(*) AS analysis_count,
    COUNT(*) FILTER (WHERE is_anomaly = TRUE) AS anomaly_count,
    AVG(corr_5m_7d), AVG(corr_1h_30d), AVG(corr_4h_60d),
    AVG(zscore_5m), AVG(zscore_1h), AVG(zscore_4h)
FROM analysis_results
GROUP BY day, symbol, base_symbol;

• 刷新策略: 每小时自动刷新，覆盖最近 3 天数据

连接池配置建议

使用 PgBouncer 时将端口切换为 6432。

常用运维命令

# 连接数据库
docker exec -it crypto_timescaledb psql -U postgres -d crypto_data

# 查看表结构
\d klines

# 查看索引
\di

# 查看 Hypertable 信息
SELECT * FROM timescaledb_information.hypertables;

# 查看压缩策略
SELECT * FROM timescaledb_information.compression_settings;

# 查看 chunk 信息
SELECT * FROM timescaledb_information.chunks WHERE hypertable_name = 'klines';

# 手动触发压缩
SELECT compress_chunk(c) FROM show_chunks('klines', older_than => INTERVAL '7 days') c;

# 查看数据量
SELECT symbol, timeframe, COUNT(*) FROM klines GROUP BY symbol, timeframe;