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

Artigo
06/03/2024

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.

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

Gorjeta

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 esse token de acesso adquirido no Authorization cabeçalho 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:
- API de ambientes Gen2
  - Obter API de Disponibilidade de Ambientes e Obter API de Esquema de Eventos
- API de consulta Gen2
  - Obter API de Eventos, Obter API de Série e Obter API de Série Agregada
- APIs de modelo de série temporal
  - Obter API de hierarquias e API de lote de hierarquias
  - Obter API de Tipos e API de Lotes de Tipos
  - Obter API de instâncias e API de lote de instâncias
Recursos de Pesquisa Avançada e TSX.

Pré-requisitos e configuração

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

Provisione um ambiente Gen2 Azure Time Series Insights .
Configure seu ambiente do Azure Time Series Insights para Microsoft Entra ID conforme descrito em Autenticação e autorização.
Execute o GenerateCode.bat conforme especificado no Readme.md para gerar as dependências do cliente Azure Time Series Insights Gen2.
Abra a TSIPreviewDataPlaneclient.sln solução e defina DataPlaneClientSampleApp como o projeto padrão no Visual Studio.
Instale as dependências de projeto necessárias usando as etapas descritas abaixo e compile o exemplo em um arquivo executável .exe .
Execute o .exe arquivo 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 o 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 Azure Time Series Insights para acessar o código de exemplo C#.