Add Azure IoT Hub source to an eventstream

This article shows you how to add an Azure IoT Hub source to an eventstream.

Note

If you want to use enhanced capabilities that are in preview, select Enhanced capabilities at the top. Otherwise, select Standard capabilities. For information about enhanced capabilities that are in preview, see Introduction to Fabric event streams.

Prerequisites

Before you start, you must complete the following prerequisites:

• Get access to a premium workspace with Contributor or above permissions where your eventstream is located.
• You need to have appropriate permission to get IoT hub's access keys. The IoT hub must be publicly accessible and not behind a firewall or secured in a virtual network.

Important

Enhanced capabilities of Fabric event streams are currently in preview.

Note

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

Add Azure IoT Hub as a source

Follow these steps to add an Azure IoT hub as your eventstream source:

1. Create an eventstream with enhanced capabilities.

2. If you haven't added any source to your eventstream yet, select Add external source on the Get started page.

   

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

   

Configure Azure IoT Hub connector

1. On the Select a data source page, select Azure IoT Hub.

   

2. If there's an existing connection to your Azure IoT hub, select that existing connection as shown in the following image, and then move on to the step to configure Data format in the following steps.

   

3. On the Connect page, select New connection.

   

4. In the Connection settings section, for IoT Hub, specify the name of your Azure IoT hub.

   

5. In the Connection credentials section, do these steps:

   1. If there's an existing connection, select it from the drop-down list. If not, confirm that Create new connection is selected for this option.

   2. For Connection name, enter a name for the connection to the IoT hub.

   3. For Authentication method, confirm that Shared Access Key is selected.

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

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

   6. Select Connect at the bottom of the page.

      

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

      1. Navigate to the IoT Hub page for your Azure IoT hub in the Azure portal.

      2. On the IoT Hub page, select Shared access policies on the left navigation menu.

      3. Select a policy name from the list. Note down the policy name.

      4. Select the copy button next to the Primary key.

         

6. Now, on the Connect page of wizard, for Consumer group, enter the name of the consumer group. By default, $Default is selected, which is the default consumer group for the IoT hub.

7. For Data format, select a data format of the incoming real-time events that you want to get from your Azure IoT hub. You can select from JSON, Avro, and CSV data formats, and then select Connect.

8. Select Next at the bottom of the page.

   

9. On the Review and create page, review settings, and select Add.

   

You see that the Azure IoT Hub source is added to your eventstream on the canvas in the Edit mode. To implement this newly added Azure IoT hub, select Publish on the ribbon.

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

Related content

To learn how to add other sources to an eventstream, see the following articles:

• Amazon Kinesis Data Streams
• Azure Cosmos DB
• Azure SQL Database Change Data Capture (CDC)
• Azure Event Hubs
• Confluent Kafka
• Custom endpoint
• Google Cloud Pub/Sub
• MySQL Database CDC
• PostgreSQL Database CDC
• Sample data
• Azure Blob Storage events
• Fabric workspace event

Prerequisites

Before you start, you must complete the following prerequisites:

• Get access to a premium workspace with Contributor or above permissions where your eventstream is located.
• You need to have appropriate permission to get IoT hub's access keys. The IoT hub must be publicly accessible and not behind a firewall or secured in a virtual network.

Note

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

Add an Azure IoT hub as a source

Follow these steps to add an Azure IoT hub as your eventstream source:

1. In the Eventstream editor, expand the New source drop-down menu within the node and choose Azure IoT Hub.

   

2. On the Azure IoT Hub configuration pane, enter the following details:

   

   1. Source name: Enter a name for your Azure IoT Hub, such as iothub-source.

   2. Cloud connection: Select an existing cloud connection that links your Azure IoT Hub to Microsoft Fabric. If you don't have one, proceed to step 3 to create a new cloud connection.

   3. Data format. Choose a data format (AVRO, JSON, or CSV) for streaming your IoT Hub data into the eventstream.

   4. Consumer group. Choose a consumer group from your Azure IoT Hub, or leave it as $Default. Then select Add to finish the Azure IoT Hub configuration.

   5. Once it's added successfully, you can see an Azure IoT Hub source added to your eventstream in the editor.

      

3. To create a new cloud connection for your Azure IoT Hub, follow these steps:

   

   1. Select Create new connection from the drop-down menu, fill in the Connection settings and Connection credentials of your Azure IoT Hub, and then select Create.

      

   2. IoT Hub. Enter the name of the IoT Hub in the Azure portal.

   3. Connection name. Enter a name for the new cloud connection, such as iothub-connection.

   4. Shared access key name and Shared access key. Enter the connection credentials for your Azure IoT Hub. You can find it under Shared access policies in the Azure portal. You must have appropriate permissions to access any of the IoT Hub endpoints.

      

   5. Return to the Azure IoT Hub configuration pane and select Refresh to load the new cloud connection.

      

Once the Azure IoT Hub is added to your eventstream, select Preview data to verify successful configuration. You should be able to preview incoming data to your eventstream.

Related content

To learn how to add other sources to an eventstream, see the following articles:

• Azure Event Hubs
• Sample data
• Custom app