Questa pagina descrive le proprietà comuni a tutti i tipi di abbonamento Pub/Sub. Puoi impostare queste proprietà quando crei o aggiorni un abbonamento.
Tempo di conservazione dei messaggi
L'opzione Durata conservazione messaggi specifica per quanto tempo Pub/Sub conserva i messaggi dopo la pubblicazione. Al termine del periodo di conservazione dei messaggi, Pub/Sub potrebbe eliminare il messaggio indipendentemente dallo stato di conferma del messaggio. Per conservare i messaggi confermati per la durata di conservazione dei messaggi, vedi Riproduzione e eliminazione dei messaggi.
Di seguito sono riportati i valori per l'opzione Durata della conservazione dei messaggi:
- Valore predefinito = 7 giorni
- Valore minimo = 10 minuti
- Valore massimo = 31 giorni
I messaggi non confermati possono essere il risultato di sottoscrizioni inattive, esigenze di backup o elaborazione lenta. Se riesci a elaborare i messaggi entro 24 ore, non vengono addebitati costi aggiuntivi. Puoi evitare nuovi addebiti gestendo questi scenari nel seguente modo:
Abbonamenti inattivi. Elimina gli abbonamenti inattivi per evitare addebiti per la conservazione dei messaggi di abbonamento.
Spazio di archiviazione dei backup. Se utilizzi la conservazione delle sottoscrizioni come spazio di archiviazione di backup, puoi passare a un'altra opzione di archiviazione, ad esempio la conservazione dei messaggi degli argomenti o la conservazione dei messaggi confermati. La conservazione dei messaggi dell'argomento memorizza i messaggi una sola volta a livello di argomento e rimangono disponibili per tutte le sottoscrizioni da utilizzare quando necessario.
Ritardi nell'elaborazione. Aggiungi altri abbonati (se possibile) per elaborare i messaggi entro un giorno.
Conserva messaggi confermati
Se specifichi la durata di conservazione dei messaggi, puoi anche specificare se vuoi conservare i messaggi confermati.
L'opzione Conserva i messaggi confermati ti consente di conservare i messaggi confermati per la durata di conservazione dei messaggi specificata. Questa opzione aumenta le tariffe di archiviazione dei messaggi. Per maggiori informazioni, consulta la pagina Costi di archiviazione.
Periodo di scadenza
L'opzione Periodo di scadenza ti consente di estendere il periodo di scadenza del tuo abbonamento.
Gli abbonamenti senza attività o modifiche apportate alle proprietà dell'abbonamento scadono. Se Pub/Sub rileva l'attività dei sottoscrittori o se aggiorni una delle proprietà della sottoscrizione, il conto alla rovescia per l'eliminazione della sottoscrizione riparte. Esempi di attività dell'abbonato includono connessioni aperte, pull attivi o push riusciti.
Se specifichi il periodo di scadenza, il valore deve essere almeno pari alla durata della conservazione dei messaggi specificata nell'opzione Durata della conservazione dei messaggi.
Di seguito sono riportati i valori per l'opzione Periodo di scadenza:
- Valore predefinito = 31 giorni
- Valore minimo = 1 giorno
Per evitare che una sottoscrizione scada, imposta il periodo di scadenza su never expire.
Scadenza per la conferma
L'opzione Scadenza della conferma specifica la scadenza iniziale dopo la quale un messaggio non confermato viene inviato di nuovo. Puoi estendere la scadenza dell'acknowledgement per singolo messaggio inviando richieste ModifyAckDeadline successive.
Di seguito sono riportati i valori per l'opzione Termine di conferma:
- Valore predefinito = 10 secondi
- Valore minimo = 10 secondi
- Valore massimo = 600 secondi
In alcuni casi, le librerie client Pub/Sub possono
controllare la velocità di pubblicazione e modificare dinamicamente la scadenza dell'acknowledgement.
In questo modo, il messaggio potrebbe essere recapitato nuovamente prima della scadenza
della conferma che hai impostato. Per eseguire l'override di questo comportamento, utilizza minDurationPerAckExtension
e maxDurationPerAckExtension. Per saperne di più sull'utilizzo di questi valori, consulta
Supporto della pubblicazione esattamente una volta nelle librerie client.
Trasformazioni di messaggi singoli (SMT)
Le SMT consentono modifiche leggere agli attributi e ai dati dei messaggi direttamente in Pub/Sub. Questa funzionalità consente la pulizia, il filtraggio o la conversione del formato dei dati prima che i messaggi vengano inviati a un client abbonato.
Per saperne di più, consulta Panoramica degli SMT e Creare un abbonamento con gli SMT.
Filtro sottoscrizioni
Utilizza l'opzione Filtro sottoscrizioni per specificare una stringa con un'espressione di filtro. Se un abbonamento ha un filtro, vengono inviati solo i messaggi che corrispondono al filtro. Il servizio Pub/Sub riconosce automaticamente i messaggi che non corrispondono al filtro.
Puoi filtrare i messaggi in base ai rispettivi attributi, ma non in base ai dati contenuti nel messaggio.
Se non specificato, l'abbonamento non filtra i messaggi e gli abbonati ricevono tutti i messaggi.
I filtri non possono essere modificati o rimossi dopo l'applicazione.
Quando ricevi i messaggi da una sottoscrizione con un filtro, non ti vengono addebitati costi di traffico in uscita per i messaggi che Pub/Sub riconosce automaticamente. Per questi messaggi sono previsti costi di consegna dei messaggi e tariffe per l'archiviazione correlate alla ricerca.
Per ulteriori informazioni, vedi Filtrare i messaggi di un abbonamento.
Ordinamento messaggi
Per impostazione predefinita, Pub/Sub potrebbe non recapitare i messaggi nell'ordine in cui vengono pubblicati. Se l'ordinamento dei messaggi è abilitato per un abbonamento, tutti i messaggi inviati nella stessa regione, con la stessa chiave di ordinamento, vengono ricevuti nell'ordine in cui sono stati pubblicati.
Affinché i messaggi vengano ricevuti in ordine, il publisher deve impostare la chiave di ordinamento. I messaggi senza una chiave di ordinamento potrebbero non essere ricevuti in ordine.
Quando utilizzi la distribuzione ordinata, le conferme di ricezione dei messaggi successivi non vengono elaborate finché non vengono elaborate le conferme di ricezione dei messaggi precedenti. Per ulteriori informazioni, consulta la sezione Messaggi di ordine.
Argomento messaggi non recapitabili
Quando un messaggio non può essere consegnato dopo un numero prestabilito di tentativi di consegna o un abbonato non può confermare la ricezione del messaggio, Pub/Sub può ripubblicare il messaggio in un argomento messaggi non recapitabili configurato.
Se imposti un argomento messaggi non recapitabili, puoi anche specificare il numero massimo di tentativi di consegna. Il valore predefinito è 5 tentativi di consegna. Puoi impostare il numero massimo di tentativi su qualsiasi numero compreso tra 5 e 100, inclusi.
Se l'argomento messaggi non recapitabili si trova in un progetto diverso dall'abbonamento, devi specificare anche l'ID progetto con l'argomento dei argomento messaggi non recapitabili.
Per saperne di più, consulta la sezione Argomenti messaggi non recapitati.
Policy di ripetizione
Se la scadenza di conferma scade o un abbonato risponde con una conferma negativa, Pub/Sub può inviare nuovamente il messaggio. Questo tentativo di nuova consegna è noto come criterio di ripetizione dell'abbonamento.
Per impostazione predefinita, la policy di ripetizione per un abbonamento è impostata per utilizzare Riprova immediatamente. Con questa opzione, Pub/Sub invia nuovamente il messaggio quando scade il termine di conferma o un sottoscrittore risponde con una conferma negativa.
Puoi anche impostare il valore su Esegui nuovo tentativo dopo ritardo backoff esponenziale. In questo caso, devi specificare i valori di backoff massimo e minimo.
Ecco alcune linee guida per impostare i valori di backoff massimo e minimo:
Se imposti il valore massimo per la durata del backoff, il valore predefinito per la durata minima del backoff è 10 secondi.
Se imposti il valore minimo per la durata del backoff, il valore predefinito per la durata massima del backoff è 600 secondi.
La durata massima del backoff che puoi specificare è 600 secondi.
Policy di ripetizione e messaggi batch
Se i messaggi sono in un batch, Pub/Sub avvia il backoff esponenziale quando si verifica una delle seguenti condizioni:
Il sottoscrittore invia un riconoscimento negativo per ogni messaggio nel batch.
La scadenza per la conferma scade.
Policy di ripetizione e sottoscrizione push
Se ricevi messaggi da una sottoscrizione push, Pub/Sub potrebbe riconsegnare i messaggi dopo il backoff push anziché il backoff esponenziale. Quando il backoff push è più lungo della durata del backoff esponenziale, Pub/Sub recapita nuovamente i messaggi non confermati dopo il backoff push.