Skip to content

Commit c1b7cf0

Browse files
committed
Add suggested fixes
1 parent 59f4b65 commit c1b7cf0

File tree

1 file changed

+23
-14
lines changed

1 file changed

+23
-14
lines changed

articles/iot-operations/connect-to-cloud/howto-configure-data-lake.md

Lines changed: 23 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,8 @@ Configure a data lake connector to connect to Microsoft Fabric OneLake using man
5353

5454
1. Ensure that IoT MQ Arc extension is installed and configured with managed identity.
5555

56+
1. In Azure portal, go to the Arc-connected Kubernetes cluster and select **Settings** > **Extensions**. In the extension list, look for your IoT MQ extension name. The name begins with `mq-` followed by five random characters. For example, *mq-4jgjs*.
57+
5658
1. Get the *app ID* associated to the IoT MQ Arc extension managed identity, and note down the GUID value. The *app ID* is different than the object or principal ID. You can use the Azure CLI by finding the object ID of the managed identity and then querying the app ID of the service principal associated to the managed identity. For example:
5759

5860
```bash
@@ -223,7 +225,7 @@ authentication:
223225
224226
Configure the data lake connector to send data to an Azure Data Explorer endpoint using managed identity.
225227
226-
### Deploy an Azure Data Explorer cluster
228+
1. To deploy an Azure Data Explorer cluster, follow the **Full cluster** steps in the [Quickstart: Create an Azure Data Explorer cluster and database](/azure/data-explorer/create-cluster-database-portal&tabs=full).
227229
228230
1. To deploy an Azure Data Explorer cluster, follow the **Full cluster** steps in the [Quickstart: Create an Azure Data Explorer cluster and database](/azure/data-explorer/create-cluster-database-portal).
229231
@@ -232,14 +234,14 @@ Configure the data lake connector to send data to an Azure Data Explorer endpoin
232234
1. You can create a table for given data via the Azure portal and create columns manually, or you can use [KQL](/azure/data-explorer/kusto/management/create-table-command) in the query tab.
233235
234236
For example:
235-
236-
```kql
237237
.create table thermostat (
238238
externalAssetId: string,
239239
assetName: string,
240-
currentTemperature: real,
241-
pressure: real,
242-
mqttTopic: string,
240+
CurrentTemperature: real,
241+
Pressure: real,
242+
MqttTopic: string,
243+
Timestamp: datetime
244+
)
243245
timestamp: datetime
244246
)
245247
```
@@ -267,7 +269,7 @@ Deploy the broker as an ARC extension so that you get managed identity support.
267269
268270
In order for the connector to authenticate to Azure Data Explorer, you must add the managed identity to the Azure Data Explorer cluster.
269271
270-
1. In Azure portal, go to the Arc-connected Kubernetes cluster and select **Settings** > **Extensions**. In the extension list, look for the name of your MQ extension. The name begins with `mq-` followed by five random characters. For example, *mq-4jgjs*. The MQ extension name is the same as the MQ managed identity name.
272+
1. In Azure portal, go to the Arc-connected Kubernetes cluster and select **Settings** > **Extensions**. In the extension list, look for the name of your IoT MQ extension. The name begins with `mq-` followed by five random characters. For example, *mq-4jgjs*. The IoT MQ extension name is the same as the MQ managed identity name.
271273
1. In your Azure Data Explorer database, select **Permissions** > **Add** > **Ingestor**. Search for the MQ managed identity name and add it.
272274
273275
For more information on adding permissions, see [Manage Azure Data Explorer cluster permissions](/azure/data-explorer/manage-cluster-permissions).
@@ -280,31 +282,38 @@ Example deployment file for the Azure Data Explorer connector. Comments that beg
280282

281283
```yaml
282284
apiVersion: mq.iotoperations.azure.com/v1beta1
283-
kind: DataLakeConnector
284-
metadata:
285+
name: my-adx-connector
286+
namespace: azure-iot-operations
285287
name: my-datalake-connector
286288
namespace: mq
287289
spec:
288-
protocol: v5
289-
image:
290+
repository: mcr.microsoft.com/azureiotoperations/datalake
291+
tag: 0.4.0-preview
290292
repository: edgebuilds.azurecr.io/datalake
291293
tag: edge
292294
pullPolicy: Always
293295
instances: 1
294296
logLevel: "debug"
295297
databaseFormat: "adx"
296298
target:
297-
adx:
299+
endpoint: https://<cluster>.<region>.kusto.windows.net
298300
# TODO: insert the ADX cluster endpoint formatted as <cluster>.<region>.kusto.windows.net
299301
endpoint: "<endpoint>"
300302
authentication:
301-
systemAssignedManagedIdentity:
303+
localBrokerConnection:
304+
endpoint: aio-mq-dmqtt-frontend:8883
305+
tls:
306+
tlsEnabled: true
307+
name: adx-topicmap
308+
authentication:
309+
kubernetes: {}
310+
dataLakeConnectorRef: my-adx-connector
302311
audience: "https://api.kusto.windows.net"
303312
---
304313
apiVersion: mq.iotoperations.azure.com/v1beta1
305314
kind: DataLakeConnectorTopicMap
306315
metadata:
307-
name: datalake-topicmap
316+
mqttSourceTopic: "azure-iot-operations/data/thermostat"
308317
namespace: azure-iot-operations
309318
spec:
310319
dataLakeConnectorRef: "my-datalake-connector"

0 commit comments

Comments
 (0)