SendEventOptions.PartitionKey Eigenschaft

Definition

Namespace:

Azure.Messaging.EventHubs.Producer

Assembly:

Azure.Messaging.EventHubs.dll

Paket:

Azure.Messaging.EventHubs v5.11.3

Quelle:

SendEventOptions.cs

Ermöglicht die Bereitstellung eines Hashingschlüssels für den Batch von Ereignissen, wodurch Event Hubs angewiesen wird, den Schlüssel einer automatisch zugewiesenen Partition zuzuordnen.

Die Auswahl einer Partition ist für einen bestimmten Partitionsschlüssel stabil. Wenn andere Ereignisse mit demselben genauen Partitionsschlüssel veröffentlicht werden, weist Event Hubs ihnen die gleiche Partition zu.

Der Partitionsschlüssel sollte angegeben werden, wenn Ereignisse gruppiert werden müssen, aber die Partition, der sie zugewiesen sind, ist nicht wichtig. Wenn Sichergestellt wird, dass einem Batch von Ereignissen eine bestimmte Partition zugewiesen wird, empfiehlt es sich, stattdessen die PartitionId zuzuweisen.

public string PartitionKey { get; set; }

member this.PartitionKey : string with get, set

Public Property PartitionKey As String

Eigenschaftswert

String

Ein -Wert, der verwendet werden kann, um Ereignisse zu identifizieren, die in derselben Partition veröffentlicht werden sollen. Wenn der Wert nullist, werden die Ereignisse entweder den angegebenen PartitionId wert oder automatisch einer Partition zugewiesen.

Der Standardpartitionsschlüsselwert ist null.

Hinweise

Wenn angegeben PartitionKey ist, kann beim Senden keine PartitionId festgelegt werden.