Поделиться через

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

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

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

Примечание.

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

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

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

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

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

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

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

    Снимок экрана: выбор ссылки на портал администрирования в разделе

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

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

    Снимок экрана с параметрами разработчика.

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

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

Примечание.

Поток событий может поддерживать до 11 объединенных источников и назначений только при использовании следующих типов:

  • Источник: настраиваемая конечная точка.
  • Назначения: пользовательская конечная точка и Eventhouse с прямой загрузкой.

Любые источники или назначения , не включенные в приведенный выше список, и назначения, не добавленные к потоку по умолчанию, не учитываются в этом пределе.

Добавить данные пользовательской конечной точки в качестве источника

  1. Чтобы добавить пользовательский источник конечной точки, на странице начала работы выберите "Использовать пользовательскую конечную точку". Или, если у вас уже есть опубликованный событийный поток, и вы хотите добавить настраиваемые данные конечной точки в качестве источника, переключитесь в режим редактирования. На ленте выберите Добавить источник>Пользовательская конечная точка.

    Снимок экрана варианта использования пользовательской конечной точки.

  2. В диалоговом окне "Настраиваемая конечная точка" введите имя настраиваемого источника в поле "Имя источника", а затем нажмите кнопку "Добавить".

    Снимок экрана: диалоговое окно для добавления настраиваемой конечной точки.

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

    Снимок экрана: поток событий в режиме редактирования с выделенной кнопкой

Примечание.

Поток событий может поддерживать до 11 объединенных источников и назначений только при использовании следующих типов:

  • Источник: настраиваемая конечная точка.
  • Назначения: пользовательская конечная точка и Eventhouse с прямой загрузкой.

Любые источники или назначения , не включенные в приведенный выше список, и назначения, не добавленные к потоку по умолчанию, не учитываются в этом пределе.

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

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

Снимок экрана: поток событий в режиме реального времени.

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

Basic показывает имя, тип и статус вашей пользовательской конечной точки.

Снимок экрана: основные сведения на панели сведений в режиме трансляции событий.

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

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

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

Скриншот, на котором показаны ключевые сведения на панели сведений об eventstream.

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

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

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

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

Снимок экрана, на котором показан пример кода на панели сведений в режиме трансляции событий.

Расширенный протокол управления очередью сообщений (AMQP)

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

Снимок экрана: ключи AMQP на панели сведений в режиме трансляции событий.

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

Снимок экрана: пример кода AMQP на панели сведений в режиме трансляции событий.

Кафка

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

Снимок экрана, показывающий ключи Kafka на панели сведений в живом режиме просмотра событий.

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

Снимок экрана: пример кода Kafka на панели сведений в режиме трансляции событий.

Четкое руководство по использованию пользовательской конечной точки с протоколом Kafka см. в данном руководстве . Он содержит подробные инструкции по стримингу и использованию событий с помощью пользовательской конечной точки с протоколом Kafka.

Примечание.

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

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

Список поддерживаемых источников см. в разделе "Добавление источника событий в поток событий"

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

  • Доступ к рабочей области в режиме лицензии емкости Fabric или в режиме пробной лицензии с разрешениями Сотрудника или более высокого уровня.
  • Если у вас нет потока событий, создайте поток событий.

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

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

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

  1. Выберите новый источник на ленте или знак плюса (+) на холсте основного редактора и выберите "Пользовательское приложение".

  2. В области "Пользовательское приложение" введите исходное имя настраиваемого приложения и нажмите кнопку "Добавить".

    Снимок экрана: панель настройки пользовательского приложения в качестве источника.

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

После успешного создания настраиваемого приложения в качестве источника можно просмотреть сведения на панели сведений .

В области сведений есть три вкладки протокола: Концентратор событий, 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.

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

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

Скриншот, на котором показаны ключевые сведения на панели сведений об eventstream.

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

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

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 , чтобы получить готовый код с информацией ключа подключения в формате AMQP.

Снимок экрана: пример кода AMQP на панели сведений потока событий.

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

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

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