技能 azure-eventhub-ts
📦

azure-eventhub-ts

安全

构建 Azure Event Hubs 流式应用程序

使用 Azure Event Hubs 实现高吞吐量事件摄入和实时数据处理。本技能提供用于生产者、消费者和检查点策略的 TypeScript SDK 模式。

支持: Claude Codex Code(CC)
🥉 75 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“azure-eventhub-ts”。 发送 10 个传感器的温度读数到 Event Hubs

预期结果:

成功创建并发送包含 10 个事件的批次到分区 0,分区键为 device-123

正在使用“azure-eventhub-ts”。 订阅事件并使用检查点处理

预期结果:

从分区 2 处理 5 个事件,检查点已保存在序列号 12847

正在使用“azure-eventhub-ts”。 获取 Event Hub 属性

预期结果:

Event Hub my-eventhub 有 4 个分区,最后序列号为:12847, 12850, 12849, 12851

安全审计

安全
v1 • 2/24/2026

This skill contains documentation for the official Azure Event Hubs SDK for TypeScript. Static analyzer flagged Markdown code block delimiters as shell commands (false positive). All code patterns are standard Azure SDK usage: environment variable configuration, DefaultAzureCredential authentication, and Azure Storage endpoints for checkpointing. No security concerns identified.

1
已扫描文件
274
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
100
规范符合性

你能构建什么

IoT 遥测摄入

将来自数千个 IoT 设备的传感器数据流式传输到 Azure Event Hubs 进行实时处理和分析。

实时分析管道

构建事件驱动数据管道,使用检查点处理流式数据以实现精确一次语义。

事件驱动微服务

使用消费者组实现发布 - 订阅模式,用于解耦微服务通信。

试试这些提示

基础事件生产者设置
创建 TypeScript EventHubProducerClient,使用环境变量配置将温度传感器数据发送到 Azure Event Hubs。
带日志记录的事件消费者
实现 EventHubConsumerClient 订阅事件并记录每个接收到的事件,包括分区 ID 和时间戳。
生产环境消费者带检查点
创建事件消费者,使用 BlobCheckpointStore 在处理每批后进行检查点,带有处理瞬态故障的错误处理。
分区感知事件处理
设计使用分区键发送事件的解决方案以实现设备特定排序,并从给定时间戳从特定分区消费。

最佳实践

  • 始终在成功处理事件后进行检查点以确保精确一次语义
  • 使用分区键为来自同一来源的相关事件维护顺序
  • 完成后关闭 EventHubProducerClient 和 EventHubConsumerClient 以释放资源

避免

  • 在生产环境中跳过检查点会导致重启时重复处理
  • 当事件顺序对业务逻辑重要时不使用分区键
  • 保持生产者或消费者客户端打开会导致资源泄漏和连接耗尽

常见问题

分区 ID 和分区键有什么区别?
分区 ID 直接定位特定分区。分区键使用一致性哈希将相关事件路由到同一分区以保证顺序。
何时应该使用检查点?
在生产环境中使用检查点跟踪已处理事件。它支持精确一次处理,并允许消费者在重启后从上次成功位置恢复。
如何处理消息处理失败?
处理失败时不要进行检查点。事件将在下次消费者启动时重新处理。记录错误并可选实现重试逻辑。
支持哪些身份验证方法?
本技能使用 DefaultAzureCredential,支持托管身份、环境凭据、Azure CLI 和 Visual Studio 凭据以实现灵活的身份验证。
如何从特定时间点读取事件?
使用 startPosition 选项并设置 enqueuedOn 为 Date 对象,或使用 offset 定位与特定偏移值或 @earliest/@latest。
消费者组的目的是什么?
消费者组允许多个独立应用程序以各自的速度读取相同事件流。每个消费者组维护自己的检查点位置。

开发者详情

文件结构

📄 SKILL.md