Abbonamenti a Cloud Storage

Una sottoscrizione Cloud Storage è un tipo di sottoscrizione dell'esportazione che scrive i messaggi in un bucket Cloud Storage esistente alla ricezione. 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 un abbonamento 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 dell'esecuzione di un job Dataflow non è necessario quando i messaggi non richiedono un'elaborazione aggiuntiva prima di essere archiviati in un bucket Cloud Storage. Puoi utilizzare una sottoscrizione 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 in streaming i dati da Pub/Sub a Cloud Storage con trasformazione utilizzando Dataflow, consulta Trasmetti flussi di messaggi da Pub/Sub utilizzando Dataflow.

Prima di iniziare

Prima di leggere questo documento, assicurati di conoscere quanto segue:

Flusso di lavoro dell'abbonamento Cloud Storage

L'immagine seguente mostra il flusso di lavoro tra un abbonamento Cloud Storage e Cloud Storage.

Flusso di messaggi per una sottoscrizione 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:

  1. Pub/Sub utilizza l'API Cloud Storage per inviare i dati al bucket Cloud Storage. Al termine di un'operazione di scrittura, l'API restituisce una risposta OK.

  2. 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 batch in base alle dimensioni dell'oggetto e al tempo trascorso dalla sua creazione.

  3. Il flusso di lavoro per scrivere un oggetto in un bucket Cloud Storage richiede due risposte OK. La prima risposta OK viene inviata quando un messaggio viene scritto correttamente in un oggetto. La seconda risposta OK viene inviata quando l'oggetto contenente il messaggio viene finalizzato. Un messaggio diventa visibile nel bucket solo dopo che l'oggetto Cloud Storage che lo contiene è stato completato correttamente.

  4. 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 un abbonamento a 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à delle sottoscrizioni Cloud Storage.

Autorizzazioni dell'account di servizio Pub/Sub

Per creare un abbonamento Cloud Storage, l'account di servizio Pub/Sub deve disporre dell'autorizzazione per scrivere nel bucket Cloud Storage specifico e leggere i metadati del bucket.

Per ulteriori informazioni, consulta Assegnare 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

Le limitazioni di quota si applicano alla velocità effettiva dei sottoscrittori di Cloud Storage per ogni regione. Per informazioni sulle quote per gli abbonamenti Cloud Storage, consulta i limiti di quota degli abbonati all'esportazione 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