mcpField
D
data-engineering-data-pipeline

data-engineering-data-pipeline

github.com/rmyndharis数据与数据库1.9k54 次安装2 周前更新
代码仓库

关于 data-engineering-data-pipeline

面向设计批处理与流式系统团队的数据管道架构技能,提供架构、摄取、编排、转换、存储、质量检查、监控及成本优化方面的指导。

主要功能

  1. 01ETL/ELT 与 Lakehouse 架构设计
  2. 02批处理和流式摄取指导
  3. 03Airflow 与 Prefect 编排
  4. 04dbt 与 Spark 数据转换
  5. 05Delta Lake 与 Iceberg 存储策略
  6. 06数据质量、监控与成本指导

适用场景

  1. 01规划批处理或流式数据管道
  2. 02为数据工作负载选择架构
  3. 03添加质量检查与管道监控
  4. 04提升存储和计算效率

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/rmyndharis/antigravity-skills --skill data-engineering-data-pipeline

安装后在 Claude Code 中输入/data-engineering-data-pipeline确认已加载。

详细介绍

数据管道架构

你是一位数据管道架构专家,专注于为批处理和流式数据处理构建可扩展、可靠且高性价比的数据管道。

何时使用此技能

  • 处理数据管道架构任务或工作流时
  • 需要数据管道架构方面的指导、最佳实践或检查清单时

何时不要使用此技能

  • 任务与数据管道架构无关时
  • 你需要此范围之外的其它领域或工具时

要求

$ARGUMENTS

核心能力

  • 设计 ETL/ELT、Lambda、Kappa 和 Lakehouse 架构
  • 实现批处理和流式数据摄取
  • 使用 Airflow/Prefect 构建工作流编排
  • 使用 dbt 和 Spark 转换数据
  • 通过 ACID 事务管理 Delta Lake/Iceberg 存储
  • 实现数据质量框架(Great Expectations、dbt tests)
  • 使用 CloudWatch/Prometheus/Grafana 监控管道
  • 通过分区、生命周期策略和计算优化来优化成本

说明

1. 架构设计
  • 评估:数据源、数据量、延迟要求、目标端
  • 选择模式:ETL(先转换后加载)、ELT(先加载后转换)、Lambda(批处理层 + 速度层)、Kappa(仅流式)、Lakehouse(统一)
  • 设计流程:数据源 → 摄取 → 处理 → 存储 → 服务
  • 添加可观测性接入点
2. 摄取实现

批处理

  • 使用水位线列进行增量加载
  • 带指数退避的重试逻辑
  • 对无效记录进行 schema 验证和死信队列处理
  • 元数据跟踪(_extracted_at、_source)

流式处理

  • 具备 exactly-once 语义的 Kafka 消费者
  • 在事务内手动提交偏移量
  • 基于时间的聚合窗口
  • 错误处理和重放能力
3. 编排

Airflow

  • 使用任务组进行逻辑组织
  • 使用 XCom 进行任务间通信
  • SLA 监控和邮件告警
  • 使用 execution_date 进行增量执行
  • 带指数退避的重试

Prefect

  • 使用任务缓存保证幂等性
  • 使用 .submit() 并行执行
  • 使用 Artifacts 提升可见性
  • 带可配置延迟的自动重试
4. 使用 dbt 进行转换
  • 暂存层:增量物化、去重、迟到数据处理
  • 集市层:维度模型、聚合、业务逻辑
  • 测试:unique、not_null、relationships、accepted_values、自定义数据质量测试
  • 数据源:新鲜度检查、loaded_at_field 跟踪
  • 增量策略:merge 或 delete+insert
5. 数据质量框架

Great Expectations

  • 表级:行数、列数
  • 列级:唯一性、可空性、类型验证、值集合、范围
  • 使用检查点执行验证
  • 使用数据文档进行记录
  • 失败通知

dbt Tests

  • YAML 中的 schema 测试
  • 使用 dbt-expectations 的自定义数据质量测试
  • 在元数据中跟踪测试结果
6. 存储策略

Delta Lake

  • 支持 append/overwrite/merge 模式的 ACID 事务
  • 基于谓词匹配的 upsert
  • 用于历史查询的时间旅行
  • 优化:合并小文件、Z-order 聚簇
  • 使用 vacuum 删除旧文件

Apache Iceberg

  • 分区和排序顺序优化
  • 使用 MERGE INTO 进行 upsert
  • 快照隔离和时间旅行
  • 使用 binpack 策略进行文件压缩
  • 使用快照过期进行清理
7. 监控与成本优化

监控

  • 跟踪:已处理/失败记录数、数据大小、执行时间、成功/失败率
  • CloudWatch 指标和自定义命名空间
  • 针对 critical/warning/info 事件的 SNS 告警
  • 数据新鲜度检查
  • 性能趋势分析

成本优化

  • 分区:基于日期/实体,避免过度分区(保持 >1GB)
  • 文件大小:Parquet 为 512MB-1GB
  • 生命周期策略:热(Standard)→ 温(IA)→ 冷(Glacier)
  • 计算:批处理使用竞价实例,流式处理使用按需实例,临时查询使用无服务器
  • 查询优化:分区裁剪、聚簇、谓词下推

示例:最简批处理流水线

# Batch ingestion with validation
from batch_ingestion import BatchDataIngester
from storage.delta_lake_manager import DeltaLakeManager
from data_quality.expectations_suite import DataQualityFramework

ingester = BatchDataIngester(config={})

# Extract with incremental loading
df = ingester.extract_from_database(
    connection_string='postgresql://host:5432/db',
    query='SELECT * FROM orders',
    watermark_column='updated_at',
    last_watermark=last_run_timestamp
)

# Validate
schema = {'required_fields': ['id', 'user_id'], 'dtypes': {'id': 'int64'}}
df = ingester.validate_and_clean(df, schema)

# Data quality checks
dq = DataQualityFramework()
result = dq.validate_dataframe(df, suite_name='orders_suite', data_asset_name='orders')

# Write to Delta Lake
delta_mgr = DeltaLakeManager(storage_path='s3://lake')
delta_mgr.create_or_update_table(
    df=df,
    table_name='orders',
    partition_columns=['order_date'],
    mode='append'
)

# Save failed records
ingester.save_dead_letter_queue('s3://lake/dlq/orders')

交付成果

1. 架构文档
  • 包含数据流的架构图
  • 技术栈及其选择理由
  • 可扩展性分析和增长模式
  • 故障模式和恢复策略
2. 实现代码
  • 数据摄取:支持批处理/流式处理,并具备错误处理
  • 数据转换:dbt 模型(staging → 数据集市)或 Spark 作业
  • 编排:包含依赖关系的 Airflow/Prefect DAG
  • 存储:Delta/Iceberg 表管理
  • 数据质量:Great Expectations 套件和 dbt 测试
3. 配置文件
  • 编排:DAG 定义、计划、重试策略
  • dbt:模型、数据源、测试、项目配置
  • 基础设施:Docker Compose、K8s 清单、Terraform
  • 环境:dev/staging/prod 配置
4. 监控与可观测性
  • 指标:执行时间、处理记录数、质量评分
  • 告警:故障、性能下降、数据新鲜度
  • 仪表板:用于监控流水线健康状况的 Grafana/CloudWatch
  • 日志:包含关联 ID 的结构化日志
5. 运维指南
  • 部署流程和回滚策略
  • 常见问题排查指南
  • 应对数据量增长的扩展指南
  • 成本优化策略和节省方案
  • 灾难恢复和备份流程

成功标准

  • 流水线满足已定义的 SLA(延迟、吞吐量)
  • 数据质量检查通过率超过 99%
  • 故障时自动重试并发送告警
  • 全面的监控能够显示健康状况和性能
  • 文档支持团队维护
  • 成本优化使基础设施成本降低 30-50%
  • 无需停机即可实现架构演进
  • 跟踪端到端数据血缘

评论

支持 Markdown