Le sottoscrizioni Bigtable ti consentono di scrivere messaggi Pub/Sub in una tabella Bigtable. Questo documento fornisce una panoramica delle sottoscrizioni Bigtable, inclusi il flusso di lavoro della sottoscrizione, la semantica di pubblicazione e la gestione degli errori.
Per creare una sottoscrizione Bigtable, consulta Creare una sottoscrizione Bigtable.
Panoramica
Una sottoscrizione Bigtable è un tipo di sottoscrizione dell'esportazione che scrive i messaggi in una tabella Bigtable esistente alla ricezione. Utilizzando una sottoscrizione dell'esportazione, non devi configurare un client sottoscrittore separato.
Valuta la possibilità di utilizzare una sottoscrizione Bigtable se vuoi scrivere messaggi in Bigtable e i messaggi non richiedono un'elaborazione aggiuntiva o l'elaborazione può essere eseguita da una trasformazione di un singolo messaggio (SMT).
Se devi eseguire trasformazioni più complesse prima di scrivere i messaggi in Bigtable, ti consigliamo di utilizzare una pipeline Dataflow con una sottoscrizione pull. Per ulteriori informazioni, consulta Leggere da Pub/Sub a Dataflow.
Per ulteriori informazioni sulla scelta di un tipo di sottoscrizione Pub/Sub, consulta Scegliere un tipo di sottoscrizione.
Flusso di lavoro della sottoscrizione Bigtable
L'immagine seguente mostra il flusso di lavoro tra una sottoscrizione Bigtable e Bigtable.
Il flusso di lavoro è costituito dai seguenti passaggi:
Un publisher invia un messaggio a un argomento Pub/Sub.
Pub/Sub inoltra il messaggio alla sottoscrizione Bigtable.
La sottoscrizione invia una richiesta di scrittura a Bigtable. Nella richiesta di scrittura, la sottoscrizione specifica un profilo dell'app che utilizza il routing a cluster singolo.
Bigtable instrada il messaggio al cluster Bigtable che contiene la tabella.
La richiesta di scrittura viene eseguita nella tabella.
Al termine di un'operazione di scrittura, l'API Bigtable restituisce una risposta di successo.
Se un'operazione di scrittura non va a buon fine, viene gestita nel seguente modo:
Il messaggio Pub/Sub viene riconosciuto negativamente.
Pub/Sub invia di nuovo il messaggio.
Se il messaggio non va a buon fine un numero sufficiente di volte e nella sottoscrizione è configurato un argomento messaggi non recapitabili, il messaggio viene spostato nell'argomento messaggi non recapitabili.
Semantica di pubblicazione
Le sottoscrizioni Bigtable supportano la pubblicazione at-least-once. Se hai bisogno di una deduplicazione esatta dei messaggi, valuta la possibilità di implementare processi downstream per gestire i potenziali duplicati in Bigtable oppure utilizza le funzionalità di elaborazione exactly-once di Dataflow.
Gestire gli errori relativi ai messaggi
Se un messaggio Pub/Sub non può essere scritto in Bigtable, non può essere riconosciuto. Per inoltrare questi messaggi non recapitabili,
configura un
argomento messaggi non recapitabili nella
sottoscrizione Bigtable. Il messaggio Pub/Sub inoltrato all'argomento messaggi non recapitabili contiene un attributo denominato CloudPubSubDeadLetterSourceDeliveryErrorMessage che contiene il motivo dell'errore di scrittura.
Se Pub/Sub non riesce a scrivere i messaggi in Bigtable, allora Pub/Sub esegue il backoff della pubblicazione dei messaggi in modo simile al comportamento di backoff push.
Quote e limiti
Pub/Sub ha limitazioni di quota per la velocità effettiva del sottoscrittore Bigtable per regione. Per ulteriori informazioni, consulta Quote e limiti di Pub/Sub.
Per informazioni sui limiti di Bigtable, consulta Quote e limiti nella documentazione di Bigtable.
Prezzi
Per scoprire i prezzi delle sottoscrizioni Bigtable, consulta la pagina dei prezzi di Pub/Sub.