Freigeben über

Bewährte Methoden für die Auswahl einer Zeitreihen-ID

  • Artikel

Anmerkung

Der Time Series Insights-Dienst wird am 7. Juli 2024 eingestellt. Erwägen Sie, vorhandene Umgebungen so schnell wie möglich zu alternativen Lösungen zu migrieren. Weitere Informationen zur Abschaffung und zur Migration finden Sie in unserer Dokumentation.

In diesem Artikel werden die Bedeutung der Zeitreihen-ID für Ihre Azure Time Series Insights Gen2-Umgebung und die bewährten Methoden zur Auswahl einer solchen ID zusammengefasst.

Zeitreihen-ID auswählen

Die Auswahl einer geeigneten Zeitreihen-ID ist wichtig. Das Auswählen einer Zeitreihen-ID ähnelt der Auswahl eines Partitionsschlüssels für eine Datenbank. Es ist erforderlich, wenn Sie eine Azure Time Series Insights Gen2-Umgebung erstellen.

Sehen Sie sich das Tutorial zur Umgebungsbereitstellung an, um eine ausführliche Einführung in die Zeitreihen-ID zu erhalten. Sie werden zwei verschiedene JSON-Telemetrienutzlastbeispiele und die richtige Auswahl der Zeitreihen-ID für jede anzeigen.

Wichtig

Zeitreihen-IDs sind:

  • Eine Eigenschaft einer Zeichenfolge mit Beachtung der Groß-/Kleinschreibung: Die Groß-/Kleinschreibung von Buchstaben und Zeichen wird bei Suchvorgängen, Vergleichen, Aktualisierungen und bei der Partitionierung verwendet.
  • Eine unveränderliche Eigenschaft: Nachdem sie erstellt wurde, kann sie nicht mehr geändert werden.

Tipp

Wenn Ihre Ereignisquelle ein IoT-Hub ist, wird Ihre Zeitreihen-ID wahrscheinlich iothub-connection-device-id. Wenn Sie planen, IoT Plug and Play-Gerätemodelle zu verwenden oder sie ohne Komponenten verwenden, sollten Sie dt-subject als Teil des zusammengesetzten Schlüssels einschließen, für den Fall, dass Sie ihn in Zukunft benötigen.

Zu den wichtigsten bewährten Methoden gehören:

  • Wählen Sie einen Partitionsschlüssel mit vielen unterschiedlichen Werten aus (z. B. Hunderte oder Tausende). In vielen Fällen kann dies die Geräte-ID, Sensor-ID oder Tag-ID in Ihrem JSON-Code sein.
  • Die Zeitreihen-ID sollte auf der Blattknotenebene Ihres Zeitreihenmodellseindeutig sein.
  • Die Zeichenbeschränkung für den Eigenschaftsnamen der Zeitreihen-ID beträgt 128. Für den Eigenschaftswert der Zeitreihen-ID beträgt der Zeichengrenzwert 1.024.
  • Wenn ein eindeutiger Eigenschaftswert für die Zeitreihen-ID fehlt, wird er als NULL-Wert behandelt und folgt der gleichen Regel der Eindeutigkeitseinschränkung.
  • Wenn Ihre Zeitreihen-ID in einem komplexen JSON-Objekt geschachtelt ist, achten Sie darauf, den Eingangs- Flachungsregeln zu folgen,, wenn Sie den Eigenschaftennamen angeben. Sehen Sie sich das Beispiel Ban.
  • Sie können auch bis zu drei Schlüsseleigenschaften als Zeitreihen-ID auswählen. Die Kombination wird ein zusammengesetzter Schlüssel sein, der die Zeitreihen-ID darstellt.

    Anmerkung

    Ihre drei Schlüsseleigenschaften müssen Zeichenfolgen sein. Sie müssen Anfragen an diesen zusammengesetzten Schlüssel stellen, anstatt eine Eigenschaft nach der anderen abzufragen.

Auswählen mehrerer Schlüsseleigenschaften

In den folgenden Szenarien wird beschrieben, wie Sie mehr als eine Schlüsseleigenschaft als Zeitreihen-ID auswählen.

Beispiel 1: Zeitreihen-ID mit einem eindeutigen Schlüssel

  • Sie haben Bestandsflotten von Vermögenswerten. Jeder hat einen eindeutigen Schlüssel.
  • Eine Flotte wird durch die Eigenschaft deviceIdeindeutig identifiziert. Für eine andere Flotte ist die einzigartige Eigenschaft objectId. Keine Flotte enthält das einzigartige Eigentum der anderen Flotte. In diesem Beispiel würden Sie zwei Schlüssel auswählen, deviceId und objectIdals eindeutige Schlüssel.
  • Wir akzeptieren Nullwerte, und das Fehlen einer Eigenschaft in der Ereignisnutzlast zählt als Nullwert. Dies ist auch die geeignete Methode, um Daten an zwei Ereignisquellen zu senden, wobei die Daten in jeder Quelle über eine eindeutige Zeitreihen-ID verfügen.

Beispiel 2: Zeitreihen-ID mit einem zusammengesetzten Schlüssel

  • Sie benötigen mehrere Eigenschaften, um innerhalb derselben Flotte von Vermögenswerten einzigartig zu sein.
  • Sie sind Hersteller intelligenter Gebäude und stellen Sensoren in jedem Raum bereit. In jedem Raum haben Sie typischerweise die gleichen Werte für sensorId. Beispiele sind Sensor1, Sensor2und Sensor3.
  • Ihr Gebäude hat überlappende Stockwerk- und Raumnummern über die Standorte im Anwesen hinweg flrRm. Diese Zahlen weisen Werte wie 1a, 2b-und 3a-auf.
  • Sie haben eine Eigenschaft, Lage, die Werte wie Redmond, Barcelonaund Tokyoenthält. Um Einzigartigkeit zu schaffen, legen Sie die folgenden drei Eigenschaften als Ihre Zeitreihen-ID-Schlüssel fest: sensorId, flrRmund Standort.

Beispiel für ein rohes Ereignis:

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

Im Azure-Portal können Sie dann den zusammengesetzten Schlüssel wie folgt eingeben:

Zeitreihen-ID für die Umgebung konfigurieren.

Anmerkung

Geben Sie im Azure-Portal keine durch Trennzeichen getrennten Namen von Eigenschaften in einem Texboxfeld ein, andernfalls wird sie als einzelner Eigenschaftsname behandelt, der Kommas enthält. Geben Sie jeden Eigenschaftennamen in ein eigenes Textfeld ein.

Nächste Schritte