基于Django框架在TimescaleDB中配置多时间序列的问题

核心问题分析 #

你之前的错误在于把time单独设为主键，导致不同资产的同时间戳记录主键重复。TimescaleDB并不要求time必须是单一主键，只需要它作为分区键，主键可以是包含time的复合键。

修改后的模型代码 #

from django.db import models
from timescale.db.models.models import TimescaleModel
from .assets import Asset  

class TimeseriesData(TimescaleModel):
    # 移除time字段的primary_key=True，改为和asset组成复合主键
    time = models.DateTimeField()
    asset = models.ForeignKey(Asset, on_delete=models.CASCADE)
    close_price = models.DecimalField(max_digits=10, decimal_places=2)
    volume = models.BigIntegerField()

    class Meta:
        # 定义复合主键（同时保证time+asset的唯一性）
        constraints = [
            models.UniqueConstraint(fields=['time', 'asset'], name='unique_time_asset'),
        ]
        primary_key = models.UniqueConstraint(fields=['time', 'asset'], name='primary_key_time_asset')

    # 指定TimescaleDB用于分区的时间列
    time_column = 'time'

关键调整说明 #

• 复合主键替代单一主键：用time + asset作为复合主键，既满足同一时间不同资产的记录唯一性，又符合TimescaleDB对分区键的要求（必须包含在主键或唯一约束中）。
• 明确时间分区列：通过time_column属性告诉TimescaleModel用time字段作为 hypertables 的分区依据，这是TimescaleDB做时间分区的核心配置。
• 无需单独id主键：复合主键已经能唯一标识每条记录，额外加id会增加冗余，不符合时间序列表的设计习惯。

后续操作 #

1. 生成新的迁移文件：python manage.py makemigrations
2. 执行迁移：python manage.py migrate
3. 验证数据库表：TimescaleDB会自动将该表转换为 hypertable，你可以用SQL命令确认：SELECT * FROM timescaledb_information.hypertables WHERE table_name = 'timeseries_data';

内容的提问来源于stack exchange，提问作者Iching Sebastian Quares