Práticas recomendadas para escolher uma ID de série temporal
Observação
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.
Este artigo resume a importância de uma ID da série temporal para o seu ambiente do Azure Time Series Insights Gen2 e as práticas recomendadas na escolha da sua ID.
Escolha uma ID do Time Series
É essencial selecionar uma ID da série temporal adequada. Escolher uma ID do Time Series é como escolher uma chave de partição para um banco de dados. Isso é necessário quando você cria um ambiente do Azure Time Series Insights Gen2.
Assista ao tutorial de provisionamento de ambiente para uma explicação detalhada sobre a ID da série temporal. Serão mostrados dois exemplos diferentes de conteúdo de telemetria JSON e a seleção correta de ID da série temporal para cada um deles.
Importante
A ID da série temporal é:
- Uma propriedade cadeia de caracteres que diferencia maiúsculas de minúsculas: essa distinção é observada em pesquisas, comparações, atualizações e no particionamento.
- Uma propriedade imutável: depois de criada, ela não pode ser alterada.
Dica
Se a origem do evento for um hub IoT, a ID da série temporal provavelmente será iothub-connection-device-id. Se você planeja usar os modelos de dispositivo IoT Plug and Play ou usá-los sem componentes, deverá incluir dt-subject como parte da chave composta, caso precise dele no futuro.
As principais práticas recomendadas são:
- Escolher uma chave de partição com muitos valores distintos (por exemplo, centenas ou milhares). Em muitos casos, ela pode ser a identificação do dispositivo, do sensor ou da marca no JSON.
- A ID do Time Series deve ser exclusiva no nível do nó folha do seu Modelo do Time Series.
- O limite de caracteres para a cadeia de caracteres no nome da propriedade da ID da série temporal é 128. Para o valor da propriedade da ID da série temporal, o limite de caracteres é 1.024.
- Se um valor de propriedade exclusivo para a ID da série temporal estiver ausente, ele será tratado como um valor nulo e seguirá a mesma regra de restrição de exclusividade.
- Se a ID da série temporal estiver aninhada em um objeto JSON complexo, lembre-se de seguir as regras de mesclagem de entrada ao fornecer o nome da propriedade. Confira o exemplo B.
- Você também pode selecionar até três (3) propriedades de chave como sua ID da série temporal. A combinação destas chaves é uma chave composta que representa a ID da série temporal.
Observação
As três propriedades de chave devem ser cadeias de caracteres. É necessário consultar essa chave composta em vez de uma propriedade de cada vez.
Selecionar mais de uma propriedade de chave
Os cenários a seguir descrevem como selecionar mais de uma propriedade de chave como sua ID da série temporal:
Exemplo 1: ID da série temporal com uma chave exclusiva
- Você tem flotas de ativos herdadas. Cada uma tem uma chave exclusiva.
- Uma das frotas é identificada exclusivamente pela propriedade DeviceID. Para outra frota, a propriedade exclusiva é ObjectID. Nenhuma das frotas contém a propriedade exclusiva da outra frota. Neste exemplo, você selecionou duas chaves, deviceId e objectId, como chaves exclusivas.
- São aceitos valores nulos, e a ausência de uma propriedade na carga do evento é contada como um valor nulo. Essa também é a maneira adequada de lidar com o envio de dados para dois eventos de origens diferentes em que os dados em cada origem do evento têm uma ID da série temporal exclusiva.
Exemplo 2: ID da série temporal com uma chave composta
- Você precisa que várias propriedades sejam exclusivas dentro do mesma frota de ativos.
- Você é um fabricante de prédios inteligentes e decide implantar sensores em todas as salas. Normalmente,cada sala tem os mesmos valores de sensorId. Como exemplos, temos sensor1, sensor2e sensor3.
- O prédio tem números de andar e de sala que se sobrepõem na propriedade flrRm ao longo dos vários locais de construção. Esses números têm valores como 1a, 2Be 3a.
- Você tem a propriedade, location, que contém valores como Redmond, Barcelona e Tóquio. Para criar a exclusividade, você precisa designar as três propriedades seguintes como chaves de ID da série temporal: sensorId, flrRm e location.
Exemplo de evento bruto:
{
"sensorId": "sensor1",
"flrRm": "1a",
"location": "Redmond",
"temperature": 78
}
No portal do Azure, você pode inserir a chave composta da seguinte maneira:
Observação
No portal do Azure, não insira nomes de propriedades separados por vírgulas em uma mesma caixa de texto, pois assim eles serão tratados como um único nome de propriedade que contém vírgulas. Insira cada nome de propriedade em sua própria caixa de texto.
Próximas etapas
Leia as Regras de escape e mesclagem JSON para entender como os eventos são armazenados.
Planeje o seu ambiente do Azure Time Series Insights Gen2 .