You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: data-explorer/create-event-hubs-connection.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: 'Create an Event Hubs data connection - Azure Data Explorer'
3
3
description: Learn how to ingest data from Event Hubs into Azure Data Explorer.
4
4
ms.topic: how-to
5
5
ms.custom:
6
-
ms.date: 08/04/2025
6
+
ms.date: 08/26/2025
7
7
---
8
8
9
9
# Create an Event Hubs data connection for Azure Data Explorer
@@ -12,13 +12,13 @@ Azure Data Explorer offers ingestion from [Event Hubs](/azure/event-hubs/event-h
12
12
13
13
In this article, you connect to an event hub and ingest data into Azure Data Explorer. For an overview on ingesting from Event Hubs, see [Azure Event Hubs data connection](ingest-data-event-hub-overview.md).
14
14
15
-
To learn how to create the connection using the Kusto SDKs, see [Create an Event Hubs data connection with SDKs](create-event-hubs-connection-sdk.md).
15
+
To learn how to create the connection using the Kusto software developer kits (SDKs), see [Create an Event Hubs data connection with SDKs](create-event-hubs-connection-sdk.md).
16
16
17
17
> For code samples based on previous SDK versions, see the [archived article](/previous-versions/azure/data-explorer/create-event-hubs-connection).
18
18
19
19
> [!WARNING]
20
20
>
21
-
> The Get Data Wizard doesn't support creating a data connection to Event Hubs through [private endpoints](security-network-private-endpoint.md) or [managed private endpoints](security-network-private-endpoint.md#managed-private-endpoints). To create a data connection from the Azure Portal, follow the instructions in the **Portal - Azure Event Hubs page** tab.
21
+
> The Get Data Wizard doesn't support creating a data connection to Event Hubs through [private endpoints](security-network-private-endpoint.md) or [managed private endpoints](security-network-private-endpoint.md#managed-private-endpoints). To create a data connection from the Azure portal, follow the instructions in the **Portal - Azure Event Hubs page** tab.
22
22
23
23
## Create an event hub data connection
24
24
@@ -53,7 +53,7 @@ Select the data source from the available list. In this example, you're ingestin
53
53
1. Select a target database and table. If you want to ingest data into a new table, select **+ New table** and enter a table name.
54
54
55
55
> [!NOTE]
56
-
> Table names can be up to 1024 characters including spaces, alphanumeric, hyphens, and underscores. Special characters aren't supported.
56
+
> Table names can be up to 1,024 characters including spaces, alphanumeric, hyphens, and underscores. Special characters aren't supported.
57
57
58
58
:::image type="content" source="media/get-data-event-hubs/configure-tab.png" alt-text="Screenshot of configure tab with fields for configuring the data source of Event Hubs in Azure Data Explorer." lightbox="media/get-data-event-hubs/configure-tab.png":::
59
59
@@ -139,11 +139,11 @@ In the **Data preparation** window, all three steps are marked with green check
139
139
| Event hub |*test-hub*| The event hub you created. |
140
140
| Consumer group |*test-group*| The consumer group defined in the event hub you created. |
141
141
| Event system properties | Select relevant properties | The [event hub system properties](/azure/service-bus-messaging/service-bus-amqp-protocol-guide#message-annotations). If there are multiple records per event message, the system properties are added to the first record. When adding system properties, [create](/kusto/management/create-table-command?view=azure-data-explorer&preserve-view=true) or [update](/kusto/management/alter-table-command?view=azure-data-explorer&preserve-view=true) table schema and [mapping](/kusto/management/mappings?view=azure-data-explorer&preserve-view=true) to include the selected properties. |
142
-
| Compression |*None*| The compression type of the event hub messages payload. Supported compression types: *None, gzip*.|
142
+
| Compression |*None*| The compression type of the event hub messages payload. Supported compression types: `None`, `gzip`.|
143
143
| Managed Identity (recommended) | System-assigned | The managed identity used by the Data Explorer cluster for access to read from the event hub. We recommend using managed identities to control access to your event hub.<br /><br />**Note**:<br />When the data connection is created:<br/>\**System-assigned* identities are automatically created if they don't exist<br />\* The managed identity is automatically assigned the *Azure Event Hubs Data Receiver* role and is added to your Data Explorer cluster. We recommend verifying that the role was assigned and that the identity was added to the cluster. |
144
144
145
145
> [!NOTE]
146
-
> If you have an existing data connection that is not using managed identities, we recommend updating it to use managed identities.
146
+
> If you have an existing data connection that isn't using managed identities, we recommend updating it to use managed identities.
@@ -161,15 +161,15 @@ In the **Data preparation** window, all three steps are marked with green check
161
161
1. Under the **Features** side menu, select **Analyze data with Kusto**.
162
162
1. Select **Start** to open the ingestion wizard to Azure Data Explorer.
163
163
164
-
:::image type="content" source="media/create-event-hubs-connection/access-from-portal-event-hubs.png" alt-text="Screenshot of the Azure portal with the analyze data with Kusto feature selected." lightbox="media/create-event-hubs-connection/access-from-portal-event-hubs.png":::
164
+
:::image type="content" source="media/create-event-hubs-connection/access-from-portal-event-hubs.png" alt-text="Screenshot of the Azure portal with the Analyze data with Kusto feature selected." lightbox="media/create-event-hubs-connection/access-from-portal-event-hubs.png":::
165
165
166
166
> [!NOTE]
167
167
>
168
168
> * You must have at least [Database User](/kusto/access-control/role-based-access-control?view=azure-data-explorer&preserve-view=true) permissions.
169
169
> * To enable access between a cluster and a storage account without public access, see [Create a Managed Private Endpoint](security-network-private-endpoint-create.md).
170
170
> * The cluster and event hub should be associated with the same tenants. If not, use one of the SDK options, such as C# or Python.
171
171
172
-
1. The **Ingest data** side pane opens with the **Destination** tab selected. Select the **Cluster** and **Database** fields from the dropdowns. Make sure you select a cluster that is running. Otherwise, you won't be able to select Database and proceed with the ingestion process.
172
+
1. The **Ingest data** side pane opens with the **Destination** tab selected. Select the **Cluster** and **Database** fields from the dropdowns. Make sure you select a cluster that is running. Otherwise, you can't select Database and proceed with the ingestion process.
173
173
174
174
1. Under **Table**, select **New table** and enter a name for the new table. Alternatively, use an **Existing table**.
175
175
@@ -351,7 +351,7 @@ Remove the data connection through the Azure portal as explained in the portal t
351
351
352
352
### [Portal](#tab/portal-2)
353
353
354
-
To remove the event hub connection from the Azure portal, do the following:
354
+
To remove the event hub connection from the Azure portal, do the following steps:
355
355
356
356
1. Go to your cluster. From the left menu, select **Databases**. Then, select the database that contains the target table.
357
357
1. From the left menu, select **Data connections**. Then, select the checkbox next to the relevant event hub data connection.
Copy file name to clipboardExpand all lines: data-explorer/create-iot-hub-connection-sdk.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,12 +2,12 @@
2
2
title: 'Create an IoT Hub data connection with SDKs - Azure Data Explorer'
3
3
description: 'In this article, you learn how to ingest data into Azure Data Explorer from IoT Hub using SDKs.'
4
4
ms.topic: how-to
5
-
ms.date: 07/16/2023
5
+
ms.date: 08/26/2025
6
6
---
7
7
8
8
# Create an IoT Hub data connection for Azure Data Explorer with SDKs
9
9
10
-
This article shows you how to ingest data into Azure Data Explorer from IoT Hub, a big data streaming platform and IoT ingestion service.
10
+
This article shows you how to ingest data into Azure Data Explorer from IoT Hub, a big data streaming platform, and IoT ingestion service.
11
11
12
12
To learn how to create the connection using the Kusto SDKs, see [Create an IoT Hub data connection with SDKs](create-iot-hub-connection-sdk.md).
13
13
@@ -28,13 +28,13 @@ For general information about ingesting into Azure Data Explorer from IoT Hub, s
28
28
29
29
## Create an IoT Hub data connection
30
30
31
-
In this section, you'll establish a connection between the IoT Hub and your Azure Data Explorer table. As long as this connection is in place, data is transmitted from the IoT Hub into your target table.
31
+
In this section, you establish a connection between the IoT Hub and your Azure Data Explorer table. As long as this connection is in place, data is transmitted from the IoT Hub into your target table.
32
32
33
33
### [C#](#tab/c-sharp)
34
34
35
35
1. Install the [Microsoft.Azure.Management.Kusto NuGet package](https://www.nuget.org/packages/Microsoft.Azure.Management.Kusto/).
36
36
37
-
1.[Create a Microsoft Entra application principal](/azure/active-directory/develop/howto-create-service-principal-portal) to use for authentication. You'll need the directory (tenant) ID, application ID, and client secret.
37
+
1.[Create a Microsoft Entra application principal](/azure/active-directory/develop/howto-create-service-principal-portal) to use for authentication. You need the directory (tenant) ID, application ID, and client secret.
38
38
39
39
1. Run the following code.
40
40
@@ -101,7 +101,7 @@ In this section, you'll establish a connection between the IoT Hub and your Azur
101
101
pipinstallazure-mgmt-kusto
102
102
```
103
103
104
-
1. [CreateaMicrosoftEntraapplicationprincipal](/azure/active-directory/develop/howto-create-service-principal-portal) tousefor authentication. You'll need the directory (tenant) ID, applicationID, andclientsecret.
104
+
1. [CreateaMicrosoftEntraapplicationprincipal](/azure/active-directory/develop/howto-create-service-principal-portal) tousefor authentication. You need the directory (tenant) ID, applicationID, andclientsecret.
0 commit comments