Freigeben über

Erweiterungstags

Wechseln Von Diensten mithilfe der Dropdownliste "Version ". Weitere Informationen zur Navigation.
Gilt für: ✅ Microsoft Fabric ✅ Azure Data Explorer

Ein Erweiterungstag ist eine Zeichenfolge, die Eigenschaften beschreibt, die allen Daten in einem Umfang gemeinsam sind. Beispielsweise können Sie während der Datenaufnahme ein Erweiterungstag anfügen, um die Quelle der aufgenommenen Daten zu kennzeichnen. Anschließend können Sie dieses Tag für die Analyse verwenden.

Erweiterungen können mehrere Tags als Teil ihrer Metadaten enthalten. Wenn Erweiterungen zusammengeführt werden, werden ihre Tags ebenfalls zusammengeführt, wodurch eine konsistente Metadatendarstellung sichergestellt wird.

Verwenden Sie den Befehl ".show extents", um die tags anzuzeigen, die einem Umfang zugeordnet sind. Verwenden Sie für eine granulare Ansicht von Tags, die Datensätzen innerhalb eines Umfangs zugeordnet sind, die Funktion "extent-tags() ".

Wichtig

Tags beginnen mit drop-by: oder ingest-by: tragen bestimmte Bedeutungen. Weitere Informationen finden Sie unter Drop-by-Extent-Tags und Ingest-by-Extent-Tags.

drop-by Extent-Tags

Tags, die mit einem drop-by: Präfix beginnen, können verwendet werden, um zu steuern, mit welchem anderen Umfang eine Zusammenführung erfolgt. Erweiterungen, die denselben Satz von drop-by: Tags aufweisen, können zusammengeführt werden, aber sie werden nicht mit anderen Ausmaßen zusammengeführt, wenn sie über einen anderen Satz von drop-by: Tags verfügen.

Hinweis

  • Vermeiden Sie übermäßige Verwendung von drop-by Tags.
  • Diese Tags sollten nicht verwendet werden, um einzelne Daten auf Datensatzebene zu ersetzen, und sie sind am effektivsten, wenn sie auf große Datenmengen angewendet werden.
  • Das Zuweisen eindeutiger drop-by Tags zu einzelnen Datensätzen oder Dateien kann sich erheblich auf die Leistung auswirken.

Beispiele

Ermitteln, welche Ausmaße zusammen zusammengeführt werden können

Wenn:

  • Umfang 1 hat die folgenden Tags: drop-by:blue, drop-by:red, green.
  • Umfang 2 hat die folgenden Tags: drop-by:red, yellow.
  • Umfang 3 hat die folgenden Tags: purple, drop-by:red, drop-by:blue.

Führen Sie dann folgende Schritte aus:

  • 1 und 2 werden nicht zusammengeführt, da sie über einen anderen Satz von drop-by Tags verfügen.
  • 2 und 3 werden nicht zusammengeführt, da sie über eine andere Gruppe von drop-by Tags verfügen.
  • Ausmaße 1 und 3 können zusammengeführt werden, da sie über dieselbe Gruppe von drop-by Tags verfügen.

Verwenden von drop-by Tags als Teil von Vorgängen auf Umfangsebene

Die folgende Abfrage gibt einen Befehl aus, der entsprechend ihrem drop-by: Tag soweit abzulegen ist.

.ingest ... with @'{"tags":"[\"drop-by:2016-02-17\"]"}'

.drop extents <| .show table MyTable extents where tags has "drop-by:2016-02-17"

ingest-by Extent-Tags

Tags mit dem Präfix ingest-by: können zusammen mit der ingestIfNotExists Eigenschaft verwendet werden, um sicherzustellen, dass Daten nur einmal aufgenommen werden.

Die ingestIfNotExists Eigenschaft verhindert doppelte Aufnahme, indem überprüft wird, ob bereits ein Umfang mit dem angegebenen ingest-by: Tag vorhanden ist. In der Regel enthält ein Aufnahmebefehl ein ingest-by: Tag und die ingestIfNotExists Eigenschaft mit demselben Wert.

Hinweis

  • Vermeiden Sie übermäßige Verwendung von ingest-by Tags.
  • Das Zuweisen eindeutiger ingest-by Tags für jeden Aufnahmeaufruf kann die Leistung erheblich beeinträchtigen.
  • Wenn die Pipeline bekannt ist, dass Datenduplizierungen vorhanden sind, empfehlen wir, diese Duplizierungen vor dem Aufnehmen von Daten zu lösen.

Beispiele

Hinzufügen eines Tags beim Aufnehmen

Mit dem folgenden Befehl werden die Daten aufgenommen und das Tag ingest-by:2016-02-17hinzugefügt.

.ingest ... with (tags = '["ingest-by:2016-02-17"]')

Verhindern der doppelten Aufnahme

Mit dem folgenden Befehl werden die Daten aufgenommen, solange in der Tabelle kein Umfang vorhanden ingest-by:2016-02-17 ist.

.ingest ... with (ingestIfNotExists = '["2016-02-17"]')

Verhindern der doppelten Erfassung und Hinzufügen eines Tags zu neuen Daten

Mit dem folgenden Befehl werden die Daten aufgenommen, solange in der Tabelle kein Umfang vorhanden ingest-by:2016-02-17 ist. Alle neu aufgenommenen Daten erhalten das ingest-by:2016-02-17 Tag.

.ingest ... with (ingestIfNotExists = '["2016-02-17"]', tags = '["ingest-by:2016-02-17"]')

Begrenzungen

  • Umfangstags können nur in einem Umfang auf Datensätze angewendet werden. Daher können Tags nicht für Streamingaufnahmedaten festgelegt werden, bevor sie in Ausmaßen gespeichert werden.
  • Umfangstags können nicht in Daten in externen Tabellen oder materialisierten Ansichten gespeichert werden.

Zugehöriger Inhalt

  • Last updated on