Configurar propriedades para um hub de eventos

Artigo
21/06/2023

Este artigo mostra como configurar propriedades como status, contagem de partições, tempo de retenção e etc. para um hub de eventos.

Configurar status

Você pode atualizar o status de um hub de eventos para um desses valores na página Propriedades após a criação do hub de eventos.

Selecione Ativo (padrão) se quiser enviar e receber eventos de e para um hub de eventos.
Selecione Desabilitado se você quiser desabilitar o envio e o recebimento de eventos de um hub de eventos.
Selecione SendDisabled se você quiser desabilitar o envio de eventos para um hub de eventos.

Configurar a contagem de partições

A página Propriedades permite que você veja o número de partições em um hub de eventos para hubs de eventos em todas as camadas. Nela, é possível atualizar a contagem de partições para hubs de eventos em uma camada premium ou dedicada. Para outras camadas, você só pode especificar a contagem de partições no momento da criação de um hub de eventos. Para saber mais sobre partições nos Hubs de Eventos, confira Escalabilidade

Configurar a política de limpeza

Você verá a política de limpeza de um hub de eventos na página Propriedades. Não é possível atualizá-la. Por padrão, os hubs de eventos são criados com a política de limpeza de exclusão, em que os eventos são limpos após a expiração do tempo de retenção. Ao criar um hub de eventos, você pode definir a política de limpeza como Compactar. Para obter mais informações, confira Compactação de log e Configurar compactação de log.

Configurar o tempo de retenção

Se a política de limpeza estiver definida como Excluir, o tempo de retenção será o tempo máximo pelo qual os Hubs de Eventos reterão um evento antes de descartar o evento. A página Propriedades permite que você especifique o tempo de retenção em horas.

Se a política de limpeza estiver definida como Compactar no momento da criação de um hub de eventos, o tempo de retenção infinito será habilitado automaticamente. No entanto, você pode definir o Tempo de retenção de marca de exclusão em horas. Os aplicativos cliente podem programar a exclusão de eventos existentes de um hub de eventos durante um trabalho de compactação enviando um novo evento com uma chave existente e uma carga de evento null. Esses marcadores são conhecidos como Marcas de exclusão. O Tempo de retenção de marca de exclusão em horas é o tempo para reter marcadores de marca de exclusão em um hub de eventos compactado.

CLI do Azure

Use o comando az eventhubs eventhub update para definir as configurações de contagem de partições e retenção para um hub de eventos.

Use o parâmetro --status para definir o status de um hub de eventos existente como Active, Disabled ou SendDisabled ou ReceiveDisabled.
Use o parâmetro --partition-count para especificar o número de partições. Você pode especificar a contagem de partições para um hub de eventos existente somente se ele estiver no namespace da camada premium ou dedicada.
Use o --retention-time para especificar o número de horas para reter eventos para um hub de eventos, se o cleanupPolicy for Delete.
Use o --tombstone-retention-time-in-hours para especificar o número de horas para manter os marcadores de marca de exclusão, se o cleanupPolicy for Compact.

Azure PowerShell

Use o Set-AzEventHub usando os parâmetros -Status, -RetentionTimeInHour ou TomstoneRetentionTimeInHour. Atualmente, o comando do PowerShell não dá suporte à atualização da contagem de partições para um hub de eventos.

Modelo do Azure Resource Manager

Se você estiver usando um modelo do Azure Resource Manager, use o partitionCount e retentionTimeinHours, conforme mostrado no exemplo a seguir. MYNAMESPACE é o nome do namespace dos Hubs de Eventos e MYEVENTHUB é o nome do hub de eventos neste exemplo.

JSON

{
	"type": "Microsoft.EventHub/namespaces/eventhubs",
	"apiVersion": "2022-10-01-preview",
	"name": "MYNAMESPACE/MYEVENTHUB ",
	"properties": {
		"partitionIds": [],
		"partitionCount": 1,
		"captureDescription": null,
		"retentionDescription": {
			"cleanupPolicy": "Delete",
			"retentionTimeInHours": 1
		}
	}
}

Próximas etapas

Veja os artigos a seguir:

Compartilhar via