Consultar dados do ambiente Azure Time Series Insights Gen1 usando C Sharp

Nota

O serviço Time Series Insights será desativado em 7 de julho de 2024. Considere migrar os ambientes existentes para soluções alternativas o mais rápido possível. Para obter mais informações sobre a substituição e migração, visite nossa documentação.

Atenção

Este é um artigo Gen1.

Este exemplo de C# demonstra como usar as APIs de consulta Gen1 para consultar dados de ambientes do Azure Time Series Insights Gen1.

Gorjeta

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

Resumo

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

• Como adquirir um token de acesso através do Microsoft Entra ID usando Microsoft.IdentityModel.Clients.ActiveDirectory.

• Como passar esse token de acesso adquirido no Authorization cabeçalho de solicitações subsequentes da API de Consulta.

• O exemplo chama cada uma das APIs de consulta Gen1 demonstrando como as solicitações HTTP são feitas para:

  • Obter a API de Ambientes para retornar os ambientes aos quais o usuário tem acesso
  • Obter API de disponibilidade de ambiente
  • Obter API de metadados de ambiente para recuperar metadados de ambiente
  • Obter API de eventos de ambientes
  • Obter API de agregados de ambiente

• Como interagir com as APIs de consulta Gen1 usando o WSS para:

  • Obter API de transmissão de eventos de ambiente
  • Obter API transmitida de agregados de ambiente

Pré-requisitos e configuração

Conclua as seguintes etapas antes de compilar e executar o código de exemplo:

1. Provisione um ambiente do Azure Time Series Insights Gen1.
2. Configure seu ambiente do Azure Time Series Insights para Microsoft Entra ID conforme descrito em Autenticação e autorização.
3. Instale as dependências de projeto necessárias.
4. Edite o código de exemplo abaixo substituindo cada #DUMMY# pelo identificador de ambiente apropriado.
5. Execute o código dentro do Visual Studio.

Dependências do projeto

É recomendável que você use a versão mais recente do Visual Studio:

• Visual Studio 2019 - Versão 16.4.2+

O código de exemplo tem duas dependências necessárias:

• Microsoft.IdentityModel.Clients.ActiveDirectory - pacote 3.13.9.
• Newtonsoft.Json - pacote 9.0.1.

Baixe os pacotes no Visual Studio 2019 selecionando a opção Build>Build Solution.

Como alternativa, adicione os pacotes usando o NuGet 2.12+:

• dotnet add package Newtonsoft.Json --version 9.0.1
• dotnet add package Microsoft.IdentityModel.Clients.ActiveDirectory --version 3.13.9

Código de exemplo C#

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

Próximos passos

• 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. Azure-Samples/Azure-Time-Series-Insights/gen1-sample/csharp-tsi-gen1-sample/Program.cs