Práticas recomendadas para escolher um Identificador de Série Temporal
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 .
Este artigo resume a importância da ID da Série Temporal para seu ambiente do Azure Time Series Insights Gen2 e as práticas recomendadas para escolher um.
Escolher uma ID de Série Temporal
Selecionar uma ID de Série Temporal apropriada é fundamental. Escolher uma 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ê exibirá dois exemplos de conteúdo de telemetria JSON diferentes e a seleção correta da ID da Série Temporal para cada um.
Importante
Os IDs das Séries Temporais são:
- Uma cadeia de caracteres que diferencia maiúsculas de minúsculas propriedade: maiúsculas de letra e caracteres são usadas em pesquisas, comparações, atualizações e ao particionamento.
- Uma propriedade imutável: uma vez criada, ela não pode ser alterada.
Dica
Se a origem do evento for um hub IoT, seu ID de Série Temporal provavelmente será iothub-connection-device-id. Se você planeja usar modelos de dispositivos IoT Plug and Play ou usá-los sem componentes, deverá incluir dt-subject como parte da chave composta caso precise dela 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, essa pode ser a identificação do dispositivo, a identificação do sensor ou a identificação da tag no seu JSON.
- O ID da Série Temporal deve ser exclusivo no nível do nó folha do Modelo de Série Temporal .
- O limite de caracteres para o nome da string de propriedade da ID de Série Temporal é 128. Para o valor da propriedade 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 da restrição de exclusividade.
- Se a ID da Série Temporal estiver aninhada em um objeto JSON complexo, siga a entrada regras de nivelamento ao fornecer o nome da propriedade. Confira o exemplo B.
- Você também pode selecionar até três propriedades de chave como sua ID de Série Temporal. A combinação deles será uma chave composta que representa o identificador da série temporal.
Nota
Suas três propriedades principais devem ser cadeias de caracteres. Você teria que consultar essa chave composta em vez de consultar 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-chave como ID da sua Série Temporal.
Exemplo 1: ID de Série Temporal com uma chave exclusiva
- Você tem frotas de ativos legados. Cada um tem uma chave exclusiva.
- Uma frota é unicamente identificada pela propriedade deviceId. Para outra frota, a característica única é objectId. Nenhuma das frotas contém a propriedade exclusiva 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 conteúdo do evento é considerada um valor nulo. Essa também é a maneira apropriada de lidar com o envio de dados para duas fontes de evento em que os dados em cada fonte de evento têm uma ID de Série Temporal exclusiva.
Exemplo 2: Identificação 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 todas as salas. Em cada sala, normalmente você tem os mesmos valores para o sensorId . Exemplos são sensor1, sensor2e sensor3.
- Seu prédio tem números de piso e sala sobrepostos entre os locais da propriedade flrRm. Esses números têm valores como 1a, 2be 3a.
- Você tem uma propriedade, localização, que contém valores como Redmond, Barcelonae Tóquio. Para criar unicidade, você designa as seguintes três propriedades como suas chaves de ID de Séries Temporais: sensorId, flrRme localização.
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:
Nota
No portal do Azure, não insira nomes separados por vírgulas de propriedades em uma caixa de texto, caso contrário, ela será tratada como um único nome de propriedade que contém vírgulas. Insira cada nome de propriedade em sua própria caixa de texto.