Edit

Share via


Add an Azure Service Bus source to an eventstream (preview)

Azure Service Bus is a fully managed enterprise message broker with message queues and publish/subscribe topics. You can use Microsoft Fabric eventstreams to connect to Service Bus. Messages in Service Bus can be fetched into a Fabric eventstream and routed to various destinations within Fabric.

This article shows you how to add a Service Bus source to an eventstream.

Prerequisites

  • Access to a workspace in the Fabric capacity license mode or trial license mode with Contributor or higher permissions.
  • Appropriate permission to get access keys for the Service Bus namespace, queues, or topics. The Service Bus namespace must be publicly accessible and not behind a firewall or secured in a virtual network.
  • An eventstream. If you don't have an eventstream, create one.

Start the wizard for selecting a data source

If you haven't added any source to your eventstream yet, select the Use external source tile.

Screenshot that shows the selection of the tile for using an external source.

If you're adding the source to an already published eventstream, switch to Edit mode. On the ribbon, select Add source > External sources.

Screenshot that shows selections for adding external sources.

On the Select a data source page, search for Azure Service Bus. On the Azure Service Bus tile, select Connect.

Screenshot that shows the selection of Azure Service Bus as the source type in the wizard for getting events.

Configure a Service Bus connector

  1. On the Connect page, select New connection.

    Screenshot that shows the Connect page with the link for a new connection highlighted.

    If there's an existing connection to your Azure Service Bus resource, select that existing connection, and then move on to configuring Service Bus Type in the following steps.

    Screenshot that shows the Connect page with an existing connection selected.

  2. In the Connection settings section, for Host Name, enter the host name for your service bus. You can get the name from the Overview page of your Service Bus namespace. It's in the form of NAMESPACENAME.servicebus.windows.net.

    Screenshot that shows connection settings with a Service Bus namespace specified.

  3. In the Connection credentials section, follow these steps:

    1. For Connection name, enter a name for the connection to the Service Bus queue or topic.

    2. For Authentication kind, confirm that Shared Access Key is selected.

    3. For Shared access key name, enter the name of the shared access key.

    4. For Shared Access Key, enter the value of the shared access key.

      To get the access key's name and value, follow these steps:

      1. In the Azure portal, go to the page for your Service Bus namespace.
      2. On the left menu, select Shared access policies.
      3. Select the access key from the list. Note down the name of the access key.
      4. Select the copy button next to the Primary key value.
    5. Select Connect.

    Screenshot that shows connection credentials for an Azure Service Bus connector.

  4. In the Configure Azure Service Bus Source section, follow these steps:

    1. For Service Bus Type, select Topic (default) or Queue.

    2. If you selected Topic:

      1. For Topic name, enter the name of the topic.
      2. For Subscription, enter the name of the subscription to that topic.

      Screenshot that shows topic information in the section for configuring an Azure Service Bus source.

      If you selected Queue, enter the name of the queue.

  5. In the Stream details section to the right, use the pencil button to change the source name. You might want to change this name to the name of the Service Bus namespace or the topic.

    Screenshot that shows the section for stream details in the wizard for connecting a data source.

  6. At the bottom of the wizard, select Next.

  7. On the Review + connect page, review your settings, and then select Add or Connect.

    Screenshot that shows the page for reviewing settings and adding or connecting to an Azure Service Bus data source.

View an updated eventstream

  1. Confirm that the Service Bus source is added to your eventstream on the canvas in the Edit mode. To publish it, select Publish on the ribbon.

    Screenshot that shows the editor with the Publish button selected.

  2. The Service Bus source is available for visualization in the Live view. Select the Service Bus tile in the diagram to open a page similar to the following example.

    Screenshot that shows the editor in the live view.