Consultar dados do ambiente de Gen2 do Azure Time Series Insights usando o C Sharp

Observação

O serviço TSI (Time Series Insights) não terá mais suporte após março de 2025. Considere migrar os ambientes existentes do TSI para soluções alternativas assim que possível. Para obter mais informações sobre a substituição e a migração, visite nossa documentação.

Este exemplo em C# demonstra como consultar dados das APIs de acesso a dados de Gen2 em ambientes de Gen2 do Azure Time Series Insights.

Dica

Confira os exemplos de código C# de Gen2 em https://github.com/Azure-Samples/Azure-Time-Series-Insights.

Resumo

O código de exemplo abaixo demonstra os seguintes recursos:

• Suporte para geração automática do SDK por meio do Azure AutoRest.

• Como adquirir um token de acesso por meio da ID do Microsoft Entra usando Microsoft.IdentityModel.Clients.ActiveDirectory.

• Como passar esse token de acesso adquirido no cabeçalho Authorization das solicitações seguintes da API de Acesso a Dados.

• A amostra fornece uma interface de console que demonstra como as solicitações HTTP são feitas à:

  • API de ambientes de Gen2
    • API de Obtenção da Disponibilidade de Ambientes e API de Obtenção do Esquema de Evento
  • API de consulta de Gen2
    • API de Obtenção de Eventos, API de Obtenção da Série e API de Obtenção da Série Agregada
  • APIs de Modelo de Série Temporal
    • API de Obtenção de Hierarquias e API do Lote de Hierarquias
    • API de Obtenção de Tipos e API do Lote de Tipos
    • API de Obtenção de Instâncias e API do Lote de Instâncias

• Funcionalidades avançadas de Pesquisa e TSX.

Pré-requisitos e configuração

Conclua as etapas a seguir antes de usar compilar e executar o código de exemplo:

1. Provisione um ambiente de Gen2 do Azure Time Series Insights.
2. Configure seu ambiente do Azure Time Series Insights para a ID do Microsoft Entra, conforme descrito em Autenticação e autorização.
3. Execute GenerateCode.bat, conforme especificado em Readme.md, para gerar as dependências do cliente de Gen2 do Azure Time Series Insights.
4. Abrir a solução TSIPreviewDataPlaneclient.sln e definir DataPlaneClientSampleApp como o projeto padrão no Visual Studio.
5. Instalar as dependências de projeto necessárias usando as etapas descritas abaixo e compilar o exemplo em um arquivo .exe executável.
6. Executar o arquivo .exe clicando duas vezes nele.

Dependências de projeto

Recomendamos usar a versão mais recente do Visual Studio:

• Visual Studio 2019: versão 16.4.2 e posterior

O código de exemplo tem várias dependências necessárias que podem ser exibidas no arquivo packages.config.

Baixe os pacotes no Visual Studio 2019 selecionando a opção Compilar>Compilar Solução.

Como alternativa, adicione cada pacote usando o NuGet 2.12 e posterior. Por exemplo:

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

Código de exemplo C#

Confira o repositório do Azure Time Series Insights para acessar o código de exemplo em C#.

Observação

• O exemplo de código pode ser executado sem alterar as variáveis de ambiente padrão.
• O exemplo de código será compilado em um aplicativo de console executável .NET.

Próximas etapas

• Para saber mais sobre consultas, leia a referência da API de Consulta.

• Leia como conectar um aplicativo JavaScript usando o SDK do cliente ao Time Series Insights.