Skip to content

Commit 1877981

Browse files
Learn Editor: Update query-twins.md
1 parent 590b825 commit 1877981

File tree

1 file changed

+5
-2
lines changed

1 file changed

+5
-2
lines changed

articles/iot-hub/query-twins.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -185,17 +185,20 @@ SELECT * FROM devices.modules
185185
## Twin query limitations
186186

187187
> [!IMPORTANT]
188-
> Query results can have a few minutes of delay with respect to the latest values in device twins. If querying individual device twins by ID, use the [get twin REST API](/java/api/com.microsoft.azure.sdk.iot.device.devicetwin). This API always returns the latest values and has higher throttling limits. You can issue the REST API directly or use the equivalent functionality in one of the [Azure IoT Hub Service SDKs](iot-hub-devguide-sdks.md#azure-iot-hub-service-sdks).
188+
> Query results are eventually consistent operations and delays of up to 30 minutes should be tolerated. In most instances, twin query returns results in the order of a few seconds.
189+
190+
An alternative option to twin queries is to use query individual device twins by ID, use the [get twin REST API](/java/api/com.microsoft.azure.sdk.iot.device.devicetwin). This API always returns the latest values and has higher throttling limits. You can issue the REST API directly or use the equivalent functionality in one of the [Azure IoT Hub Service SDKs](iot-hub-devguide-sdks.md#azure-iot-hub-service-sdks).
189191

190192
Query expressions can have a maximum length of 8192 characters.
191193

192194
Currently, comparisons are supported only between primitive types (no objects), for instance `... WHERE properties.desired.config = properties.reported.config` is supported only if those properties have primitive values.
193195

194196

195197
> [!Note]
196-
> We recommend to not take a dependency on lastActivityTime found in Device Identity Properties for Twin Queries for any scenario. We do not prioritize the update of this field to accurately gauge device status. Instead, please use IoT Device Lifecycle events to manage device state and activities
198+
> We recommend to not take a dependency on lastActivityTime found in Device Identity Properties for Twin Queries for any scenario. This field does not guarantee an accurate gauge of device status. Instead, please use IoT Device Lifecycle events to manage device state and activities
197199
198200
## Next steps
199201

200202
* Understand the basics of the [IoT Hub query language](iot-hub-devguide-query-language.md)
201203

204+

0 commit comments

Comments
 (0)