Consultar dados do ambiente Azure Time Series Insights Gen1 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.

Cuidado

Esse é um artigo do Gen1.

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

Dica

Confira os exemplos de código C# Gen1 no 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 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 subsequentes da API de Consulta.

• A amostra chama cada uma das APIs de Consulta Gen1 demonstrando como as solicitações HTTP são feitas ao:

  • Obter a API de Ambientes para retornar os ambientes aos quais o usuário tem acesso
  • Obter a API de Disponibilidade de Ambiente
  • Obter API de Metadados de Ambiente para recuperar metadados de ambiente
  • Obter API de Eventos de Ambiente
  • Obter API de Agregados de Ambiente

• Como interagir com as APIs de Consulta Gen1 usando o WSS para a mensagem:

  • Obter API de Fluxo de Eventos de Ambiente
  • Obter API Transmitida de Agregações de Ambiente

Pré-requisitos e configuração

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

1. Provisionar um ambiente do Azure Time Series Insights Gen1.
2. Configure seu ambiente do Azure Time Series Insights para a ID do Microsoft Entra, conforme descrito em Autenticação e autorização.
3. Instalar as dependências de projeto necessárias.
4. Editar 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 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 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 Compilar>Compilar Solução.

Como alternativa, adicione os pacotes usando o NuGet 2.12 e posterior:

• 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#

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

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