Добавление настраиваемой конечной точки или назначения пользовательского приложения в поток событий

Чтобы подключить собственное приложение к потоку событий, добавьте пользовательскую конечную точку или пользовательское приложение в качестве назначения. С помощью этого подключения можно использовать события в режиме реального времени из потока событий в собственное приложение. При использовании протокола Apache Kafka с пользовательскими конечными точками или пользовательскими приложениями можно использовать события в режиме реального времени с помощью протокола Apache Kafka.

В этой статье описано, как добавить пользовательскую точку назначения конечной точки или пользовательскую точку назначения приложения в поток событий Microsoft Fabric.

Предварительные условия

Перед началом работы убедитесь, что у вас есть доступ к рабочей области, в которой находится ваш поток событий. Рабочая область должна иметь емкость Fabric или тип рабочей области Fabric Trial.

• Вам необходимы разрешения Contributor или выше для редактирования потока событий и добавления целевой пользовательской конечной точки.
• Чтобы использовать аутентификацию Entra ID для подключения вашего приложения, вам нужны разрешения члена или выше.

Если вы используете Entra ID, убедитесь, что управляемая идентификация пользовательской конечной точки имеет необходимые разрешения. Настройте необходимые параметры на портале администрирования:

1. Выберите "Параметры " (значок шестеренки) в правом верхнем углу.

2. Выберите портал администрирования в разделе "Управление и аналитика ".

   

3. Активируйте следующий параметр клиента, чтобы предоставить субъекту-службе доступ к API Fabric для создания рабочих областей, подключений или конвейеров развертывания:

   • На странице параметров арендатора в разделе параметров разработчика разверните параметр Служебный принципал может использовать API Fabric.
   • Установите значение Включено.
   • Применяется ко всей организации.
   • Выберите Применить.

   

4. Включите этот параметр для доступа ко всем другим API (включен по умолчанию для новых клиентов):

   • На странице настроек арендатора разверните параметр Разрешить служебным субъектам создавать и использовать профили.
   • Установите значение Включено.
   • Применяется ко всей организации.
   • Выберите Применить.

Добавление настраиваемой конечной точки в качестве назначения

Чтобы маршрутизировать данные событий в приложение, добавьте пользовательскую конечную точку в качестве назначения потока событий:

1. Если вы находитесь в режиме реального времени, перейдите в режим редактирования, нажав кнопку "Изменить " на ленте.

   

2. В режиме редактирования добавьте пользовательскую конечную точку в качестве назначения одним из следующих способов:

   • Выберите Добавить назначение на панели инструментов, выберите пользовательскую конечную точку, а затем подключите конечную точку к потоку по умолчанию или производному потоку.

     

   • В редакторе выберите "Преобразовать события" или "Добавить назначение", а затем выберите пользовательскую конечную точку.

     

3. В поле "Имя назначения" введите имя настраиваемой конечной точки. Затем выберите Сохранить.

   

   Если вы используете схемы в источнике, для входной схемы выберите схему для событий. Это поле является дополнительным полем, которое вы заполняете при включении поддержки схемы для потока событий.

   

4. Подключите плитку потока по умолчанию к пользовательской плитке конечной точки, если нет существующего подключения.

   

5. Чтобы просмотреть подробные сведения для пользовательского конечного узла, выберите Опубликовать.

   

Получите сведения о конечной точке на панели сведений для обработки событий

В режиме реального времени выберите плитку настраиваемой конечной точки. В появившейся области сведений есть три вкладки протокола: Концентратор событий, AMQP и Kafka.

Каждая вкладка протокола содержит три страницы: Базовая, идентификация ключа SAS и идентификация Entra ID. Эти страницы предоставляют сведения о конечной точке, относящиеся к выбранному протоколу.

• На странице «Основной» отображается имя, тип и состояние пользовательской конечной точки.

  

• Аутентификация с использованием ключа SAS и Проверка подлинности Entra ID — это два поддерживаемых метода аутентификации для подключения к приложению:

  • Проверка подлинности ключа SAS предоставляет информацию, необходимую для создания и использования данных Eventstream с помощью ключей SAS (Shared Access Signature).
  • Аутентификация Entra ID позволяет субъекту безопасности (например, пользователю или учетной записи службы) использовать данные Eventstream с помощью аутентификации Microsoft Entra ID.

Инструкции по использованию проверки подлинности Entra ID см. в разделе "Включение проверки подлинности Entra ID для приложения в Eventstream".
В следующем разделе описывается, как подключиться к назначению пользовательской конечной точки с помощью проверки подлинности ключа SAS.

концентратор событий;

Страница "Ключи" на вкладке "Концентратор событий" содержит сведения, связанные со строкой подключения концентратора событий. Сведения включают имя концентратора событий, имя ключа общего доступа, первичный ключ и строка подключения-первичный ключ.

Формат концентратора событий — это формат по умолчанию для строки подключения, который работает с пакетом SDK Azure Event Hubs. Этот формат позволяет подключаться к потоку событий через протокол Центров событий.

В следующем примере показано, как выглядит строка подключения в формате концентратора событий:

Endpoint=sb://eventstream-xxxx.servicebus.windows.net/; SharedAccessKeyName=key_xxxxxxxx;SharedAccessKey=xxxxx;EntityPath=es_xxxxxxx

Выберите "Показать пример кода " на странице концентратора событий , чтобы получить готовый к использованию код, содержащий необходимые сведения о ключах подключения в концентраторе событий. Просто скопируйте и вставьте его в приложение для использования.

Кафка

Формат Kafka совместим с протоколом Apache Kafka, который является популярной распределенной потоковой платформой, которая поддерживает обработку данных с высокой пропускной способностью и низкой задержкой. Ключи и примеры кода можно использовать для подключения к потоку событий и обработки событий в формате протокола Kafka.

Выберите "Показать пример кода " на странице Kafka, чтобы получить готовый код, включая необходимые ключи подключения в формате Kafka . Просто скопируйте его для использования.

В этом руководстве описано, как использовать пользовательскую конечную точку с протоколом Kafka. Он содержит подробные инструкции по потоковой передаче и потреблению событий, используя пользовательский конечный пункт с протоколом Kafka.

AMQP

Формат AMQP работает с протоколом AMQP 1.0, который является стандартным протоколом обмена сообщениями, поддерживающим взаимодействие между различными платформами и языками. Используйте этот формат для подключения к потоку событий с помощью протокола AMQP.

Выберите "Показать пример кода " на странице AMQP , чтобы получить готовый к использованию код с информацией ключа подключения в формате AMQP.

Выберите формат протокола, соответствующий вашим потребностям и предпочтениям приложения, а затем скопируйте и вставьте строку подключения в приложение. Вы также можете открыть или скопировать пример кода на странице с примером кода, где показано, как отправлять или получать события с помощью различных протоколов.

Связанный контент

Как добавить другие назначения в поток событий, см. в следующих статьях:

• Производный поток
• База данных KQL
• Озёрный Дом
• Активатор Ткани