Logboekcompressie gebruiken

In dit artikel wordt beschreven hoe u de functie voor logboekcompressie gebruikt in Event Hubs. Zie Logboekcompressie voor meer informatie over de details van logboekcompressie.

In dit artikel voert u de volgende belangrijke stappen uit:

• Maak een gecomprimeerd Event Hub/Kafka-onderwerp.
• Gebeurtenissen publiceren naar een gecomprimeerde Event Hub.
• Gebeurtenissen van een gecomprimeerde Event Hub gebruiken.

Notitie

De functie logboekcompressie wordt niet ondersteund in de Basic-laag .

Een gecomprimeerd Event Hub/Kafka-onderwerp maken

In deze sectie wordt beschreven hoe u een gecomprimeerde Event Hub maakt met behulp van Azure Portal en een ARM-sjabloon (Azure Resource Manager).

Azure-portal

U kunt een gecomprimeerde Event Hub maken met behulp van de Azure Portal door deze stappen uit te voeren.

1. Navigeer naar uw Event Hubs-naamruimte.
2. Op de pagina Event Hubs-naamruimte selecteert u Event Hubs in het menu links.
3. Selecteer bovenaan het venster + Event Hubs.
4. Typ een naam voor uw Event Hub en geef het aantal partities op. Omdat we een gecomprimeerde Event Hub maken, selecteert u compressiebeleid als compressie en geeft u de gewenste waarde op voor de retentietijd van tombstone.
5. Selecteer De gecomprimeerde Event Hub maken en maken.

ARM-sjabloon

In het volgende voorbeeld ziet u hoe u een gecomprimeerd Event Hub/Kafka-onderwerp maakt met behulp van een ARM-sjabloon.

"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"
      }
    }
  }
]

Compressie activeren

De Event Hubs-service bepaalt wanneer de compressietaak van een bepaalde gecomprimeerde Event Hub moet worden uitgevoerd. Gecomprimeerde Event Hub bereikt de compressiedrempel wanneer er een aanzienlijk aantal gebeurtenissen is of wanneer de totale grootte van een bepaald gebeurtenislogboek aanzienlijk toeneemt.

Gebeurtenis publiceren naar een gecomprimeerd onderwerp

Het publiceren van gebeurtenissen naar een gecomprimeerde Event Hub is hetzelfde als het publiceren van gebeurtenissen naar een reguliere Event Hub. Als clienttoepassing hoeft u alleen de compressiesleutel te bepalen, die u instelt met behulp van de partitiesleutel.

Event Hubs SDK (AMQP) gebruiken

Met de Event Hubs SDK kunt u de partitiesleutel instellen en gebeurtenissen publiceren, zoals hieronder wordt weergegeven:

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

Kafka gebruiken

Met Kafka kunt u de partitiesleutel instellen wanneer u de ProducerRecord maakt, zoals hieronder wordt weergegeven:

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

Quota en limieten

Limiet	Basic	Standard	Premium	Toegewezen
Grootte van gecomprimeerde Event Hub	N.v.t.	1 GB per partitie	250 GB per partitie	250 GB per partitie

Zie Quota en limieten voor Event Hubs voor andere quota en limieten.

Gebeurtenissen uit een gecomprimeerd onderwerp gebruiken

Er zijn geen wijzigingen vereist aan de kant van de consument om gebeurtenissen van een gecomprimeerde Event Hub te gebruiken. U kunt dus een van de bestaande consumententoepassingen gebruiken om gegevens uit een gecomprimeerde Event Hub te gebruiken.

Volgende stappen

• Zie Logboekcompressie voor conceptuele informatie over de werking van logboekcompressie.