Skip to content

Commit f928feb

Browse files
Merge pull request #2719 from MicrosoftDocs/main638918436641822294sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents 36bf1e9 + 1650892 commit f928feb

File tree

4 files changed

+35
-35
lines changed

4 files changed

+35
-35
lines changed

data-explorer/create-event-hubs-connection.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: 'Create an Event Hubs data connection - Azure Data Explorer'
33
description: Learn how to ingest data from Event Hubs into Azure Data Explorer.
44
ms.topic: how-to
55
ms.custom:
6-
ms.date: 08/04/2025
6+
ms.date: 08/26/2025
77
---
88

99
# 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
1212

1313
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).
1414

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).
1616

1717
> For code samples based on previous SDK versions, see the [archived article](/previous-versions/azure/data-explorer/create-event-hubs-connection).
1818
1919
> [!WARNING]
2020
>
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.
2222
2323
## Create an event hub data connection
2424

@@ -53,7 +53,7 @@ Select the data source from the available list. In this example, you're ingestin
5353
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.
5454

5555
> [!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.
5757
5858
:::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":::
5959

@@ -139,11 +139,11 @@ In the **Data preparation** window, all three steps are marked with green check
139139
| Event hub | *test-hub* | The event hub you created. |
140140
| Consumer group | *test-group* | The consumer group defined in the event hub you created. |
141141
| 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`.|
143143
| 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. |
144144

145145
> [!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.
147147
148148
### [Portal - Azure Event Hubs page](#tab/portalEH)
149149

@@ -161,15 +161,15 @@ In the **Data preparation** window, all three steps are marked with green check
161161
1. Under the **Features** side menu, select **Analyze data with Kusto**.
162162
1. Select **Start** to open the ingestion wizard to Azure Data Explorer.
163163

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":::
165165

166166
> [!NOTE]
167167
>
168168
> * You must have at least [Database User](/kusto/access-control/role-based-access-control?view=azure-data-explorer&preserve-view=true) permissions.
169169
> * 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).
170170
> * 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.
171171
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.
173173

174174
1. Under **Table**, select **New table** and enter a name for the new table. Alternatively, use an **Existing table**.
175175

@@ -351,7 +351,7 @@ Remove the data connection through the Azure portal as explained in the portal t
351351

352352
### [Portal](#tab/portal-2)
353353

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:
355355

356356
1. Go to your cluster. From the left menu, select **Databases**. Then, select the database that contains the target table.
357357
1. From the left menu, select **Data connections**. Then, select the checkbox next to the relevant event hub data connection.

data-explorer/create-iot-hub-connection-sdk.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@
22
title: 'Create an IoT Hub data connection with SDKs - Azure Data Explorer'
33
description: 'In this article, you learn how to ingest data into Azure Data Explorer from IoT Hub using SDKs.'
44
ms.topic: how-to
5-
ms.date: 07/16/2023
5+
ms.date: 08/26/2025
66
---
77

88
# Create an IoT Hub data connection for Azure Data Explorer with SDKs
99

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.
1111

1212
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).
1313

@@ -28,13 +28,13 @@ For general information about ingesting into Azure Data Explorer from IoT Hub, s
2828

2929
## Create an IoT Hub data connection
3030

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.
3232

3333
### [C#](#tab/c-sharp)
3434

3535
1. Install the [Microsoft.Azure.Management.Kusto NuGet package](https://www.nuget.org/packages/Microsoft.Azure.Management.Kusto/).
3636

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.
3838

3939
1. Run the following code.
4040

@@ -101,7 +101,7 @@ In this section, you'll establish a connection between the IoT Hub and your Azur
101101
pip install azure-mgmt-kusto
102102
```
103103

104-
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.
104+
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.
105105

106106
1. Run the following code.
107107

0 commit comments

Comments
 (0)