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

Not

Time Series Insights hizmeti 7 Temmuz 2024'te kullanımdan kaldırılacaktır. Mevcut ortamları 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 Time Series Id'nin önemi ve bir tane seçmek için en iyi yöntemler özetlanmaktadır.

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. Bir 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 biri için 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 temel yöntemler ş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.
  • Time Series Id'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 kabul edilir ve benzersizlik kısıtlamasının aynı kuralına uyar.
  • 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. B örneğine göz atın.
  • Zaman Serisi Kimliğiniz olarak en fazla üç anahtar özellik 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çin

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

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

  • Eski varlık filolarınız var. Her birinin benzersiz bir anahtarı vardır.
  • 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 özelliğini 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şlemenin de uygun yoludur.

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

  • Birden çok özelliğin aynı varlık filosu içinde benzersiz olması gerekir.
  • Akıllı binaların üreticisisiniz ve her odaya algılayıcılar dağıtıyorsunuz. Her odada genellikle sensorId için aynı değerlere sahipsinizdir. Sensor1, sensor2 ve sensor3 örnekleri verilmiştir.
  • Binanız, mülk flrRm'deki siteler arasında çakışan kat ve oda numaralarına sahip. 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ında bileşik anahtarı aşağıdaki gibi girebilirsiniz:

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

Not

Azure portalında, özelliklerin virgülle ayrılmış adlarını bir ifade kutusuna 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