eventstream에 사용자 지정 엔드포인트 대상 추가

아티클
05/22/2024

이 문서에서는 Microsoft Fabric 이벤트 스트림의 이벤트 스트림에 사용자 지정 엔드포인트(즉, 표준 기능의 사용자 지정 앱) 대상을 추가하는 방법을 보여 줍니다.

참고 항목

미리 보기에 있는 향상된 기능을 사용하려면 맨 위에 있는 향상된 기능을 선택합니다. 그렇지 않으면 표준 기능을 선택합니다. 미리 보기로 제공되는 향상된 기능에 대한 자세한 내용은 패브릭 이벤트 스트림 소개를 참조 하세요.

필수 조건

시작하기 전에 다음 필수 구성 요소를 완료해야 합니다.

Eventstream이 있는 기여자 이상의 권한이 있는 프리미엄 작업 영역에 액세스합니다.

참고 항목

하나의 Eventstream에 대한 최대 원본 및 대상 수는 11개입니다.

사용자 지정 엔드포인트를 대상으로 추가

이벤트 데이터를 앱으로 라우팅하려는 경우 사용자 지정 엔드포인트를 eventstream 대상으로 추가할 수 있습니다. 사용자 지정 엔드포인트 대상을 추가하려면 다음 단계를 수행합니다.

라이브 보기에 있는 경우 리본에서 편집을 선택하여 편집 모드로 전환합니다.
편집 모드에서 다음 방법 중 하나로 사용자 지정 엔드포인트 대상을 추가합니다.
- 리본에서 대상 추가를 선택한 다음, 사용자 지정 엔드포인트를 선택하고 기본 스트림 또는 파생 스트림에 연결합니다.
- 편집기에서 이벤트 변환을 선택하거나 대상을 추가한 다음 사용자 지정 엔드포인트를 선택합니다.
사용자 지정 엔드포인트의 대상 이름을 입력하고 저장을 선택합니다.
연결이 아직 없는 경우 기본 스트림 타일을 사용자 지정 엔드포인트 타일에 연결합니다.
사용자 지정 엔드포인트의 자세한 정보를 보려면 게시를 선택합니다.
라이브 보기에서 사용자 지정 엔드포인트 타일을 선택합니다. 그런 다음 페이지 아래쪽의 세부 정보 창을 참조하세요. 자세한 내용은 다음 섹션을 참조하세요.

세부 정보 창

세부 정보 창에는 Eventhub, AMQP 및 Kafka의 세 가지 프로토콜 탭이 있습니다. 각 프로토콜 탭에는 기본, 키 및 샘플 코드의 세 페이지가 있습니다.

기본 사항

기본 사항 페이지에는 다음 정보가 표시됩니다.

이름 - 사용자 지정 엔드포인트의 이름입니다.
형식 - 로 설정됩니다 CustomApp.
소비자 그룹 - 소비자 그룹에 대한 GUID(Globally Unique Identifier)입니다.
상태 - 사용자 지정 엔드포인트의 상태입니다.

구성

키 페이지에는 공유 액세스 키 이름, 기본 키, 보조 키, 기본 키가 있는 연결 문자열 및 보조 키가 있는 연결 문자열 세 가지 프로토콜에 대한 공통 필드가 있습니다.

Event Hubs 탭에 이벤트 허브의 이름이 표시됩니다. AMQP 탭에 엔터티 이름이 표시됩니다. Kafka 탭에는 부트스트랩 서버, 보안 프로토콜, SASL 메커니즘, SASL JASS 구성 및 토픽 이름이 표시됩니다.

샘플 코드

애플리케이션에서 사용자 지정 엔드포인트 대상에서 이벤트를 수신하는 데 사용할 수 있는 샘플 코드를 보여 줍니다.

이벤트 허브

연결 문자열 Event Hubs 호환 연결 문자열 애플리케이션에서 사용하여 eventstream에서 이벤트를 수신할 수 있습니다. 다음 예제에서는 연결 문자열 이벤트 허브 형식Endpoint=sb://eventstream-xxxxxxxx.servicebus.windows.net/;SharedAccessKeyName=key_xxxxxxxx;SharedAccessKey=xxxxxxxx;EntityPath=es_xxxxxxxx의 모양을 보여 줍니다.

이벤트 허브 형식은 연결 문자열 기본 형식이며 Azure Event Hubs SDK와 호환됩니다. 이 형식을 사용하여 Event Hubs 프로토콜을 사용하여 eventstream에 연결할 수 있습니다.

AMQP

AMQP 형식은 서로 다른 플랫폼과 언어 간의 상호 운용성을 지원하는 표준 메시징 프로토콜인 AMQP 1.0 프로토콜과 호환됩니다. 이 형식을 사용하여 AMQP 프로토콜을 사용하여 eventstream에 연결할 수 있습니다.

Kafka

Kafka 형식은 높은 처리량 및 짧은 대기 시간 데이터 처리를 지원하는 인기 있는 분산 스트리밍 플랫폼인 Apache Kafka 프로토콜과 호환됩니다. 이 형식을 사용하여 Kafka 프로토콜을 사용하여 eventstream에 연결할 수 있습니다.

애플리케이션 요구 사항 및 기본 설정에 맞는 프로토콜 형식을 선택하고 연결 문자열 복사하여 애플리케이션에 붙여넣을 수 있습니다. 다른 프로토콜을 사용하여 이벤트를 보내거나 받는 방법을 보여 주는 샘플 코드 탭에서 제공하는 샘플 코드를 참조하거나 복사할 수도 있습니다.

Eventstream에 다른 대상을 추가하는 방법을 알아보려면 다음 문서를 참조하세요.

필수 조건

시작하기 전에 다음 필수 구성 요소를 완료해야 합니다.

Eventstream이 있는 기여자 이상의 권한이 있는 프리미엄 작업 영역에 액세스합니다.

참고 항목

하나의 Eventstream에 대한 최대 원본 및 대상 수는 11개입니다.

사용자 지정 앱을 대상으로 추가

이벤트 데이터를 애플리케이션으로 라우팅하려는 경우 사용자 지정 앱을 eventstream 대상으로 추가할 수 있습니다. 사용자 지정 앱 대상을 추가하려면 다음 단계를 수행합니다.

리본에서 새 대상을 선택하거나 주 편집기 캔버스에서 "+"를 선택한 다음, 사용자 지정 앱을 선택합니다. 사용자 지정 앱 대상 구성 화면이 나타납니다.
사용자 지정 앱의 대상 이름을 입력하고 추가를 선택합니다.
사용자 지정 애플리케이션 대상을 성공적으로 만든 후에는 아래쪽 창의 세부 정보 탭에서 다음 정보를 전환하고 볼 수 있습니다.
- 기본: 사용자 지정 앱의 이름, 설명, 유형 및 상태를 표시합니다.
- 키: 복사하여 애플리케이션에 붙여넣을 수 있는 사용자 지정 앱의 연결 문자열 표시합니다.
- 샘플 코드: 이벤트 데이터를 참조하거나 복사하여 이 eventstream에 이벤트 데이터를 푸시하거나 이 eventstream에서 이벤트 데이터를 끌어올 수 있는 샘플 코드를 표시합니다.
각 탭(기본 / 키 / 샘플 코드)에 대해 Eventhub, **AMQP 및 Kafka의 세 가지 프로토콜 탭을 전환하여 다양한 프로토콜 형식 정보에 액세스할 수도 있습니다.

연결 문자열 호환되는 이벤트 허브 연결 문자열 애플리케이션에서 사용하여 eventstream에서 이벤트를 수신할 수 있습니다. 연결 문자열 키 탭에서 전환하고 선택할 수 있는 여러 프로토콜 형식이 있습니다. 다음 예제에서는 연결 문자열 이벤트 허브 형식의 모양을 보여 줍니다.

Endpoint=sb://eventstream-xxxxxxxx.servicebus.windows.net/;SharedAccessKeyName=key_xxxxxxxx;SharedAccessKey=xxxxxxxx;EntityPath=es_xxxxxxxx

이벤트 허브 형식은 연결 문자열 기본 형식이며 Azure Event Hubs SDK와 호환됩니다. 이 형식을 사용하여 Event Hubs 프로토콜을 사용하여 eventstream에 연결할 수 있습니다.

다른 두 프로토콜 형식은 AMQP 및 Kafka이며, 키 탭에서 해당 탭을 클릭하여 선택할 수 있습니다.

AMQP 형식은 서로 다른 플랫폼과 언어 간의 상호 운용성을 지원하는 표준 메시징 프로토콜인 AMQP 1.0 프로토콜과 호환됩니다. 이 형식을 사용하여 AMQP 프로토콜을 사용하여 eventstream에 연결할 수 있습니다.

Kafka 형식은 높은 처리량 및 짧은 대기 시간 데이터 처리를 지원하는 인기 있는 분산 스트리밍 플랫폼인 Apache Kafka 프로토콜과 호환됩니다. 이 형식을 사용하여 Kafka 프로토콜을 사용하여 eventstream에 연결할 수 있습니다.

대상 관리

편집/제거: 탐색 창 또는 캔버스를 통해 이벤트 스트림 대상을 편집하거나 제거할 수 있습니다.

편집을 선택하면 편집 창이 주 편집기의 오른쪽에 열립니다. 이벤트 프로세서 편집기를 통해 이벤트 변환 논리를 포함하여 원하는 대로 구성을 수정할 수 있습니다.

Eventstream에 다른 대상을 추가하는 방법을 알아보려면 다음 문서를 참조하세요.

다음을 통해 공유

eventstream에 사용자 지정 엔드포인트 대상 추가

필수 조건

사용자 지정 엔드포인트를 대상으로 추가