المهارات azure-eventhub-ts
📦

azure-eventhub-ts

آمن

Azure Event Hubs 스트리밍 애플리케이션 구축

Azure Event Hubs 를 활용한 대용량 이벤트 수집 및 실시간 데이터 처리를 구현합니다. 이 스킬은 프로듀서, 컨슈머 및 체크포인팅 전략을 위한 TypeScript SDK 패턴을 제공합니다.

يدعم: Claude Codex Code(CC)
🥉 75 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "azure-eventhub-ts". 10 개의 센서에서 온도 읽기 값을 Event Hubs 로 전송

النتيجة المتوقعة:

10 개의 이벤트 배치가 생성되어 파티션 키 device-123 으로 파티션 0 에 성공적으로 전송됨

استخدام "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 로 스트리밍하여 실시간 처리 및 분석을 수행합니다.

실시간 분석 파이프라인

정확히 한 번의 시맨틱을 위한 체크포인팅으로 스트리밍 데이터를 처리하는 이벤트 드리븐 데이터 파이프라인을 구축합니다.

이벤트 드리븐 마이크로서비스

컨슈머 그룹을 사용하여 분리된 마이크로서비스 통신을 위한 게시 - 구독 패턴을 구현합니다.

جرّب هذه الموجهات

기본 이벤트 프로듀서 설정
환경 변수를 구성으로 사용하여 Azure Event Hubs 에 온도 센서 데이터를 전송하는 TypeScript EventHubProducerClient 를 생성합니다.
로깅이 포함된 이벤트 컨슈머
이벤트를 구독하고 각 수신된 이벤트를 파티션 ID 및 타임스탬프와 함께 로깅하는 EventHubConsumerClient 를 구현합니다.
체크포인팅이 포함된 프로덕션 컨슈머
각 배치 처리 후 체크포인팅을 위해 BlobCheckpointStore 를 사용하고 일시적 오류에 대한 오류 처리를 포함한 이벤트 컨슈머를 생성합니다.
파티션 인식 이벤트 처리
디바이스별 순서를 위한 파티션 키로 이벤트를 전송하고 주어진 타임스탬프에서 특정 파티션으로부터 소비하는 솔루션을 설계합니다.

أفضل الممارسات

  • 정확히 한 번의 시맨틱을 보장하기 위해 이벤트 처리 성공 후 항상 체크포인팅 수행
  • 동일한 소스에서 온 관련 이벤트의 순서를 유지하기 위해 파티션 키 사용
  • 완료 시 EventHubProducerClient 및 EventHubConsumerClient 를 닫아 리소스 해제

تجنب

  • 프로덕션 환경에서 체크포인팅을 생략하면 재시작 시 중복 처리 발생
  • 비즈니스 로직에 이벤트 순서가 중요한 경우 파티션 키를 사용하지 않음
  • 프로듀서 또는 컨슈머 클라이언트를 열어두면 리소스 누수 및 연결 고갈 발생

الأسئلة المتكررة

파티션 ID 와 파티션 키의 차이점은 무엇인가요?
파티션 ID 는 특정 파티션을 직접 대상으로 합니다. 파티션 키는 일관된 해싱을 사용하여 관련 이벤트를 순서 보장을 위해 동일한 파티션으로 라우팅합니다.
언제 체크포인팅을 사용해야 하나요?
처리된 이벤트를 추적하기 위해 프로덕션에서 체크포인팅을 사용하세요. 정확히 한 번의 처리를 가능하게 하며 재시작 후 마지막 성공 위치에서 소비자가 다시 시작할 수 있습니다.
메시지 처리 실패를 어떻게 처리하나요?
처리 실패 시에는 체크포인팅을 하지 마세요. 이벤트는 다음 컨슈머 시작 시 다시 처리됩니다. 오류를 로깅하고 필요시 재시도 로직을 구현합니다.
어떤 인증 방법이 지원되나요?
이 스킬은 유연한 인증을 위해 관리형 ID, 환경 인증, Azure CLI 및 Visual Studio 인증을 지원하는 DefaultAzureCredential 을 사용합니다.
특정 시점부터 이벤트를 읽으려면 어떻게 하나요?
Date 객체로 설정된 enqueuedOn 과 함께 startPosition 옵션을 사용하거나 특정 오프셋 값 또는 @earliest/@latest 를 사용한 오프셋 기반 위치 지정을 사용합니다.
컨슈머 그룹의 목적은 무엇인가요?
컨슈머 그룹을 사용하면 여러 독립적인 애플리케이션이 각자의 속도로 동일한 이벤트 스트림을 읽을 수 있습니다. 각 컨슈머 그룹은 자체 체크포인트 위치를 유지합니다.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

مرجع

main

بنية الملفات

📄 SKILL.md