Add Azure Service Bus source to an eventstream (preview)

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

Azure Service Bus is a fully managed enterprise message broker with message queues and publish-subscribe topics. Microsoft Fabric event streams allow you to connect to Azure Service Bus, where messages in the Service Bus can be fetched into Fabric eventstream and routed to various destinations within Fabric.

Note

This source is not supported in the following regions of your workspace capacity: West US3, Switzerland West. 

Prerequisites

Before you start, you must complete the following prerequisites:

• Access to a workspace in the Fabric capacity license mode (or) the Trial license mode with Contributor or higher permissions.
• You need to have appropriate permission to get access keys for 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.
• If you don't have an eventstream, create an eventstream.

Launch the Select a data source wizard

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

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

 

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

Configure Azure Service Bus connector

1. On the Connect page, select New connection.

   

   If there's an existing connection to your Azure Service Bus resource, select that existing connection as shown in the following image, and then move on to the step to configure Service Bus Type* in the following steps.

   

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

   

3. In the Connection credentials section, do 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.

   5. Select Connect at the bottom of the page.

      

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

      1. Navigate to your Azure Service Bus namespace page in the Azure portal.
      2. On the Service Bus Namespace page, select Shared access policies on the left navigation menu.
      3. Select the access key from the list. Note down the access key name.
      4. Select the copy button next to the Primary key.

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

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

   2. If you select Topic, for Topic name, enter the name of the topic and for Subscription, enter the name of the subscription to that topic. If you select Queue, enter the name of the queue. This example uses Topic as Service Bus Type.

      

5. In the Stream details 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.

   

6. Now, at the bottom of the wizard, select Next.

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

   

Note

The maximum number of sources and destinations for one eventstream is 11.

View updated eventstream

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

   

2. After you complete these steps, the Azure event hub is available for visualization in the Live view. Select the Service Bus tile in the diagram to see the page similar to the following one.

   

Related content

For a list of all supported sources, see Add and manage an event source.