Uso de la compactación de registros

En este artículo se muestra cómo usar la característica de compactación de registros en Event Hubs. Para comprender los detalles de la compactación de registros, consulte Compactación de registros.

En este artículo, seguirá estos pasos clave:

• Crear un centro de eventos compacto o un tema de Kafka.
• Publicar eventos en un centro de eventos compacto.
• Consumir eventos de un centro de eventos compacto.

Nota

La característica de compactación de registros no se admite en el nivel Básico.

Creación de un centro de eventos compacto o un tema de Kafka

En esta sección se muestra cómo crear un centro de eventos compacto mediante Azure Portal y una plantilla de Azure Resource Manager (ARM).

Azure Portal

Puede crear un centro de eventos compacto con Azure Portal siguiendo estos pasos.

1. Vaya al espacio de nombres de Event Hubs.
2. En la página Espacio de nombres de Event Hubs, seleccione Event Hubs en el menú de la izquierda.
3. Seleccione + Event Hubs en la parte superior de la ventana.
4. Escriba un nombre para el centro de eventos y especifique el recuento de particiones. Dado que estamos creando un centro de eventos compacto, seleccione la directiva de compactación como compactación y proporcione el valor deseado para el tiempo de retención del marcador de exclusión.
5. Seleccione Crear y cree el centro de eventos compacto.

Plantilla ARM

En el ejemplo siguiente se muestra cómo crear un centro de eventos compacto o un tema de Kafka mediante una plantilla de ARM.

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

Desencadenamiento de la compactación

El servicio Event Hubs determina cuándo se debe ejecutar el trabajo de compactación de un centro de eventos compacto determinado. El centro de eventos compactado alcanza el umbral de compactación cuando hay un número considerable de eventos o el tamaño total de un registro de eventos determinado crece significativamente.

Publicación de un evento en un tema compacto

La publicación de eventos en un centro de eventos compacto es la misma que la publicación de eventos en un centro de eventos normal. Como aplicación cliente, solo necesita determinar la clave de compactación, que se establece mediante la clave de partición.

Uso del SDK de Event Hubs (AMQP)

Con el SDK de Event Hubs, puede establecer la clave de partición y publicar eventos, como se muestra a continuación:

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

Uso de Kafka

Con Kafka puede establecer la clave de partición al crear ProducerRecord como se muestra a continuación:

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

Cuotas y límites

Límite	Básico	Estándar	Premium	Dedicado
Tamaño del centro de eventos compacto	N/D	1 GB por partición	250 GB por partición	250 GB por partición

Para otras cuotas y límites, consulte Cuotas y límites de Azure Event Hubs.

Consumo de eventos de un tema compacto

No se requieren cambios en el lado del consumidor para consumir eventos de un centro de eventos compacto. Por lo tanto, puede usar cualquiera de las aplicaciones de consumidor existentes para consumir datos de un centro de eventos compacto.

Pasos siguientes

• Para obtener información conceptual sobre cómo funciona la compactación de registros, consulte Compactación de registros.