信号筛选服务元数据存储（Signals Screening Service - Metastore）镜像文档

1. 镜像概述

本镜像为信号筛选服务（Signals Screening Service）专用的元数据存储解决方案，旨在集中管理信号筛选过程中产生和依赖的各类元数据，包括但不限于信号定义、筛选规则、数据源配置、数据 schema 及处理流程信息等。通过标准化的元数据管理，确保信号筛选服务各组件间元数据的一致性、可访问性和可追溯性，提升服务整体的稳定性和可维护性。

2. 核心功能与特性

2.1 元数据管理能力

• 支持多类型元数据存储：信号基础信息（ID、名称、描述、数据类型）、筛选规则（条件表达式、阈值、优先级）、数据源配置（连接信息、认证方式、更新频率）等。
• 元数据版本控制：记录元数据变更历史，支持版本回溯与对比，满足审计与合规需求。

2.2 数据持久化与可靠性

• 基于稳定的存储引擎（如 PostgreSQL、MySQL 等，具体取决于镜像版本），确保元数据持久化存储。
• 支持数据备份与恢复机制，可通过配置实现定时备份，保障元数据安全性。

2.3 高效查询与集成

• 优化元数据查询性能，支持按信号 ID、规则类型、数据源等多维度检索。
• 提供标准化 API 接口，无缝集成信号筛选服务及其他依赖元数据的组件。

2.4 配置灵活性

• 通过环境变量或配置文件自定义存储参数（如端口、连接池大小、日志级别等）。
• 支持单机部署与集群部署模式，适应不同规模的服务需求。

3. 使用场景

3.1 信号筛选服务元数据统一管理

作为信号筛选服务的核心元数据存储组件，集中管理所有与信号筛选相关的元数据，避免分散存储导致的不一致问题。

3.2 多服务共享元数据

支持多个信号筛选服务实例或上下游服务（如数据采集服务、结果分析服务）共享元数据，提升数据协同效率。

3.3 元数据变更追踪与审计

通过版本控制功能，记录元数据的创建、修改、删除操作，满足合规审计及问题追溯需求。

3.4 高可用部署场景

在对服务可用性要求较高的场景中，通过集群部署模式（如主从复制）确保元数据服务的持续可用。

4. 使用方法与配置说明

4.1 快速启动（Docker Run）

bash
docker run -d \
  --name signals-screening-metastore \
  -p 8080:8080 \
  -e DB_HOST=mysql-host \
  -e DB_PORT=3306 \
  -e DB_NAME=signals_metastore \
  -e DB_USER=metastore_user \
  -e DB_PASSWORD=secure_password \
  -e LOG_LEVEL=INFO \
  signals-screening-service/metastore:latest

4.2 Docker Compose 部署示例

yaml
version: '3.8'
services:
  metastore:
    image: signals-screening-service/metastore:latest
    container_name: signals-screening-metastore
    ports:
      - "8080:8080"
    environment:
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_NAME=signals_metastore
      - DB_USER=metastore_user
      - DB_PASSWORD=secure_password
      - LOG_LEVEL=INFO
      - MAX_CONNECTIONS=100
      - BACKUP_ENABLED=true
      - BACKUP_INTERVAL=24h
    depends_on:
      - mysql
    volumes:
      - metastore-data:/var/lib/metastore/data

  mysql:
    image: mysql:8.0
    container_name: metastore-mysql
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=signals_metastore
      - MYSQL_USER=metastore_user
      - MYSQL_PASSWORD=secure_password
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  metastore-data:
  mysql-data:

4.3 环境变量配置说明

4.4 数据持久化

通过挂载宿主机目录或命名卷（如示例中的 metastore-data 卷），可实现元数据服务配置及运行时数据的持久化，避免容器重启导致数据丢失。

4.5 健康检查

服务启动后，可通过访问 http://<容器IP>:<PORT>/health 端点检查服务健康状态，返回 200 OK 表示服务正常运行。

5. 注意事项

• 首次启动时，服务会自动初始化数据库表结构，需确保数据库用户具备足够权限（如 CREATE TABLE、INSERT 等）。
• 生产环境中建议启用 BACKUP_ENABLED 并配置定期备份，同时通过防火墙限制数据库访问来源，提升安全性。
• 集群部署时，需额外配置数据库主从复制或使用分布式存储方案，确保元数据服务的高可用性。