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

Observação

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 a migração, visite nossa documentação .

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

Dica

Veja exemplos de código Gen2 C# 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 de SDK a partir do Azure AutoRest.

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

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

• O exemplo fornece uma interface de console demonstrando como as solicitações HTTP são feitas para o seguinte:

  • da API de Ambientes Gen2
    • Obter API de Disponibilidade de Ambientes e Obter API de Esquema de Eventos
  • API de Consulta Gen2
    • Obter Eventos API, Obter Séries APIe Obter Séries Agregadas API
  • APIs de modelos de séries temporais
    • API de Obtenção de Hierarquias e API de Lote de Hierarquias
    • API de Obtenção de Tipos e API de Tipos em Lote
    • Obter instâncias API e Instâncias API em lote

• Capacidades de Pesquisa Avançada e capacidades de TSX e.

Pré-requisitos e configuração

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

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

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 várias dependências necessárias que podem ser visualizadas no arquivo packages.config.

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

Como alternativa, adicione cada pacote usando NuGet 2.12+. Por exemplo:

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

Código de exemplo C#

Consulte o repositório do Azure Time Series Insights para acessar o código de exemplo do 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 para um aplicativo de console executável .NET.

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 Azure Time Series Insights.