Procedimientos recomendados para elegir un identificador de serie temporal
Nota
El servicio Time Series Insights se retirará el 7 de julio de 2024. Considere la posibilidad de migrar entornos existentes a soluciones alternativas lo antes posible. Para obtener más información sobre la obsolescencia y la migración, visite nuestra documentación de .
En este artículo se resume la importancia del identificador de serie temporal para el entorno de Azure Time Series Insights Gen2 y los procedimientos recomendados para elegir uno.
Elegir un identificador de serie temporal
Seleccionar un identificador de serie temporal adecuado es fundamental. Elegir un identificador de serie temporal es como elegir una clave de partición para una base de datos. Es necesario al crear un entorno de Azure Time Series Insights Gen2.
Vea el tutorial de aprovisionamiento del entorno para obtener una explicación detallada del identificador de serie temporal. Verá dos ejemplos de carga de telemetría JSON diferentes y la selección correcta del identificador de serie temporal para cada uno.
Importante
Los identificadores de serie temporal son:
- Una propiedad de cadena sensible a mayúsculas y minúsculas: se utilizan letras y caracteres en búsquedas, comparaciones, actualizaciones y al particionar.
- Una propiedad inmutable: una vez creada, no se puede cambiar.
Propina
Si el origen del evento es un centro de IoT, es probable que el Identificador de Series Temporales sea iothub-connection-device-id. Si planea usar modelos de dispositivo IoT Plug and Play o usarlos sin componentes, debe incluir dt-subject como parte de la clave compuesta por si lo necesita en el futuro.
Entre los procedimientos recomendados clave que se deben seguir se incluyen:
- Elija una clave de partición con muchos valores distintos (por ejemplo, cientos o miles). En muchos casos, puede ser el identificador del dispositivo, el identificador del sensor o el identificador de etiqueta en el JSON.
- El identificador de serie temporal debe ser único en el nivel de hoja del nodo de tu modelo de serie temporal .
- El límite de caracteres de la cadena de nombre de propiedad del identificador de serie temporal es 128. Para el valor de propiedad del identificador de serie temporal, el límite de caracteres es 1024.
- Si falta un valor de propiedad único para el identificador de serie temporal, se trata como un valor NULL y sigue la misma regla de la restricción de unicidad.
- Si su identificación de serie temporal está anidada dentro de un objeto JSON complejo, asegúrese de seguir las reglas de aplanamiento de entrada cuando proporcione el nombre de su propiedad. Consulte el ejemplo B.
- También puede seleccionar hasta tres propiedades de clave como identificador de serie temporal. Su combinación será una clave compuesta que representa el identificador de serie temporal.
Nota
Las tres propiedades clave deben ser cadenas. Tendría que realizar una consulta con esta clave compuesta en lugar de una propiedad a la vez.
Seleccione más de una propiedad clave
En los escenarios siguientes se describe la selección de más de una propiedad clave como el ID de la serie temporal.
Ejemplo 1: Id. de serie temporal con una clave única
- Tiene flotas antiguas de activos. Cada tiene una clave única.
- Una flota se identifica de forma única por la propiedad deviceId. Para otra flota, la propiedad única es objectId. Ninguna flota contiene la propiedad única de la otra flota. En este ejemplo, seleccionaría dos claves, deviceId y objectId, como claves únicas.
- Aceptamos valores nulos y la falta de presencia de una propiedad en la carga útil del evento cuenta como un valor nulo. Esta es también la manera adecuada de controlar el envío de datos a dos orígenes de eventos donde los datos de cada origen de eventos tienen un identificador de serie temporal único.
Ejemplo 2: Id. de serie temporal con una clave compuesta
- Necesita que varias propiedades sean únicas dentro de la misma flota de recursos.
- Usted es un fabricante de edificios inteligentes e implementa sensores en cada habitación. En cada sala, normalmente tienes los mismos valores para el sensorId . Algunos ejemplos son sensor1, sensor2y sensor3.
- El edificio tiene números de piso y de habitación repetidos en varias ubicaciones de la propiedad flrRm. Estos números tienen valores como 1a, 2by 3a.
- Tiene una propiedad, ubicación, que contiene valores como Redmond, Barcelonay Tokyo. Para garantizar la singularidad, designe las tres propiedades siguientes como claves ID de serie temporal: sensorId, flrRmy location.
Evento crudo de ejemplo:
{
"sensorId": "sensor1",
"flrRm": "1a",
"location": "Redmond",
"temperature": 78
}
En Azure Portal, puede escribir la clave compuesta de la siguiente manera:
Nota
En Azure Portal, no escriba nombres separados por comas de propiedades en un cuadro de tex; de lo contrario, se tratará como un nombre de propiedad único que contenga comas. Escriba cada nombre de propiedad en su propio cuadro de texto.
Pasos siguientes
Lea las reglas de aplanamiento y escape de JSON y para comprender cómo se almacenarán los eventos.