Consultando dados do Azure Time Series Insights Gen2
Nota
O serviço Time Series Insights será desativado em 7 de julho de 2024. Considere migrar 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 .
O Azure Time Series Insights Gen2 permite a consulta de dados em eventos e metadados armazenados no ambiente por meio de APIs de superfície pública. Essas APIs também são usadas pelo do Azure Time Series Insights TSI Explorer.
Três categorias de API primárias estão disponíveis no Azure Time Series Insights Gen2:
- APIs de Ambiente: essas APIs habilitam consultas no próprio ambiente do Azure Time Series Insights Gen2. Eles podem ser usados para reunir a lista de ambientes aos quais o chamador tem acesso e metadados de ambiente.
- APIs de Séries Temporais Model-Query (TSM-Q): permite operações de criar, ler, atualizar e excluir (CRUD) em metadados armazenados no Modelo de Série Temporal do ambiente. Elas podem ser usadas para acessar e editar instâncias, tipos e hierarquias.
- APIs de Consulta de Série Temporal (TSQ): habilita a recuperação de dados de telemetria ou eventos conforme são registrados do provedor de origem e permite computações e agregações eficientes nos dados usando funções escalares e agregadas avançadas.
O Azure Time Series Insights Gen2 usa uma linguagem de expressão baseada em cadeia de caracteres avançada, de Expressão de Série Temporal (TSX), para expressar cálculos em variáveis de série temporal.
Visão geral das APIs do Azure Time Series Insights Gen2
Há suporte para as APIs principais a seguir.
APIs de ambiente
- Obter API de Ambientes: retorna a lista de ambientes que o chamador está autorizado a acessar.
-
API de Disponibilidade de Ambientes: retorna a distribuição da contagem de eventos ao longo do timestamp do evento
$ts. Essa API ajuda a determinar se há eventos no ambiente retornando a contagem de eventos divididos em intervalos de tempo, se houver algum. - API de Obtenção de Esquema de Eventos: retorna os metadados do esquema de eventos para um determinado intervalo de pesquisa. Essa API ajuda a recuperar todos os metadados e propriedades disponíveis no esquema para o intervalo de pesquisa especificado.
APIs de Série Temporal Model-Query (TSM-Q)
A maioria dessas APIs dá suporte à operação de execução em lote para habilitar operações CRUD em lotes em várias entidades do Modelo de Série Temporal:
- de API de Configurações de Modelo: habilita GET e PATCH no tipo padrão e no nome do modelo do ambiente.
- Tipos de API: Habilita o CRUD sobre tipos de série temporal e suas variáveis associadas.
- da API de Hierarquias: habilita o CRUD em hierarquias de Série Temporal e seus caminhos de campo associados.
- API de Instâncias: habilita o CRUD em instâncias de séries temporais e seus campos de instância associados. Além disso, a API de Instâncias dá suporte às seguintes operações:
APIs de consulta de série temporal (TSQ)
Essas APIs estão disponíveis em ambas as lojas (Warm e Cold) em nossa solução de armazenamento multicamadas.
API de Eventos: Habilita a consulta e recuperação de eventos brutos e os carimbos de data/hora associados, conforme são registrados no Azure Time Series Insights Gen2 a partir do provedor de origem. Essa API permite a recuperação de eventos brutos para uma determinada ID de Série Temporal e um intervalo de pesquisa. Essa API dá suporte à paginação para recuperar o conjunto de dados de resposta completo para a entrada selecionada.
Importante
Como parte das alterações futuras nas regras de escape e nivelamentodo JSON, as matrizes serão armazenadas como tipo Dinâmico . As propriedades de conteúdo armazenadas como esse tipo são SOMENTE acessíveis por meio da API Get Events.
Obterde API de Série: habilita a consulta e a recuperação de valores computados e os carimbos de data/hora de evento associados aplicando cálculos definidos por variáveis em eventos brutos. Essas variáveis podem ser definidas no Modelo de Série Temporal ou fornecidas embutidas na consulta. Essa API dá suporte à paginação para recuperar o conjunto de dados de resposta completo para a entrada selecionada.
API de Série Agregada: Habilita a consulta e a recuperação de valores agregados e os timestamps de intervalos associados aplicando cálculos definidos pelas variáveis em eventos brutos. Essas variáveis podem ser definidas no Modelo de Série Temporal ou fornecidas embutidas na consulta. Essa API dá suporte à paginação para recuperar o conjunto de dados de resposta completo para a entrada selecionada.
Para um intervalo e intervalo de pesquisa especificados, essa API retorna uma resposta agregada por intervalo por variável para uma ID de Série Temporal. O número de intervalos no conjunto de dados de resposta é calculado com base na contagem de ticks de época (o número de milissegundos decorridos desde a Época Unix, em 1º de janeiro de 1970). Em seguida, os ticks são divididos pelo tamanho do intervalo especificado na consulta.
Os carimbos de data/hora retornados no conjunto de resposta são dos limites do intervalo esquerdo, não dos eventos amostrados do intervalo.
Selecionando tipo de repositório
As APIs acima só podem ser executadas em um dos dois tipos de armazenamento (Frio ou Quente) em uma única chamada. Os parâmetros de URL de consulta são usados para especificar o tipo de repositório em que a consulta deve ser executada.
Se nenhum parâmetro for especificado, a consulta será executada no Cold Store, por padrão. Se uma consulta abranger um intervalo de tempo sobrepondo o repositório Frio e Quente, é recomendável rotear a consulta para o Repositório Frio para obter a melhor experiência, pois o repositório Warm conterá apenas dados parciais.
O Azure Time Series Insights Explorer e o Conector do Power BI fazem chamadas para as APIs acima e selecionarão automaticamente o parâmetro storeType correto, quando relevante.
Próximas etapas
- Leia mais sobre variáveis diferentes que podem ser definidas no Modelo de Série Temporal .
- Leia mais sobre como consultar dados no Azure Time Series Insights Explorer.