Partilhar via

Práticas recomendadas para escolher um ID de Série Temporal

  • Artigo

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

Este artigo resume a importância da identificação da série temporal para o seu ambiente do Azure Time Series Insights Gen2 e as práticas recomendadas para a sua escolha.

Escolha um ID de Série Temporal

Selecionar um ID de série temporal apropriado é fundamental. Escolher um ID de Série Temporal é como escolher uma chave de partição para um banco de dados. É necessário quando você cria um ambiente do Azure Time Series Insights Gen2.

Assista ao tutorial de provisionamento de ambiente para obter uma explicação detalhada da ID da série temporal. Você visualizará dois exemplos diferentes de carga útil de telemetria JSON e a seleção correta de ID de série temporal para cada um.

Importante

Os IDs de séries temporais são:

  • Uma propriedade de cadeia de caracteres que diferencia maiúsculas de minúsculas: letras e caixas de caracteres são usadas em pesquisas, comparações, atualizações e ao particionamento.
  • Uma propriedade imutável: uma vez criada, não pode ser alterada.

Dica

Se a origem do evento for um hub IoT, a sua Time Series ID provavelmente será iothub-connection-device-id. Se planeia usar modelos de dispositivo IoT Plug and Play ou os está a usar sem componentes, inclua dt-subject como parte da chave composta, para o caso de necessitar no futuro.

As principais práticas recomendadas a seguir incluem:

  • Escolha uma chave de partição com muitos valores distintos (por exemplo, centenas ou milhares). Em muitos casos, isso pode ser o ID do dispositivo, o ID do sensor ou o ID da tag no JSON.
  • O ID da Série Temporal deve ser exclusivo no nível do nó folha do seu Modelo de Série Temporal .
  • O limite de caracteres para o nome da propriedade do 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 faltando, ele será tratado como um valor nulo e seguirá a mesma regra da restrição de exclusividade.
  • Se o ID da Série Temporal estiver aninhado num objeto JSON complexo, certifique-se de seguir as regras de nivelamento de entrada ao fornecer o nome da propriedade. Confira o exemplo B.
  • Você também pode selecionar até três propriedades principais para serem o seu ID de Série Temporal. A sua combinação será uma chave composta que representa o ID da Série Temporal.

    Observação

    Suas três propriedades principais devem ser cadeias de caracteres. Você teria que consultar essa chave composta em vez de uma propriedade de cada vez.

Selecione mais de uma propriedade chave

Os cenários a seguir descrevem a seleção de mais de uma propriedade de chave como sua ID de Série Temporal.

Exemplo 1: ID de série temporal com uma chave exclusiva

  • Você tem frotas antigas de ativos. Cada um tem uma chave única.
  • Uma frota é identificada exclusivamente pela propriedade deviceId. Para outra frota, a propriedade única é objectId. Nenhuma das frotas contém a propriedade única da outra frota. Neste exemplo, você selecionaria duas chaves, deviceId e objectId, como chaves exclusivas.
  • Aceitamos valores nulos, e a ausência de uma propriedade no payload do evento conta como um valor nulo. Essa também é a maneira apropriada de lidar com o envio de dados para duas fontes de eventos em que os dados em cada fonte de evento têm uma ID de série temporal exclusiva.

Exemplo 2: ID de série temporal com uma chave composta

  • Você precisa que várias propriedades sejam exclusivas dentro da mesma frota de ativos.
  • Você é um fabricante de edifícios inteligentes e implanta sensores em todos os cômodos. Em cada sala, normalmente você tem os mesmos valores para sensorId. Exemplos são sensor1, sensor2e sensor3.
  • Seu prédio tem números de piso e quarto sobrepostos em todos os locais da propriedade flrRm. Estes números têm valores como 1a, 2be 3a.
  • Você tem uma propriedade, localização, que contém valores como Redmond, Barcelona, e Tokyo. Para criar unicidade, designa as três propriedades seguintes como as suas chaves de ID de Série Temporal: sensorId, flrRme local.

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:

Configurar ID de série temporal para o ambiente.

Observação

No portal do Azure, não insira nomes de propriedades separados por vírgulas em uma texbox, caso contrário, ele será tratado como um único nome de propriedade que contém vírgulas. Insira o nome de cada propriedade na sua própria caixa de texto.

Próximos passos