Consulta de datos desde Azure Time Series Insights Gen2
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 el desuso y la migración, visite nuestra documentación de .
Azure Time Series Insights Gen2 permite realizar consultas de datos en eventos y metadatos almacenados en el entorno a través de las API de superficie pública. Estas API también son utilizadas por el Explorador de TSI de Azure Time Series Insights.
Hay tres categorías de API principales disponibles en Azure Time Series Insights Gen2:
- APIs de entorno: Estas APIs habilitan consultas en el propio entorno de Azure Time Series Insights Gen2. Se pueden usar para recopilar la lista de entornos a los que el autor de la llamada tiene acceso y los metadatos del entorno.
- API de Model-Query de serie temporal (TSM-Q): permite realizar operaciones de creación, lectura, actualización y eliminación (CRUD) en los metadatos almacenados en el modelo de serie temporal del entorno. Se pueden usar para acceder a las instancias, tipos y jerarquías y editarlas.
- API de consulta de serie temporal (TSQ): habilita la recuperación de datos de telemetría o eventos a medida que se registra desde el proveedor de origen y habilita cálculos y agregaciones de rendimiento en los datos mediante funciones escalares y de agregado avanzadas.
Azure Time Series Insights Gen2 utiliza un lenguaje de expresiones enriquecido basado en cadenas, Time Series Expression (TSX), para expresar cálculos en Variables de Serie Temporal.
Introducción a las API de Azure Time Series Insights Gen2
Se admiten las siguientes API principales.
APIs de entorno
- Get Environments API: devuelve la lista de entornos a los que está autorizado el autor de la llamada para acceder.
-
Get Environments Availability API: devuelve la distribución del recuento de eventos según la marca de tiempo del evento
$ts. Esta API ayuda a determinar si hay algún evento en el entorno devolviendo el recuento de eventos divididos en intervalos de tiempo, si existe alguno. - Get Event Schema API: devuelve los metadatos del esquema de eventos de un intervalo de búsqueda determinado. Esta API ayuda a recuperar todos los metadatos y propiedades disponibles en el esquema para el intervalo de búsqueda especificado.
APIs de series temporales Model-Query (TSM-Q)
La mayoría de estas API admiten la operación de ejecución por lotes para habilitar las operaciones CRUD por lotes en varias entidades del modelo de serie temporal:
- API de configuración de modelos: habilita GET y PATCH en el tipo predeterminado y el nombre del modelo del entorno.
- Types API: habilita CRUD en tipos de serie temporal y sus variables asociadas.
- Jerarquías API: habilita CRUD en jerarquías de serie temporal y sus rutas de acceso de campo asociadas.
- Instances API: habilita CRUD en instancias de serie temporal y sus campos de instancia asociados. Además, instances API admite las siguientes operaciones:
APIs de Consulta de Series Temporales (TSQ)
Estas API están disponibles en ambos almacenes (en caliente y en frío) en nuestra solución de almacenamiento multicapa.
Get Events API: habilita la consulta y recuperación de eventos sin procesar y las marcas de tiempo de evento asociadas a medida que se registran en Azure Time Series Insights Gen2 desde el proveedor de origen. Esta API permite la recuperación de eventos sin procesar para un identificador de serie temporal dado y un intervalo de búsqueda. Esta API admite la paginación para recuperar el conjunto de datos de respuesta completo para la entrada seleccionada.
Importante
Como parte del próximos cambios en las reglas de acoplamiento y escape de JSON, las matrices se almacenarán como tipo de dinámico. Las propiedades del payload almacenadas como este tipo son accesibles únicamente a través de la Get Events API.
Get Series API: habilita la consulta y recuperación de valores calculados y las marcas de tiempo de evento asociadas aplicando cálculos definidos por variables en eventos sin procesar. Estas variables se pueden definir en el modelo de serie temporal o en línea en la consulta. Esta API admite la paginación para recuperar el conjunto de datos de respuesta completo para la entrada seleccionada.
API de la Serie de Agregados: permite la consulta y recuperación de valores agregados y las marcas de tiempo de intervalo asociadas mediante cálculos definidos por variables sobre eventos en bruto. Estas variables se pueden definir en el modelo de serie temporal o en línea en la consulta. Esta API admite la paginación para recuperar el conjunto de datos de respuesta completo para la entrada seleccionada.
Para un intervalo de búsqueda y un intervalo especificados, esta API devuelve una respuesta agregada por intervalo por variable para un identificador de serie temporal. El número de intervalos del conjunto de datos de respuesta se calcula contando los ticks de época (el número de milisegundos transcurridos desde el inicio de la época Unix (1 de enero de 1970)) y dividiendo estos ticks por el tamaño del intervalo especificado en la consulta.
Las marcas de tiempo devueltas en el conjunto de respuestas son de los límites del intervalo izquierdo, no de los eventos muestreados del intervalo.
Selección del tipo de almacén
Las API anteriores solo se pueden ejecutar en uno de los dos tipos de almacenamiento (en frío o en caliente) en una sola llamada. Los parámetros de consulta en la URL se utilizan para especificar el tipo de tienda en el cual se debe ejecutar la consulta.
Si no se especifica ningún parámetro, la consulta se ejecutará en el almacenamiento en frío de forma predeterminada. Si una consulta abarca un intervalo de tiempo que se superpone al almacenamiento en frío y en caliente, se recomienda enrutar la consulta al almacén en frío para obtener la mejor experiencia, ya que el almacenamiento intermedio solo contendrá datos parciales.
El explorador de Azure Time Series Insights y el conector de Power BI realizarán llamadas a las API anteriores y seleccionarán automáticamente el parámetro storeType correcto donde sea pertinente.