Compartilhar via


CheckpointStore interface

Um repositório de ponto de verificação armazena e recupera informações de propriedade de partição e detalhes de ponto de verificação para cada partição em um determinado grupo de consumidores de uma instância do hub de eventos.

Os usuários não devem implementar um CheckpointStore. Espera-se que os usuários escolham implementações existentes dessa interface, instanciem-na e passem-na para o EventHubConsumerClient construtor de classe ao instanciar um cliente. Não se espera que os usuários usem nenhum dos métodos em um repositório de ponto de verificação, eles são usados internamente pelo cliente.

As implementações de CheckpointStore podem ser encontradas no npm pesquisando pacotes com o prefixo @azure/eventhub-checkpointstore-.

Métodos

claimOwnership(PartitionOwnership[], OperationOptions)

Chamado para reivindicar a propriedade de uma lista de partições. Isso retornará a lista de partições que foram pertencentes com êxito.

listCheckpoints(string, string, string, OperationOptions)

Lista todos os pontos de verificação em um armazenamento de dados para um determinado namespace, eventhub e grupo de consumidores.

listOwnership(string, string, string, OperationOptions)

Chamado para obter a lista de toda a propriedade de partição existente do armazenamento de dados subjacente. Pode retornar resultados vazios se não houver informações de propriedade existentes.

updateCheckpoint(Checkpoint, OperationOptions)

Atualizações o ponto de verificação no armazenamento de dados para uma partição.

Detalhes do método

claimOwnership(PartitionOwnership[], OperationOptions)

Chamado para reivindicar a propriedade de uma lista de partições. Isso retornará a lista de partições que foram pertencentes com êxito.

function claimOwnership(partitionOwnership: PartitionOwnership[], options?: OperationOptions): Promise<PartitionOwnership[]>

Parâmetros

partitionOwnership

PartitionOwnership[]

A lista de propriedade da partição que esta instância está reivindicando possuir.

options
OperationOptions

Um conjunto de opções que pode ser especificado para influenciar o comportamento desse método.

  • abortSignal: um sinal usado para solicitar o cancelamento da operação.
  • tracingOptions: opções para configurar o rastreamento.

Retornos

Promise<PartitionOwnership[]>

Uma lista de partições que esta instância reivindicou com êxito a propriedade.

listCheckpoints(string, string, string, OperationOptions)

Lista todos os pontos de verificação em um armazenamento de dados para um determinado namespace, eventhub e grupo de consumidores.

function listCheckpoints(fullyQualifiedNamespace: string, eventHubName: string, consumerGroup: string, options?: OperationOptions): Promise<Checkpoint[]>

Parâmetros

fullyQualifiedNamespace

string

O namespace totalmente qualificado dos Hubs de Eventos. É provável que isso seja semelhante a .servicebus.windows.net.

eventHubName

string

O nome do hub de eventos.

consumerGroup

string

O nome do grupo de consumidores.

options
OperationOptions

Um conjunto de opções que pode ser especificado para influenciar o comportamento desse método.

  • abortSignal: um sinal usado para solicitar o cancelamento da operação.
  • tracingOptions: opções para configurar o rastreamento.

Retornos

Promise<Checkpoint[]>

Uma lista de pontos de verificação para um determinado namespace, eventhub e grupo de consumidores.

listOwnership(string, string, string, OperationOptions)

Chamado para obter a lista de toda a propriedade de partição existente do armazenamento de dados subjacente. Pode retornar resultados vazios se não houver informações de propriedade existentes.

function listOwnership(fullyQualifiedNamespace: string, eventHubName: string, consumerGroup: string, options?: OperationOptions): Promise<PartitionOwnership[]>

Parâmetros

fullyQualifiedNamespace

string

O namespace totalmente qualificado dos Hubs de Eventos. É provável que isso seja semelhante a .servicebus.windows.net.

eventHubName

string

O nome do hub de eventos.

consumerGroup

string

O nome do grupo de consumidores.

options
OperationOptions

Um conjunto de opções que pode ser especificado para influenciar o comportamento desse método.

  • abortSignal: um sinal usado para solicitar o cancelamento da operação.
  • tracingOptions: opções para configurar o rastreamento.

Retornos

Promise<PartitionOwnership[]>

Uma lista de detalhes de propriedade da partição de todas as partições que têm/tinham um proprietário.

updateCheckpoint(Checkpoint, OperationOptions)

Atualizações o ponto de verificação no armazenamento de dados para uma partição.

function updateCheckpoint(checkpoint: Checkpoint, options?: OperationOptions): Promise<void>

Parâmetros

checkpoint
Checkpoint

O ponto de verificação.

options
OperationOptions

Um conjunto de opções que pode ser especificado para influenciar o comportamento desse método.

  • abortSignal: um sinal usado para solicitar o cancelamento da operação.
  • tracingOptions: opções para configurar o rastreamento.

Retornos

Promise<void>