Zaman Serisi Kimliği seçmek için en iyi uygulamalarBest practices for choosing a Time Series ID

Bu makale, Azure Time Series Insights Gen2 ortamınız için zaman serisi KIMLIĞININ önemini ve bir tane seçmek için en iyi yöntemleri özetler.This article summarizes the importance of the Time Series ID for your Azure Time Series Insights Gen2 environment, and best practices for choosing one.

Zaman Serisi KimliğiChoose a Time Series ID

Uygun bir zaman serisi KIMLIĞINI seçmek kritik öneme sahiptir.Selecting an appropriate Time Series ID is critical. Bir zaman serisi KIMLIĞI seçilmesi, bir veritabanı için bölüm anahtarı seçmeye benzer.Choosing a Time Series ID is like choosing a partition key for a database. Bir Azure Time Series Insights Gen2 ortamı oluşturduğunuzda bu gereklidir.It's required when you create an Azure Time Series Insights Gen2 environment.

Zaman serisi KIMLIĞININ ayrıntılı bir açıklaması için ortam sağlama öğreticisini izleyin.Watch the environment provisioning tutorial for a detailed explanation of the Time Series ID. İki farklı JSON telemetri yük örneği ve her biri için doğru zaman serisi KIMLIĞI seçimi görüntülenir.You'll view two different JSON telemetry payload examples and the correct Time Series ID selection for each.

Önemli

Zaman serisi kimlikleri şunlardır:Time Series IDs are:

  • Büyük/küçük harfe duyarlı bir özellik: harf ve karakter casler, aramalarda, karşılaştırmalar, güncelleştirmelerde ve bölümleme sırasında kullanılır.A case-sensitive property: letter and character casings are used in searches, comparisons, updates, and when partitioning.
  • Sabit bir özellik: oluşturulduktan sonra değiştirilemez.An immutable property: once created it cannot be changed.

İpucu

Olay kaynağınız bir IoT Hub ise, zaman serisi KIMLIĞINIZ büyük olasılıkla ıothub-Connection-Device-ID olacaktır.If your event source is an IoT hub, your Time Series ID will likely be iothub-connection-device-id.

İzlenecek en iyi anahtar uygulamalar şunlardır:Key best practices to follow include:

  • Birçok farklı değere sahip bir bölüm anahtarı seçin (örneğin, yüzlerce veya binlerce).Pick a partition key with many distinct values (for example, hundreds or thousands). Çoğu durumda bu, JSON 'unuzdaki cihaz KIMLIĞI, algılayıcı KIMLIĞI veya etiket KIMLIĞI olabilir.In many cases, this might be the device ID, sensor ID, or tag ID in your JSON.
  • Zaman serisi KIMLIĞI, zaman serisi modelinizinyaprak düğüm düzeyinde benzersiz olmalıdır.The Time Series ID should be unique at the leaf node level of your Time Series Model.
  • Zaman serisi KIMLIĞININ Özellik adı dizesinin karakter sınırı 128 ' dir.The character limit for the Time Series ID's property name string is 128. Zaman serisi KIMLIĞININ Özellik değeri için, karakter sınırı 1.024 ' dir.For the Time Series ID's property value, the character limit is 1,024.
  • 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ına uyar.If a unique property value for the Time Series ID is missing, it's treated as a null value and follows the same rule of the uniqueness constraint.
  • Zaman serisi KIMLIĞINIZ karmaşık bir JSON nesnesi içinde iç içe ise, özellik adınızı sağlarken giriş düzleştirme kurallarını izlediğinizden emin olun.If your Time Series ID is nested within a complex JSON object be sure to follow the ingress flattening rules when providing your property name. Örnek B'ye göz atın.Check out example B.
  • Zaman serisi KIMLIĞINIZ olarak en fazla üç anahtar özelliği de seçebilirsiniz.You can also select up to three key properties as your Time Series ID. Kombinasyonu, zaman serisi KIMLIĞINI temsil eden bir bileşik anahtar olacaktır.Their combination will be a composite key that represents the Time Series ID.

    Not

    Üç anahtar özelliği dize olmalıdır.Your three key properties must be strings. Tek seferde bir özellik yerine bu bileşik anahtarla sorgu yapmanız gerekir.You would have to query against this composite key instead of one property at a time.

Birden fazla anahtar özelliği seçinSelect more than one key property

Aşağıdaki senaryolar, zaman serisi KIMLIĞINIZ olarak birden fazla anahtar özelliği seçmeyi anlatmaktadır.The following scenarios describe selecting more than one key property as your Time Series ID.

Örnek 1: benzersiz bir anahtarla zaman serisi KIMLIĞIExample 1: Time Series ID with a unique key

  • Varlıkların eski varlıkları var.You have legacy fleets of assets. Her birinin benzersiz bir anahtarı vardır.Each has a unique key.
  • Bir filo özelliği DeviceID tarafından benzersiz şekilde tanımlanır.One fleet is uniquely identified by the property deviceId. Başka bir Fleet için, Unique özelliği ObjectID' dir.For another fleet, the unique property is objectId. Ne filo, diğer filo 'in benzersiz özelliğini içermez.Neither fleet contains the other fleet's unique property. Bu örnekte, benzersiz anahtarlar olarak iki anahtar, DeviceID ve ObjectID seçersiniz.In this example, you would select two keys, deviceId and objectId, as unique keys.
  • Null değerleri kabul ediyoruz ve bir özelliğin olay yükünde varlık olmaması, null değer olarak sayılır.We accept null values, and the lack of a property's presence in the event payload counts as a null value. Bu aynı zamanda, her olay kaynağındaki verilerin benzersiz bir zaman serisi KIMLIĞI olduğu iki olay kaynağına veri göndermeyi işlemenin uygun yoludur.This is also the appropriate way to handle sending data to two event sources where the data in each event source has a unique Time Series ID.

Örnek 2: bileşik bir anahtarla zaman serisi KIMLIĞIExample 2: Time Series ID with a composite key

  • Birden çok özelliği, varlıkların aynı yakıt kapsamında benzersiz olmasını gerektirir.You require multiple properties to be unique within the same fleet of assets.
  • Her odada akıllı binalar ve sensörler dağıtımı sunuyoruz.You're a manufacturer of smart buildings and deploy sensors in every room. Her odada, genellikle Sensorıd için aynı değerlere sahip olursunuz.In each room, you typically have the same values for sensorId. Örnekler şunlardır sensor1, Sensor2 ve SENSOR3.Examples are sensor1, sensor2, and sensor3.
  • Binasında, Flrrm özelliğindeki sitelerde zemin ve oda numaraları çakışıyor.Your building has overlapping floor and room numbers across sites in the property flrRm. Bu sayıların 1a, 2B ve 3A gibi değerleri vardır.These numbers have values such as 1a, 2b, and 3a.
  • Redmond, Barselona ve Tokyo gibi değerleri içeren bir özellik, konum vardır.You have a property, location, that contains values such as Redmond, Barcelona, and Tokyo. Benzersizlik oluşturmak için aşağıdaki üç özelliği zaman serisi KIMLIK anahtarlarınız olarak belirlersiniz: Sensorıd, flrrm ve Location.To create uniqueness, you designate the following three properties as your Time Series ID keys: sensorId, flrRm, and location.

Örnek Ham olay:Example raw event:

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

Azure portal, ardından bileşik anahtarı aşağıdaki gibi girebilirsiniz:In the Azure portal, you can then enter the composite key as follows:

Ortam için zaman serisi KIMLIĞINI yapılandırın.Configure Time Series ID for the environment.

Not

Azure portal, tek bir texbox içindeki özelliklerin virgülle ayrılmış adlarını girmeyin, aksi takdirde virgüller içeren tek bir özellik adı olarak kabul edilir.In Azure portal, don't enter comma-separated names of properties in one texbox, otherwise, it will be treated as a single property name that contains commas. Her özellik adını kendi texbox olarak girin.Enter each property name in its own texbox.

Sonraki adımlarNext steps