Documentação do Oracle Cloud Infrastructure

Consumindo Mensagens de uma Fila

Consumir mensagens de uma fila.

O consumo de mensagens exige permissões para a fila e acesso ao ponto final de Mensagens. Para obter mais informações, consulte Consumindo Mensagens.

Se a fila tiver canais, uma solicitação de consumo sem um ID de canal retornará mensagens da fila ou de um de seus canais.

Cuidado

A sondagem aumenta o valor da contagem de entregas da mensagem. Dependendo das definições da fila de cartas mortas, a sondagem pode remover a mensagem de uma fila ou canal e enviá-la para uma fila ou canal de mensagens não processadas.

  • Não é possível usar a Console para consumir mensagens, mas você pode usá-la para sondar mensagens. A sondagem de mensagens serve como uma view rápida da fila. As mensagens sondadas pela Console ficam indisponíveis para outros consumidores até que o timeout de visibilidade ocorra.

    1. Na página de lista Filas, selecione a fila com a qual deseja trabalhar. Se precisar de ajuda para localizar a página da lista ou a fila, consulte Listando filas.
    2. Na página de detalhes da fila, selecione Mensagens.
    3. (Opcional) Selecione Gerenciar definições de sondagem. Forneça as seguintes informações e selecione Atualizar:
      • Timeout de sondagem (segundos): O tempo de espera para que as mensagens sejam consumidas.
      • Número de mensagens em uma solicitação: O número máximo de mensagens a serem consumidas durante a sondagem.
    4. Selecione Fazer Roll for messages.
    5. Selecione Continuar.

      Se as mensagens estiverem disponíveis para consumo, elas serão exibidas na tabela Mensagens. As mensagens são examinadas aleatoriamente na fila ou em um de seus canais. As mensagens de um canal são exibidas com seu ID do Canal.

  • Use o comando oci queue messages get-messages e os parâmetros necessários para consumir mensagens de uma fila:

    oci queue messages get-messages --queue-id <queue_OCID>

    Para obter uma lista completa de parâmetros e valores para comandos da CLI, consulte a Referência de Comandos da CLI.

  • Use a operação GetMessages para consumir mensagens. Uma solicitação GetMessages contém um limit opcional, um visibilityInSeconds opcional e um parâmetro timeoutInSeconds opcional.

    Para obter informações sobre como usar a API e assinar solicitações, consulte a documentação da API REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte SDKs e a CLI.