Skip to content

Commit b5cd42e

Browse files
authored
Merge pull request #185013 from baanders/1-13-space
ADT: Standardize spaces
2 parents eb51ea0 + e7f0a01 commit b5cd42e

6 files changed

+23
-23
lines changed

articles/digital-twins/concepts-data-explorer-plugin.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -82,36 +82,36 @@ There are various ways to ingest IoT data into Azure Data Explorer. Here are two
8282
8383
If you're ingesting time series data directly into Azure Data Explorer, you'll likely need to convert this raw time series data into a schema suitable for joint Azure Digital Twins/Azure Data Explorer queries.
8484
85-
An [update policy](/azure/data-explorer/kusto/management/updatepolicy)in Azure Data Explorer allows you to automatically transform and append data to a target table whenever new data is inserted into a source table.
85+
An [update policy](/azure/data-explorer/kusto/management/updatepolicy) in Azure Data Explorer allows you to automatically transform and append data to a target table whenever new data is inserted into a source table.
8686
8787
You can use an update policy to enrich your raw time series data with the corresponding **twin ID** from Azure Digital Twins, and persist it to a target table. Using the twin ID, the target table can then be joined against the digital twins selected by the Azure Digital Twins plugin.
8888
8989
For example, say you created the following table to hold the raw time series data flowing into your Azure Data Explorer instance.
9090
9191
```kusto
92-
.create-mergetablerawData(Timestamp:datetime,someId:string,Value:string,ValueType:string)
92+
.create-merge table rawData (Timestamp:datetime, someId:string, Value:string, ValueType:string)
9393
```
9494
9595
You could create a mapping table to relate time series IDs with twin IDs, and other optional fields.
9696
9797
```kusto
98-
.create-mergetablemappingTable(someId:string,twinId:string,otherMetadata:string)
98+
.create-merge table mappingTable (someId:string, twinId:string, otherMetadata:string)
9999
```
100100
101101
Then, create a target table to hold the enriched time series data.
102102
103103
```kusto
104-
.create-mergetabletimeseriesSilver(twinId:string,Timestamp:datetime,someId:string,otherMetadata:string,ValueNumeric:real,ValueString:string)
104+
.create-merge table timeseriesSilver (twinId:string, Timestamp:datetime, someId:string, otherMetadata:string, ValueNumeric:real, ValueString:string)
105105
```
106106
107107
Next, create a function `Update_rawData` to enrich the raw data by joining it with the mapping table. Doing so will add the twin ID to the resulting target table.
108108
109109
```kusto
110-
.create-or-alterfunctionwith(folder = "Update",skipvalidation = "true")Update_rawData() {
110+
.create-or-alter function with (folder = "Update", skipvalidation = "true") Update_rawData() {
111111
rawData
112-
|joinkind=leftoutermappingTable on someId
113-
|project
114-
    Timestamp,ValueNumeric = toreal(Value),ValueString = Value, ...
112+
| join kind=leftouter mappingTable on someId
113+
| project
114+
Timestamp, ValueNumeric = toreal(Value), ValueString = Value, ...
115115
}
116116
```
117117
@@ -128,9 +128,9 @@ Once the target table is created, you can use the Azure Digital Twins plugin to
128128
129129
Here's an example of a schema that might be used to represent shared data.
130130

131-
| timestamp | twinId| modelId| name| value| relationshipTarget | relationshipID |
131+
| timestamp | twinId | modelId | name | value | relationshipTarget | relationshipID |
132132
| --- | --- | --- | --- | --- | --- | --- |
133-
| 2021-02-0117:24| ConfRoomTempSensor| dtmi:com:example:TemperatureSensor;1| temperature| 301.0| | |
133+
| 2021-02-01 17:24 | ConfRoomTempSensor | dtmi:com:example:TemperatureSensor;1 | temperature | 301.0 | | |
134134

135135
Digital twin properties are stored as key-value pairs (`name, value`). `name` and `value` are stored as dynamic data types.
136136

articles/digital-twins/concepts-ontologies-adopt.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,9 +31,9 @@ Each ontology is focused on an initial set of models. The ontology authors welco
3131

3232
*Get the ontology from the following repository:* [Digital Twins Definition Language-based RealEstateCore ontology for smart buildings](https://github.com/Azure/opendigitaltwins-building).
3333

34-
Microsoft has partnered with [RealEstateCore](https://www.realestatecore.io/) to deliver thisopen-sourceDTDL ontology for the real estate industry. [RealEstateCore](https://www.realestatecore.io/) is a Swedish consortium of real estate owners, software vendors, and research institutions.
34+
Microsoft has partnered with [RealEstateCore](https://www.realestatecore.io/) to deliver this open-source DTDL ontology for the real estate industry. [RealEstateCore](https://www.realestatecore.io/) is a Swedish consortium of real estate owners, software vendors, and research institutions.
3535

36-
This smart buildings ontology provides common ground for modeling smart buildings, using industry standards (like[BRICK Schema](https://brickschema.org/ontology/) or[W3C Building Topology Ontology](https://w3c-lbd-cg.github.io/bot/index.html)) to avoid reinvention. The ontology also comes with best practices for how to consume and properly extend it.
36+
This smart buildings ontology provides common ground for modeling smart buildings, using industry standards (like [BRICK Schema](https://brickschema.org/ontology/) or [W3C Building Topology Ontology](https://w3c-lbd-cg.github.io/bot/index.html)) to avoid reinvention. The ontology also comes with best practices for how to consume and properly extend it.
3737

3838
To learn more about the ontology's structure and modeling conventions, how to use it, how to extend it, and how to contribute, visit the ontology's repository on GitHub: [Azure/opendigitaltwins-building](https://github.com/Azure/opendigitaltwins-building).
3939

articles/digital-twins/concepts-ontologies-convert.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ The following C# code snippet shows how an RDF model file is loaded into a graph
4444

4545
### RDF converter application
4646

47-
There's a sample application available that converts an RDF-based model file to [DTDL (version 2)](https://github.com/Azure/opendigitaltwins-dtdl/blob/master/DTDL/v2/dtdlv2.md) for use by theAzure Digital Twinsservice. It has been validated for the [Brick](https://brickschema.org/ontology/) schema, and can be extended for other schemas in the building industry (such as [Building Topology Ontology (BOT)](https://w3c-lbd-cg.github.io/bot/), [Semantic Sensor Network](https://www.w3.org/TR/vocab-ssn/), or [buildingSmart Industry Foundation Classes (IFC)](https://technical.buildingsmart.org/standards/ifc/ifc-schema-specifications/)).
47+
There's a sample application available that converts an RDF-based model file to [DTDL (version 2)](https://github.com/Azure/opendigitaltwins-dtdl/blob/master/DTDL/v2/dtdlv2.md) for use by the Azure Digital Twins service. It has been validated for the [Brick](https://brickschema.org/ontology/) schema, and can be extended for other schemas in the building industry (such as [Building Topology Ontology (BOT)](https://w3c-lbd-cg.github.io/bot/), [Semantic Sensor Network](https://www.w3.org/TR/vocab-ssn/), or [buildingSmart Industry Foundation Classes (IFC)](https://technical.buildingsmart.org/standards/ifc/ifc-schema-specifications/)).
4848

4949
The sample is a [.NET Core command-line application called RdfToDtdlConverter](/samples/azure-samples/rdftodtdlconverter/digital-twins-model-conversion-samples/).
5050

articles/digital-twins/concepts-security.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -89,11 +89,11 @@ If a user attempts to perform an action not allowed by their role, they may rece
8989

9090
## Managed identity for accessing other resources
9191

92-
Setting up an [Azure Active Directory (Azure AD)](../active-directory/fundamentals/active-directory-whatis.md) **managed identity** for an Azure Digital Twins instance can allow the instance to easily access other Azure AD-protected resources, such as [Azure Key Vault](../key-vault/general/overview.md). The identity is managed by the Azure platform, and doesn't require you to provision or rotate any secrets. For more about managed identities in Azure AD, see[Managed identities for Azure resources](../active-directory/managed-identities-azure-resources/overview.md).
92+
Setting up an [Azure Active Directory (Azure AD)](../active-directory/fundamentals/active-directory-whatis.md) **managed identity** for an Azure Digital Twins instance can allow the instance to easily access other Azure AD-protected resources, such as [Azure Key Vault](../key-vault/general/overview.md). The identity is managed by the Azure platform, and doesn't require you to provision or rotate any secrets. For more about managed identities in Azure AD, see [Managed identities for Azure resources](../active-directory/managed-identities-azure-resources/overview.md).
9393

9494
Azure supports two types of managed identities: system-assigned and user-assigned. Currently, Azure Digital Twins supports only **system-assigned identities**.
9595

96-
You can use a system-assigned managed identity for your Azure Digital Instance to authenticate to a [custom-defined endpoint](concepts-route-events.md#create-an-endpoint). Azure Digital Twins supports system-assigned identity-based authentication to endpoints for [Event Hubs](../event-hubs/event-hubs-about.md) and[Service Bus](../service-bus-messaging/service-bus-messaging-overview.md)destinations, andto an [Azure Storage Container](../storage/blobs/storage-blobs-introduction.md)endpoint for [dead-letter events](concepts-route-events.md#dead-letter-events). [Event Grid](../event-grid/overview.md)endpoints are currently not supported for managed identities.
96+
You can use a system-assigned managed identity for your Azure Digital Instance to authenticate to a [custom-defined endpoint](concepts-route-events.md#create-an-endpoint). Azure Digital Twins supports system-assigned identity-based authentication to endpoints for [Event Hubs](../event-hubs/event-hubs-about.md) and [Service Bus](../service-bus-messaging/service-bus-messaging-overview.md) destinations, and to an [Azure Storage Container](../storage/blobs/storage-blobs-introduction.md) endpoint for [dead-letter events](concepts-route-events.md#dead-letter-events). [Event Grid](../event-grid/overview.md) endpoints are currently not supported for managed identities.
9797

9898
For instructions on how to enable a system-managed identity for Azure Digital Twins and use it to route events, see [Route events with a managed identity](how-to-route-with-managed-identity.md).
9999

@@ -114,17 +114,17 @@ For instructions on how to set up Private Link for Azure Digital Twins, see [Ena
114114
### Design considerations
115115

116116
When working with Private Link for Azure Digital Twins, here are some factors you may want to consider:
117-
* **Pricing**: For pricing details, see[Azure Private Link pricing](https://azure.microsoft.com/pricing/details/private-link).
117+
* **Pricing**: For pricing details, see [Azure Private Link pricing](https://azure.microsoft.com/pricing/details/private-link).
118118
* **Regional availability**: For Azure Digital Twins, this feature is available in all the Azure regions where Azure Digital Twins is available.
119119
* **Maximum number of private endpoints per Azure Digital Twins instance**: 10
120120

121-
For information on the limits of Private Link, see[Azure Private Link documentation: Limitations](../private-link/private-link-service-overview.md#limitations).
121+
For information on the limits of Private Link, see [Azure Private Link documentation: Limitations](../private-link/private-link-service-overview.md#limitations).
122122

123123
## Service tags
124124

125-
A **service tag** represents a group of IP address prefixes from a given Azure service. Microsoft manages the address prefixes encompassed by the service tag and automatically updates the service tag as addresses change, minimizing the complexity of frequent updates to network security rules. For more information about service tags, see[Virtual network tags](../virtual-network/service-tags-overview.md).
125+
A **service tag** represents a group of IP address prefixes from a given Azure service. Microsoft manages the address prefixes encompassed by the service tag and automatically updates the service tag as addresses change, minimizing the complexity of frequent updates to network security rules. For more information about service tags, see [Virtual network tags](../virtual-network/service-tags-overview.md).
126126

127-
You can use service tags to define network access controls on[network security groups](../virtual-network/network-security-groups-overview.md#security-rules) or [Azure Firewall](../firewall/service-tags.md), by using service tags in place of specific IP addresses when you create security rules. By specifying the service tag name (in this case,**AzureDigitalTwins**) in the appropriate*source* or *destination*field of a rule, you can allow or deny the traffic for the corresponding service.
127+
You can use service tags to define network access controls on [network security groups](../virtual-network/network-security-groups-overview.md#security-rules) or [Azure Firewall](../firewall/service-tags.md), by using service tags in place of specific IP addresses when you create security rules. By specifying the service tag name (in this case, **AzureDigitalTwins**) in the appropriate *source* or *destination* field of a rule, you can allow or deny the traffic for the corresponding service.
128128

129129
Below are the details of the **AzureDigitalTwins** service tag.
130130

articles/digital-twins/how-to-route-with-managed-identity.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ ms.custom: subject-rbac-steps, contperf-fy21q4
1818

1919
# Enable a managed identity for routing Azure Digital Twins events
2020

21-
This article describes how to enable a [system-assigned identity for an Azure Digital Twins instance](concepts-security.md#managed-identity-for-accessing-other-resources), and use the identity when forwarding events to supported routing destinations. Setting up a managed identity isn't required for routing, but it can help the instance to easily access other Azure AD-protected resources, such as [Event Hubs](../event-hubs/event-hubs-about.md), [Service Bus](../service-bus-messaging/service-bus-messaging-overview.md)destinations, and [Azure Storage Container](../storage/blobs/storage-blobs-introduction.md).
21+
This article describes how to enable a [system-assigned identity for an Azure Digital Twins instance](concepts-security.md#managed-identity-for-accessing-other-resources), and use the identity when forwarding events to supported routing destinations. Setting up a managed identity isn't required for routing, but it can help the instance to easily access other Azure AD-protected resources, such as [Event Hubs](../event-hubs/event-hubs-about.md), [Service Bus](../service-bus-messaging/service-bus-messaging-overview.md) destinations, and [Azure Storage Container](../storage/blobs/storage-blobs-introduction.md).
2222

2323
Here are the steps that are covered in this article:
2424

@@ -208,5 +208,5 @@ To continue using an endpoint that was set up with a managed identity that's now
208208

209209
## Next steps
210210

211-
Learn more about managed identities in Azure AD:
211+
Learn more about managed identities in Azure AD:
212212
* [Managed identities for Azure resources](../active-directory/managed-identities-azure-resources/overview.md)

articles/digital-twins/reference-query-clause-match.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,15 +25,15 @@ This clause is optional while querying.
2525

2626
## Core syntax: MATCH
2727

28-
`MATCH` supports any query thatfinds a path between twins with an unpredictable number of hops, based on certain relationship conditions.
28+
`MATCH` supports any query that finds a path between twins with an unpredictable number of hops, based on certain relationship conditions.
2929

3030
The **relationship condition** can include one or more of the following details:
3131
* [Relationship direction](#specify-relationship-direction) (left-to-right, right-to-left, or non-directional)
3232
* [relationship name](#specify-relationship-name) (single name or a list of possibilities)
3333
* [Number of "hops"](#specify-number-of-hops) from one twin to another (exact number or range)
3434
* [A query variable assignment](#assign-query-variable-to-relationship-and-specify-relationship-properties) to represent the relationship within the query text. This will also allow you to filter on relationship properties.
3535

36-
A query with a `MATCH`clause must also use the[WHERE clause](reference-query-clause-where.md) to specify the `$dtId` for at least one of the twins it references.
36+
A query with a `MATCH` clause must also use the [WHERE clause](reference-query-clause-where.md) to specify the `$dtId` for at least one of the twins it references.
3737

3838
>[!NOTE]
3939
>`MATCH` is a superset of all `JOIN` queries that can be performed in the query store.

0 commit comments

Comments
 (0)