2、报警历史记录数据结构设计

在 SECS/GEM 协议体系中，报警（Alarm）是设备向主机报告异常状态的核心机制。一个健壮的报警历史记录存储系统，其数据结构设计直接决定了查询效率、存储开销以及后续分析的准确性。本节将详细定义报警历史记录的六个核心字段，并给出标准化的数据表结构与实体关系。

2.1 核心字段定义

报警历史记录由以下六个必选字段构成，每个字段在 SECS/GEM 标准中均有对应的数据项（SVID 或 Collection Event）映射：

2.2 状态机与生命周期

报警记录的状态并非静态，而是遵循一个有限状态机模型。理解状态转换对于数据结构的完整性至关重要。

2.3 数据库表结构设计

基于上述字段定义，推荐使用关系型数据库（如 PostgreSQL 或 MySQL）存储报警历史。以下为建表 SQL 示例：

CREATE TABLE alarm_history (
    id              BIGSERIAL       PRIMARY KEY,
    alarm_id        VARCHAR(32)     NOT NULL,
    alarm_text      VARCHAR(256)    NOT NULL,
    alarm_level     SMALLINT        NOT NULL CHECK (alarm_level BETWEEN 1 AND 255),
    occur_time      TIMESTAMPTZ     NOT NULL,
    clear_time      TIMESTAMPTZ,
    status          SMALLINT        NOT NULL CHECK (status IN (0, 1, 2)),
    created_at      TIMESTAMPTZ     NOT NULL DEFAULT NOW(),
    
    -- 索引优化
    INDEX idx_alarm_id (alarm_id),
    INDEX idx_occur_time (occur_time),
    INDEX idx_status (status),
    INDEX idx_alarm_level (alarm_level)
);

COMMENT ON TABLE alarm_history IS '报警历史记录表';
COMMENT ON COLUMN alarm_history.status IS '0=已清除, 1=激活, 2=已确认';

2.4 数据结构实体关系图

以下 SVG 图展示了报警记录与设备、报警定义表之间的逻辑关系，帮助理解数据在系统中的流转：

2.5 字段设计最佳实践

• 报警ID 命名规范： 建议采用 "模块_序号" 格式，如 "CHAMBER_01_TEMP_HIGH"，便于分类检索。
• 时间字段处理： 统一使用 UTC 时间存储，前端展示时转换为本地时区。清除时间允许为 NULL，表示报警尚未清除。
• 报警级别映射： 建议将 SECS/GEM 的 1~255 级别映射为业务含义：1~50=提示, 51~100=警告, 101~200=错误, 201~255=紧急。
• 数据归档策略： 超过 6 个月的历史数据迁移至归档表或冷存储，主表只保留活跃报警和近期历史。