Tipos de dados com suporte
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 migração, acesse nossa documentação.
A tabela a seguir lista os tipos de dados com suporte pelo Azure Time Series Insights Gen2
| Tipo de dados | Descrição | Exemplo | Sintaxe de Expressão de Série Temporal | Nome da coluna de propriedade no Parquet |
|---|---|---|---|---|
| bool | Um tipo de dados com um dos dois estados: true ou false. |
"isQuestionable" : true |
$event.isQuestionable.Bool ou $event['isQuestionable'].Bool |
isQuestionable_bool |
| datetime | Representa um momento no tempo, geralmente expresso como uma data e hora do dia. Expresso no formato ISO 8601. As propriedades DateTime são sempre armazenadas no formato UTC. Os deslocamentos de fuso horário, se formatados corretamente, serão aplicados e, em seguida, o valor armazenado em UTC. Consulte esta seção para obter mais informações sobre a propriedade timestamp do ambiente e os deslocamentos de datetime | "eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z" |
Se "eventProcessedLocalTime" for o carimbo de data/hora da origem do evento: $event.$ts. Se for outra propriedade JSON: $event.eventProcessedLocalTime.DateTime ou $event['eventProcessedLocalTime'].DateTime |
eventProcessedLocalTime_datetime |
| double | Um número de precisão dupla de 64 bits | "value": 31.0482941 |
$event.value.Double ou $event['value'].Double |
value_double |
| longo | Um inteiro de 64 bits com sinal | "value" : 31 |
$event.value.Long ou $event['value'].Long |
value_long |
| cadeia de caracteres | Os valores de texto devem consistir em UTF-8 válido. Cadeias de caracteres nulas e vazias são tratadas da mesma forma. | "site": "DIM_MLGGG" |
$event.site.String ou $event['site'].String |
site_string |
| dinâmico | Um tipo complexo (não primitivo) que consiste em uma matriz ou um recipiente de propriedades (dicionário). No momento, apenas as matrizes JSON em cadeias de primitivos ou matrizes de objetos que não contêm a ID TS ou a propriedade timestamp serão armazenadas como dinâmicas. Leia este artigo para entender como os objetos serão mesclados e as matrizes podem ser distribuídas. As propriedades payload armazenadas como esse tipo só podem ser acessadas selecionando Explore Events no Gerenciador do Time Series Insights para exibir eventos brutos ou por meio da API de Consulta GetEvents para análise do lado do cliente. |
"values": "[197, 194, 189, 188]" |
A referência a tipos dinâmicos em uma Expressão de Série Temporal ainda não tem suporte | values_dynamic |
Observação
Há suporte para valores inteiros de 64 bits, mas o maior número que o Gerenciador do Azure Time Series Insights pode expressar com segurança é 9.007.199.254.740.991 (2^53-1) devido a limitações de JavaScript. Se você trabalhar com números em seu modelo de dados acima disso, poderá reduzir o tamanho criando uma variável de Modelo de Série Temporal e convertendo o valor.
Observação
O tipo String não permite valor nulo:
- Uma Expressão de Série Temporal (TSX) expressa em uma Consulta de Série Temporal que compara o valor de uma cadeia de caracteres vazia ('') com NULL se comportará da mesma maneira: é equivalente a .
- A API pode retornar valores NULL mesmo se os eventos originais continham cadeias de caracteres vazias.
- Não tome dependência de valores NULL em colunas String para fazer comparações ou avaliações, trate-os da mesma maneira que cadeias de caracteres vazias.
Enviando tipos de dados mistos
Seu ambiente do Azure Time Series Insights Gen2 é fortemente tipado. Se dispositivos ou marcas enviarem dados de tipos diferentes para uma propriedade de dispositivo, os valores serão armazenados em duas colunas separadas e a função coalesce() deverá ser usada ao definir suas expressões de Variável de Modelo de Série Temporal em chamadas à API.
O Gerenciador do Azure Time Series Insights oferece uma maneira de união automática das colunas separadas da mesma propriedade de dispositivo. No exemplo a seguir, o sensor envia uma propriedade PresentValue que pode ser Long ou Double. Para consultar todos os valores armazenados (independentemente do tipo de dados) da propriedade PresentValue, escolha PresentValue (Double | Long) e as colunas serão unidas para você.
Objetos e matrizes
Você pode enviar tipos complexos, como objetos e matrizes como parte de seu payload de eventos. Objetos aninhados serão mesclados e as matrizes serão armazenadas como dynamic ou mescladas para produzir vários eventos, dependendo da configuração do ambiente e da forma JSON. Para saber mais, leia sobre Regras de escape e mesclagem JSON
Próximas etapas
Leia as Regras de escape e mesclagem JSON para entender como os eventos são armazenados.
Entenda as limitações da taxa de transferência do ambiente
Saiba mais sobre as fontes de eventos para ingerir dados de streaming.