Consulta de datos desde el entorno de Azure Time Series Insights Gen2 mediante C Sharp

Nota:

El servicio Time Series Insights se retirará el 7 de julio de 2024. Considere la posibilidad de migrar los entornos existentes a otras soluciones lo antes posible. Para más información sobre la entrada en desuso y la migración, consulte nuestra documentación.

En este ejemplo de C# se muestra cómo consultar datos desde las API de acceso a datos de segunda generación en los entornos de Azure Time Series Insights de segunda generación.

Sugerencia

Consulte ejemplos de código C# de segunda generación en https://github.com/Azure-Samples/Azure-Time-Series-Insights.

Resumen

En el código de ejemplo siguiente se muestran las siguientes características:

• Compatibilidad con la generación automática del SDK desde Azure AutoRest.

• Cómo adquirir un token de acceso a través de Microsoft Entra ID mediante Microsoft.IdentityModel.Clients.ActiveDirectory.

• Cómo pasar el token de acceso adquirido en el encabezado Authorization de las posteriores solicitudes de Data Access API.

• El ejemplo proporciona una interfaz de consola que muestra cómo se realizan las solicitudes HTTP en:

  • API de entornos de segunda generación
    • Get Environments Availability API y Get Event Schema API
  • API de consulta de segunda generación
    • Get Events API, Get Series API y Get Aggregate Series API
  • API de modelo de serie temporal
    • Get Hierarchies API y Hierarchies Batch API
    • Get Types API y Types Batch API
    • Get Instances API e Instances Batch API

• Funcionalidades avanzadas de búsqueda y TSX.

Requisitos previos y configuración

Realice los pasos siguientes antes de compilar y ejecutar el código de ejemplo:

1. Aprovisione un entorno de segunda generación de Azure Time Series Insights.
2. Configure el entorno de Azure Time Series Insights para Microsoft Entra ID tal y como se describe en Autenticación y autorización.
3. Ejecute el archivo GenerateCode.bat como se especifica en el archivo Readme.md para generar las dependencias de cliente de Azure Time Series Insights de segunda generación.
4. Abra la solución TSIPreviewDataPlaneclient.sln y establezca DataPlaneClientSampleApp como proyecto predeterminado en Visual Studio.
5. Instale las dependencias del proyecto necesarias, para lo cual debe seguir los pasos que se describen a continuación, y compile el ejemplo en un archivo .exe ejecutable.
6. Ejecute el archivo .exe haciendo doble clic en él.

Dependencias del proyecto

Se recomienda usar la versión más reciente de Visual Studio:

• Visual Studio 2019, versión 16.4.2+

El código de ejemplo tiene varias dependencias requeridas, que se pueden ver en el archivo packages.config.

Para descargar los paquetes en Visual Studio 2019, seleccione la opción Compilar>Compilar solución.

Como alternativa, agregue cada paquete con NuGet 2.12+. Por ejemplo:

• dotnet add package Microsoft.IdentityModel.Clients.ActiveDirectory --version 4.5.1

Código de ejemplo de C#

Consulte el repositorio Azure Time Series Insights para acceder al código de ejemplo de C#.

Nota:

• El código de ejemplo se puede ejecutar sin modificar los valores de entorno predeterminados.
• El código de ejemplo se compilará en una aplicación de consola ejecutable de .NET.

Pasos siguientes

• Para más información sobre la consulta, vea la referencia sobre las API de consulta.

• Lea cómo conectar una aplicación de JavaScript mediante el SDK de cliente a Azure Time Series Insights.