Usare la compattazione dei log

Articolo
08/02/2023

Questo articolo illustra come usare la funzionalità di compattazione dei log in Hub eventi. Per comprendere i dettagli della compattazione dei log, vedere Compattazione log.

In questo articolo seguire questa procedura chiave:

Creare un argomento hub eventi compattato/Kafka.
Pubblicare eventi in un hub eventi compattato.
Usare gli eventi da un hub eventi compattato.

Nota

La funzionalità di compattazione log non è supportata nel livello Basic .

Creare un argomento dell'hub eventi compattato/Kafka

Questa sezione illustra come creare un hub eventi compattato usando portale di Azure e un modello di Azure Resource Manager (ARM).

Azure portal
Modello ARM

È possibile creare un hub eventi compattato usando il portale di Azure seguendo questa procedura.

Passare allo spazio dei nomi hub eventi.
Nella pagina dello spazio dei nomi degli hub eventi selezionare Hub eventi nel menu a sinistra.
Nella parte superiore della finestra selezionare + Hub eventi.
Digitare un nome per l'hub eventi e specificare il conteggio delle partizioni. Poiché si sta creando un hub eventi compattato, selezionare criteri di compattazione come compattazione e fornire il valore desiderato per il tempo di conservazione della pietra tombale.
Selezionare crea e crea l'hub eventi compattato.

Nell'esempio seguente viene illustrato come creare un argomento hub eventi compattato/Kafka usando un modello di Resource Manager.

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

Attivazione della compattazione

Il servizio Hub eventi determina quando deve essere eseguito il processo di compattazione di un determinato hub eventi compattato. L'hub eventi compattato raggiunge la soglia di compattazione quando si verifica un numero considerevole di eventi o la dimensione totale di un determinato registro eventi aumenta significativamente.

Pubblicare l'evento in un argomento compattato

La pubblicazione di eventi in un hub eventi compattato è uguale a quella di pubblicazione di eventi in un hub eventi regolare. Poiché l'applicazione client è necessaria solo per determinare la chiave di compattazione impostata usando la chiave di partizione.

Uso di Hub eventi SDK(AMQP)

Con Event Hubs SDK è possibile impostare la chiave di partizione e pubblicare eventi, come illustrato di seguito:

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

Uso di Kafka

Con Kafka è possibile impostare la chiave di partizione quando si crea l'oggetto ProducerRecord come illustrato di seguito:

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

Quote e limiti

Limite	Basic	Standard	Premium	Dedicato
Dimensioni dell'hub eventi compattato	N/D	1 GB per partizione	250 GB per partizione	250 GB per partizione

Per altre quote e limiti, vedere Quote e limiti di Hub eventi.

Utilizzo di eventi da un argomento compattato

Non sono necessarie modifiche sul lato consumer per l'utilizzo di eventi da un hub eventi compattato. È quindi possibile usare una delle applicazioni consumer esistenti per usare i dati da un hub eventi compattato.

Passaggi successivi

Per informazioni concettuali sul funzionamento della compattazione dei log, vedere Compattazione log.

Condividi tramite