Procedimientos recomendados al elegir un id. de serie temporal

Nota:

El servicio Time Series Insights (TSI) dejará de admitirse a partir de marzo de 2025. Considere la posibilidad de migrar los entornos de TSI existentes a soluciones alternativas lo antes posible. Para obtener más información sobre el desuso y la migración, consulte nuestra documentación.

En este artículo se resume la importancia del identificador de serie temporal en el entorno de Azure Time Series Insights Gen2 y los procedimiento recomendados para elegir uno.

Elección de un identificador de Time Series

Es fundamental seleccionar un identificador de serie temporal adecuado. Elegir un id. de serie temporal es como elegir una clave de partición para una base de datos. Se requiere al crear un entorno de Azure Time Series Insights Gen2.

Vea el tutorial de aprovisionamiento de entorno para obtener una explicación detallada del identificador de serie temporal. Verá dos ejemplos diferentes de carga de telemetría de JSON y la selección del identificador de serie temporal correcto para cada uno.

Importante

Los identificadores de serie temporal son los siguientes:

• Propiedad cadena case-sensitive: se hace distinción de mayúsculas y minúsculas en búsquedas, comparaciones, y actualizaciones, así como al crear particiones.
• Propiedad immutable: una vez creada, no se puede cambiar.

Sugerencia

Si el origen del evento es un centro de IoT, es probable que el id. de serie temporal sea iothub-connection-device-id. Si planea usar modelos de dispositivo IoT Plug and Play o los usa sin componentes, debe incluir dt-subject como parte de la clave compuesta por si lo necesita en el futuro.

Los principales procedimientos recomendados que han de seguirse incluyen lo siguiente:

• Elija una clave de partición con muchos valores distintos (por ejemplo, centenares o miles). En muchos casos, puede ser el identificador de dispositivo, identificador de sensor o identificador de etiqueta de JSON.
• El id. de serie temporal debe ser único en el nivel de nodo hoja de su Modelo de serie temporal.
• El límite de caracteres de la cadena de nombre de la propiedad del identificador de serie temporal es 128. En el caso del valor de la propiedad del identificador de serie temporal, el límite de caracteres es 1.024.
• 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 el identificador de serie temporal está anidado dentro de un objeto JSON complejo, asegúrese de seguir las reglas de acoplamiento de entrada al proporcionar el nombre de la propiedad. Modificación del ejemplo B.
• Puede seleccionar hasta tres propiedades 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 consultas en esta clave compuesta, en lugar de hacerlo propiedad a propiedad.

Selección de más de una propiedad de clave

En los siguientes escenarios se describe cómo seleccionar más de una propiedad clave como identificador de serie temporal.

Ejemplo 1: identificador de serie temporal con una clave única

• Tiene flotas de recursos heredadas. Cada una tiene una clave única.
• Cada flota se identifica de forma única mediante la propiedad deviceId. En el caso de otra flota, la propiedad única es objectId. Ninguna de las flotas contiene la propiedad única de la otra. En este ejemplo, debe seleccionar dos claves, deviceId y objectId, como claves únicas.
• Aceptamos valores NULL y la falta de la presencia de una propiedad en la carga del evento cuenta como un valor NULL. Esta es también la forma adecuada de controlar el envío de datos a dos orígenes de eventos diferentes, donde los datos de cada origen de eventos tienen un identificador de serie temporal único.

Ejemplo 2: identificador de serie temporal con una clave compuesta

• Necesita que varias propiedades sean únicas dentro del mismo tipo de activos.
• Es fabricante de edificios inteligentes e implementa sensores en todas las habitaciones. En cada una de ellas, lo habitual es que tenga los mismos valores para sensorId. Algunos ejemplos son sensor1, sensor2y sensor3.
• Los números de las plantas y de las estancias del edificio se solapan en la propiedad flrRm. Estos números tienen valores como 1a, 2b y 3a.
• Tiene una propiedad, location, que contiene valores como Redmond, Barcelona y Tokio. Para que los valores sean únicos, designe las tres propiedades siguientes como sus claves del identificador de serie temporal: sensorId, flrRm y location.

Ejemplo de evento sin procesar:

{
  "sensorId": "sensor1",
  "flrRm": "1a",
  "location": "Redmond",
  "temperature": 78
}

En Azure Portal, puede especificar después la clave compuesta de la manera siguiente:

Nota

En Azure Portal, no escriba nombres separados por comas para las propiedades en un cuadro de texto; de lo contrario, se tratarán como un nombre de propiedad único que contiene comas. Escriba cada nombre de propiedad en su propio cuadro de texto.

Pasos siguientes

• Lea las Reglas de acoplamiento y de escape de JSON para comprender cómo se almacenarán los eventos.

• Planeamiento del entorno de Azure Time Series Insights Gen2.