Este documento fornece uma vista geral de uma subscrição de obtenção, do respetivo fluxo de trabalho e das propriedades associadas.
Numa subscrição de obtenção, um cliente subscritor pede mensagens ao servidor do Pub/Sub.
O modo de obtenção pode usar uma das duas APIs de serviço, Pull ou StreamingPull. Para executar a API escolhida, pode selecionar uma biblioteca de cliente de alto nível fornecida pela Google ou uma biblioteca de cliente de baixo nível gerada automaticamente. Também pode escolher entre o processamento de mensagens assíncrono e síncrono.
Antes de começar
Antes de ler este documento, certifique-se de que conhece o seguinte:
Como o Pub/Sub funciona e os diferentes termos do Pub/Sub.
Os diferentes tipos de subscrições que o Pub/Sub suporta e por que motivo pode querer usar uma subscrição de obtenção.
Fluxo de trabalho de subscrição de obtenção
Para uma subscrição de obtenção, o cliente subscritor inicia pedidos a um servidor do Pub/Sub para obter mensagens. O cliente subscritor usa uma das seguintes APIs:
A maioria dos clientes subscritores não faz estes pedidos diretamente. Em vez disso, os clientes confiam na biblioteca cliente de alto nível fornecida pela Google que executa pedidos de obtenção de streaming internamente e envia mensagens de forma assíncrona. Google CloudPara um cliente subscritor que necessita de maior controlo sobre a forma como as mensagens são extraídas, o Pub/Sub usa uma biblioteca gRPC de baixo nível e gerada automaticamente. Esta biblioteca faz pedidos de obtenção ou de obtenção de streaming diretamente. Estes pedidos podem ser síncronos ou assíncronos.
As duas imagens seguintes mostram o fluxo de trabalho entre um cliente subscritor e uma subscrição de obtenção.