将自定义终结点源添加到事件流
如果要将自己的应用程序与事件流连接,可以添加自定义终结点(即标准功能的自定义应用)源。 然后,可以使用自定义终结点上公开的连接终结点(即标准功能的自定义应用)从自己的应用程序将实时事件发送到事件流。 此外,使用 Apache Kafka 协议作为自定义终结点(即标准功能的自定义应用)选项,可以使用 Apache Kafka 协议发送实时事件。 本文演示如何将自定义终结点(即标准功能的自定义应用)源添加到事件流。
注意
如果要使用预览版中的增强功能,请选择顶部的“增强功能”。 否则,请选择“标准功能”。 有关预览版中增强功能的信息,请参阅 Fabric 事件流简介。
先决条件
- 使用“参与者”或更高权限访问 Fabric 高级工作区。
重要
Fabric 事件流的增强功能目前以预览版方式提供。
注意
一个事件流的源和目标的最大数量为 11。
将自定义终结点数据添加为源
按照以下步骤添加自定义终结点源:
若要创建新的事件流,请从主屏幕中选择“事件流”。 确保已启用“增强功能(预览版)”选项。
要添加自定义终结点源,请在“入门”页面上,选择“使用自定义终结点”。
或者,如果已有已发布的事件流,并且想要将自定义终结点数据添加为源,请切换到“编辑”模式。 然后在功能区中选择“添加源”,然后选择“自定义终结点”。
在“自定义终结点”屏幕上,在“源名称”下,输入自定义源的名称,然后选择“添加”。
创建自定义终结点源后,会看到其在“编辑模式”下添加到画布上的事件流。 若要实现新添加的自定义应用源数据,请选择“发布”。
完成这些步骤后,自定义终结点数据可用于“实时视图”中的可视化效果。
在“详细信息”窗格中获取终结点详细信息以发送事件
“ 详细信息 ”窗格有三个协议选项卡: 事件中心、 AMQP 和 Kafka。 每个协议选项卡有三个页面: 基本信息、 密钥和 示例代码 ,其中提供了终结点详细信息以及用于连接的相应协议。
基本:显示自定义终结点的名称、说明、类型和状态。
密钥 和 示例代码 页提供连接密钥信息和示例代码,以及嵌入的相应键,可用于将事件流式传输到事件流。 “密钥”和“示例代码”信息因协议而异。
事件中心
事件中心协议格式中的密钥包含与事件中心连接字符串相关的信息,包括事件中心名称、共享访问密钥名称、主密钥和连接字符串-主键。 事件中心格式是连接字符串的默认格式,适用于 Azure 事件中心 SDK。 此格式允许通过事件中心协议连接到事件流。 以下示例显示了“事件中心”格式的连接字符串的呈现效果:
Endpoint=sb://eventstream-xxxxxxxx.servicebus.windows.net/;SharedAccessKeyName=key_xxxxxxxx;SharedAccessKey=xxxxxxxx;EntityPath=es_xxxxxxx
“ 事件中心”选项卡中的示例代码 页提供现成的代码,其中包含事件中心中所需的连接密钥信息。 只需将其复制并粘贴到应用程序中即可使用。
Kafka
Kafka 格式与 Apache Kafka 协议兼容,后者是一种流行的分布式流式处理平台,支持高吞吐量和低延迟的数据处理。 可以使用 Kafka 协议格式的 密钥 和 示例代码 连接到事件流并流式传输事件。
同样, Kafka 选项卡中的示例代码 页提供现成的代码,包括 Kafka 格式所需的连接键。 只需复制它即可供你使用。
AMQP
AMQP 格式与 AMQP 1.0 协议兼容,后者是一种标准消息传递协议,支持不同平台和语言之间的互操作性。 可以使用此格式通过 AMQP 协议连接到事件流。
AMQP 选项卡中的示例代码 页还提供现成的代码以及 AMQP 格式的连接密钥信息。
可以选择符合应用程序需求和首选项的协议格式,并将连接字符串复制并粘贴到应用程序中。 还可以参考或复制“示例代码”选项卡中提供的示例代码,其中显示了如何使用不同协议发送或接收事件。
相关内容
若要了解如何将其他源添加到 eventstream,请参阅以下文章:
先决条件
开始之前,你必须满足以下先决条件:
- 获取访问具有参与者或更高级别权限的高级工作区的权限,你的事件流放置在此工作区中。
注意
一个事件流的源和目标的最大数量为 11。
添加自定义应用作为源
如果要将自己的应用程序与事件流连接,可以添加自定义应用源。 然后,使用在自定义应用中公开的连接终结点,通过自己的应用程序将数据发送到事件流。 按照以下步骤添加自定义应用源:
在功能区上选择“新建源”或在主编辑器画布中选择“+”,然后选择“自定义应用”。
输入自定义应用的源名称,然后选择“添加”。
成功创建自定义应用程序源后,可以在下方窗格的“详细信息”选项卡中切换并查看以下信息:
在“详细信息”窗格中获取终结点详细信息以发送事件
“ 详细信息 ”窗格有三个协议选项卡: 事件中心、 AMQP 和 Kafka。 每个协议选项卡有三个页面: 基本信息、 密钥和 示例代码 ,其中提供了终结点详细信息以及用于连接的相应协议。
“基本 ”显示自定义应用的名称、说明、类型和状态。
密钥 和 示例代码 页提供连接密钥信息和示例代码,以及嵌入的相应键,可用于将事件流式传输到事件流。 “密钥”和“示例代码”信息因协议而异。
事件中心
事件中心协议格式中的密钥包含与事件中心连接字符串相关的信息,包括事件中心名称、共享访问密钥名称、主密钥和连接字符串-主键。 事件中心格式是连接字符串的默认格式,适用于 Azure 事件中心 SDK。 此格式允许通过事件中心协议连接到事件流。 以下示例显示了“事件中心”格式的连接字符串的呈现效果:
Endpoint=sb://eventstream-xxxxxxxx.servicebus.windows.net/;SharedAccessKeyName=key_xxxxxxxx;SharedAccessKey=xxxxxxxx;EntityPath=es_xxxxxxx
“ 事件中心”选项卡中的示例代码 页提供现成的代码,其中包含事件中心中所需的连接密钥信息。 只需将其复制并粘贴到应用程序中即可使用。
Kafka
Kafka 格式与 Apache Kafka 协议兼容,后者是一种流行的分布式流式处理平台,支持高吞吐量和低延迟的数据处理。 可以使用 Kafka 协议格式的 密钥 和 示例代码 连接到事件流并流式传输事件。
同样, Kafka 选项卡中的示例代码 页提供现成的代码,包括 Kafka 格式所需的连接键。 只需复制它即可供你使用。
AMQP
AMQP 格式与 AMQP 1.0 协议兼容,后者是一种标准消息传递协议,支持不同平台和语言之间的互操作性。 可以使用此格式通过 AMQP 协议连接到事件流。
AMQP 选项卡中的示例代码 页还提供现成的代码以及 AMQP 格式的连接密钥信息。
可以选择符合应用程序需求和首选项的协议格式,并将连接字符串复制并粘贴到应用程序中。 还可以参考或复制“示例代码”选项卡中提供的示例代码,其中显示了如何使用不同协议发送或接收事件。
相关内容
若要了解如何将其他源添加到 eventstream,请参阅以下文章: