Verwenden der Protokollkomprimierung

Artikel
08/02/2023

In diesem Artikel erfahren Sie, wie Sie die Protokollkomprimierungsfunktion in Event Hubs verwenden. Informationen zu den Details der Protokollkomprimierung finden Sie unter Protokollkomprimierung.

In diesem Artikel führen Sie die folgenden wichtigen Schritte aus:

Erstellen eines komprimierten Event Hub-/Kafka-Themas.
Veröffentlichen von Ereignissen in einer komprimierten Event Hub-Instanz.
Nutzen von Ereignissen in einer komprimierten Event Hub-Instanz.

Hinweis

Das Protokollkomprimierungsfeature wird im Basic-Tarif nicht unterstützt.

Erstellen eines komprimierten Event Hub-/Kafka-Themas

In diesem Abschnitt erfahren Sie, wie Sie mit dem Azure-Portal und einer ARM-Vorlage (Azure Resource Manager) einen komprimierten Event Hub erstellen.

Azure portal
ARM-Vorlage

Sie können mithilfe des Azure-Portals einen komprimierten Event Hub erstellen, indem Sie die folgenden Schritte ausführen.

Navigieren Sie zu Ihrem Event Hubs-Namespace.
Wählen Sie auf der Seite „Event Hubs-Namespace“ im linken Menü Event Hubs aus.
Wählen Sie oben im Fenster die Option „+ Event Hubs“ aus.
Geben Sie einen Namen für Ihren Event Hub ein, und geben Sie die Partitionsanzahl an. Da wir einen komprimierten Event Hub erstellen, wählen Sie Komprimierungsrichtlinie als Komprimierung aus, und geben Sie den gewünschten Wert für die Tombstone-Aufbewahrungszeit an.
Wählen Sie Erstellen aus, und erstellen Sie den komprimierten Event Hub.

Das folgende Beispiel zeigt, wie Sie mithilfe einer ARM-Vorlage ein komprimiertes Event Hub-/Kafka-Thema erstellen.

"resources": [
  {
    "apiVersion": "2017-04-01",
    "name": "[parameters('eventHubName')]",
    "type": "eventhubs",
    "dependsOn": [
      "[resourceId('Microsoft.EventHub/namespaces/', parameters('eventHubNamespaceName'))]"
    ],
    "properties": {
      "partitionCount": "[parameters('partitionCount')]",
      "retentionDescription": {
        "cleanupPolicy": "compact",
        "tombstoneRetentionTimeInHours": "24"
      }
    }
  }
]

Auslösen der Komprimierung

Der Event Hubs-Dienst bestimmt, wann der Komprimierungsauftrag eines bestimmten komprimierten Event Hubs ausgeführt werden soll. Der komprimierte Event Hub erreicht den Komprimierungsschwellenwert, wenn eine beträchtliche Anzahl von Ereignissen vorhanden ist oder die Gesamtgröße eines bestimmten Ereignisprotokolls erheblich zunimmt.

Veröffentlichen eines Ereignisses in einem komprimierten Thema

Das Veröffentlichen von Ereignissen in einem komprimierten Event Hub entspricht dem Veröffentlichen von Ereignissen in einem regulären Event Hub. Als Clientanwendung müssen Sie nur den Komprimierungsschlüssel bestimmen, den Sie mithilfe des Partitionsschlüssels festlegen.

Verwenden des Event Hubs SDK (AMQP)

Mit dem Event Hubs SDK können Sie den Partitionsschlüssel festlegen und Ereignisse wie unten gezeigt veröffentlichen:

var enqueueOptions = new EnqueueEventOptions
{
    PartitionKey = "Key-1"
    
};
await producer.EnqueueEventAsync(eventData, enqueueOptions);

Verwenden von Kafka

Mit Kafka können Sie den Partitionsschlüssel festlegen, wenn Sie den ProducerRecord wie unten gezeigt erstellen:

ProducerRecord<String, String> record = new ProducerRecord<String, String>(TOPIC, "Key-1" , "Value-1");

Kontingente und Grenzwerte

Begrenzung	Basic	Standard	Premium	Dediziert
Größe des komprimierten Event Hub	–	1 GB pro Partition	250 GB pro Partition	250 GB pro Partition

Informationen zu anderen Kontingenten und Grenzwerten finden Sie unter Kontingente und Grenzwerte in Event Hubs.

Verwenden von Ereignissen aus einem komprimierten Thema

Auf der Consumerseite sind keine Änderungen erforderlich, um Ereignisse aus einem komprimierten Event Hub zu nutzen. Sie können also jede der vorhandenen Consumeranwendungen verwenden, um Daten aus einem komprimierten Event Hub zu nutzen.

Nächste Schritte

Konzeptionelle Informationen zur Funktionsweise von Protokollkomprimierung finden Sie unter Protokollkomprimierung.

Teilen über