Zaman Serisi Kimliği seçmek için en iyi uygulamalar

  • Makale

Not

Time Series Insights (TSI) hizmeti artık Mart 2025'e kadar desteklenmeyecektir. Mevcut TSI ortamlarını mümkün olan en kısa sürede alternatif çözümlere geçirmeyi göz önünde bulundurun. Kullanımdan kaldırma ve geçiş hakkında daha fazla bilgi için belgelerimizi ziyaret edin.

Bu makalede, Azure Time Series Insights 2. Nesil ortamınız için Zaman Serisi Kimliğinin önemi ve bir ortam seçmek için en iyi yöntemler özetlenmiştir.

Zaman Serisi Kimliği

Uygun bir Zaman Serisi Kimliği seçmek kritik önem taşır. Zaman Serisi Kimliği seçmek, veritabanı için bölüm anahtarı seçmeye benzer. Azure Time Series Insights 2. Nesil ortamı oluştururken gereklidir.

Zaman Serisi Kimliği'nin ayrıntılı açıklaması için ortam sağlama öğreticisini izleyin. İki farklı JSON telemetri yükü örneğini ve her birine yönelik doğru Zaman Serisi Kimliği seçimini görüntüleyebilirsiniz.

Önemli

Zaman Serisi Kimlikleri şunlardır:

  • Büyük/küçük harfe duyarlı dize özelliği: aramalarda, karşılaştırmalarda, güncelleştirmelerde ve bölümleme sırasında harf ve karakter büyük/küçük harfleri kullanılır.
  • Sabit bir özellik : oluşturulduktan sonra değiştirilemez.

İpucu

Olay kaynağınız bir IoT hub'ıysa Zaman Serisi Kimliğiniz büyük olasılıkla iothub-connection-device-id olacaktır. IoT Tak Çalıştır cihaz modellerini kullanmayı planlıyorsanız veya bunları bileşenler olmadan kullanıyorsanız, gelecekte ihtiyacınız olması durumunda bileşik anahtarın bir parçası olarak dt-subject'ı eklemeniz gerekir.

İzleyebileceğiniz en iyi uygulamalar şunlardır:

  • Birçok farklı değere (örneğin, yüzlerce veya binlerce) sahip bir bölüm anahtarı seçin. Çoğu durumda bu, JSON'unuzda cihaz kimliği, algılayıcı kimliği veya etiket kimliği olabilir.
  • Zaman Serisi Kimliği, Zaman Serisi Modelinizin yaprak düğüm düzeyinde benzersiz olmalıdır.
  • Zaman Serisi Kimliği'nin özellik adı dizesi için karakter sınırı 128'dir. Zaman Serisi Kimliği'nin özellik değeri için karakter sınırı 1.024'dür.
  • Zaman Serisi Kimliği için benzersiz bir özellik değeri eksikse, null değer olarak değerlendirilir ve benzersizlik kısıtlamasının aynı kuralını izler.
  • Zaman Serisi Kimliğiniz karmaşık bir JSON nesnesi içinde iç içe yerleştirilmişse, özellik adınızı sağlarken giriş düzleştirme kurallarına uyduğundan emin olun. Örnek B'ye göz atın.
  • Zaman Serisi Kimliğiniz olarak en fazla üç anahtar özelliği de seçebilirsiniz. Bunların birleşimi, Zaman Serisi Kimliğini temsil eden bileşik bir anahtar olacaktır.

    Not

    Üç anahtar özelliğiniz dize olmalıdır. Bir kerede bir özellik yerine bu bileşik anahtara karşı sorgulamanız gerekir.

Birden fazla anahtar özelliği seçme

Aşağıdaki senaryolarda, Zaman Serisi Kimliğiniz olarak birden fazla anahtar özelliği seçme açıklanmaktadır.

Örnek 1: Benzersiz anahtara sahip Zaman Serisi Kimliği

  • Eski varlık filolarınız var. Her biri benzersiz bir anahtara sahiptir.
  • Bir filo , deviceId özelliği tarafından benzersiz olarak tanımlanır. Başka bir filo için benzersiz özellik objectId'dir. İki filo da diğer filonun benzersiz mülkiyetini içermiyor. Bu örnekte benzersiz anahtarlar olarak deviceId ve objectId olarak iki anahtar seçebilirsiniz.
  • Null değerleri kabul ediyoruz ve bir özelliğin olay yükünde bulunmaması null değer olarak sayılır. Bu ayrıca, her olay kaynağındaki verilerin benzersiz bir Zaman Serisi Kimliğine sahip olduğu iki olay kaynağına veri göndermeyi işlemek için de uygun bir yoldur.

Örnek 2: Bileşik anahtarla Zaman Serisi Kimliği

  • Birden çok özelliğin aynı varlık filosu içinde benzersiz olmasını gerektirir.
  • Akıllı binaların üreticisisiniz ve her odaya algılayıcı dağıtıyorsunuz. Her odada genellikle sensorId için aynı değerlere sahipsinizdir. Sensor1, sensor2 ve sensor3 örnek olarak verilebilir.
  • Binanızın, flrRm'deki siteler arasında kat ve oda numaraları çakışıyor. Bu sayılar 1a, 2b ve 3a gibi değerlere sahiptir.
  • Redmond, Barcelona ve Tokyo gibi değerleri içeren bir özelliğiniz, konumunuz var. Benzersizlik oluşturmak için şu üç özelliği Time Series ID anahtarlarınız olarak belirlersiniz: sensorId, flrRm ve location.

Örnek ham olay:

{
  "sensorId": "sensor1",
  "flrRm": "1a",
  "location": "Redmond",
  "temperature": 78
}

Azure portal bileşik anahtarı aşağıdaki gibi girebilirsiniz:

Ortam için Zaman Serisi Kimliğini yapılandırın.

Not

Azure portal bir ifade kutusuna özelliklerin virgülle ayrılmış adlarını girmeyin; aksi takdirde, virgül içeren tek bir özellik adı olarak değerlendirilir. Her özellik adını kendi ifade kutusuna girin.

Sonraki adımlar