Una sottoscrizione Cloud Storage è un tipo di sottoscrizione per l'esportazione che scrive i messaggi in un bucket Cloud Storage esistente come quando vengono ricevuti. Non è necessario configurare un client sottoscrittore separato. Utilizza la console Google Cloud, Google Cloud CLI, le librerie client o l'API Pub/Sub per creare, aggiornare, elencare, scollegare o eliminare abbonamento a Cloud Storage.
Senza il tipo di sottoscrizione Cloud Storage, è necessaria una sottoscrizione pull o push e un sottoscrittore (ad esempio Dataflow) che legga i messaggi e li scriva in un bucket Cloud Storage. L'overhead associato all'esecuzione di Il job Dataflow non è necessario quando i messaggi non richiedono ulteriori elaborazioni prima di archiviarle in un bucket Cloud Storage; puoi usare un abbonamento a Cloud Storage.
Tuttavia, è comunque consigliabile una pipeline Dataflow per i sistemi Pub/Sub in cui è richiesta una certa trasformazione dei dati prima che vengano archiviati in un bucket Cloud Storage.
per scoprire come trasmettere dati in modalità flusso da Pub/Sub Cloud Storage con trasformazione tramite Dataflow, consulta Flusso di messaggi da Pub/Sub con Dataflow.
Prima di iniziare
Prima di leggere questo documento, assicurati di acquisire familiarità con quanto segue:
Come funziona Pub/Sub e il diversi termini di Pub/Sub.
Quali sono i diversi tipi di abbonamenti e perché potresti voler usare un abbonamento a Cloud Storage.
Come funziona Cloud Storage.
Flusso di lavoro della sottoscrizione a Cloud Storage
L'immagine seguente mostra il flusso di lavoro tra un'istanza di Cloud Storage abbonamento e Cloud Storage.
Figura 1. Flusso di lavoro per una sottoscrizione Cloud Storage
Ecco una breve descrizione del flusso di lavoro che fa riferimento alla Figura 1:
Pub/Sub utilizza l'API Cloud Storage per inviare dati al bucket Cloud Storage. Al termine di un'operazione di scrittura, l'API restituisce una risposta
OK
.I messaggi vengono inviati in batch al bucket Cloud Storage. Un singolo batch corrisponde a un oggetto archiviato nel bucket Cloud Storage. Puoi configurare le impostazioni collettive in base alle dimensioni dell'oggetto e al tempo trascorso dalla sua creazione.
Il flusso di lavoro per scrivere un oggetto in un bucket Cloud Storage richiede due risposte
OK
. La prima rispostaOK
viene inviata quando un messaggio viene scritto correttamente in un oggetto. La seconda rispostaOK
viene inviata quando contenente il messaggio sia finalizzato. Un messaggio diventa visibile soltanto nel bucket dopo che l'oggetto Cloud Storage che lo contiene è stato finalizzato correttamente.Se si verificano errori durante l'operazione di scrittura, il messaggio Pub/Sub stesso viene riconosciuto negativamente. Il messaggio viene quindi inviato di nuovo. Se l'operazione di scrittura del messaggio non riesce un numero sufficiente di volte e hai configurato un argomento messaggi non recapitabili nell'abbonamento, il messaggio viene spostato nell'argomento messaggi non recapitabili.
Proprietà di una sottoscrizione Cloud Storage
Quando crei un abbonamento Cloud Storage, devi specificare alcune proprietà aggiuntive. Queste proprietà includono proprietà comuni degli abbonamenti, requisiti per nome file e formato, requisiti di archiviazione e altro ancora. Per saperne di più su queste proprietà, consulta Proprietà degli abbonamenti a Cloud Storage.
Autorizzazioni dell'account di servizio Pub/Sub
Per creare una sottoscrizione Cloud Storage, L'account di servizio Pub/Sub deve disporre dell'autorizzazione per scrivere un bucket Cloud Storage specifico e leggere i metadati del bucket.
Per ulteriori informazioni, vedi Assegna i ruoli di Cloud Storage all'account di servizio Pub/Sub.
Gestire gli errori relativi ai messaggi
Quando non è possibile scrivere un messaggio Pub/Sub in un bucket Cloud Storage, il messaggio non può essere confermato. Per inoltrare questi messaggi non recapitabili, configura un argomento messaggi non recapitabili nell'abbonamento a Cloud Storage.
Se Pub/Sub non riesce a scrivere messaggi in Cloud Storage, ritira il recapito dei messaggi in modo simile al comportamento di backoff push.
Quote
Alla velocità effettiva del sottoscrittore di Cloud Storage si applicano limitazioni di quota per ogni regione. Per informazioni sulle quote per Cloud Storage Consulta i limiti di quota degli abbonati in Quote e limiti di Pub/Sub.
Prezzi
Per informazioni sui prezzi degli abbonamenti Cloud Storage, consulta la pagina dei prezzi di Pub/Sub.
Passaggi successivi
Crea un abbonamento a Cloud Storage.
Esplora gli strumenti di configurazione di Pub/Sub: