Abbonamenti 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 di sottoscrizione separato. Utilizza la Google Cloud console, Google Cloud CLI, le librerie client o l'API Pub/Sub per creare, aggiornare, elencare, scollegare o eliminare un abbonamento per l'archiviazione Cloud Storage.

Senza il tipo di abbonamento per l'archiviazione Cloud Storage, hai bisogno di una sottoscrizione pull o push e di un sottoscrittore (ad esempio Dataflow) che legga i messaggi e li scriva in un bucket Cloud Storage. Il sovraccarico 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 invece una sottoscrizione Cloud Storage.

Per modifiche leggere ai messaggi o agli attributi, puoi collegare una trasformazione di un singolo messaggio alla abbonamento per l'archiviazione Cloud Storage. Tuttavia, una pipeline Dataflow è consigliata per i sistemi Pub/Sub in cui è richiesta una trasformazione dei dati più complessa prima che i dati vengano archiviati in un bucket Cloud Storage, soprattutto se vuoi creare finestre o aggregare i messaggi.

Per scoprire come eseguire lo streaming dei dati da Pub/Sub a Cloud Storage con la trasformazione utilizzando Dataflow, consulta l'articolo Trasmetti flussi di messaggi da Pub/Sub utilizzando Dataflow.

Prima di iniziare

Prima di leggere questo documento, assicurati di conoscere i seguenti argomenti:

Flusso di lavoro dell'abbonamento per Cloud Storage

L'immagine seguente mostra il flusso di lavoro tra una sottoscrizione Cloud Storage e Cloud Storage.

Flusso di messaggi per un abbonamento per Cloud Storage

Figura 1. Flusso di lavoro per un abbonamento per Cloud Storage

Di seguito è riportata una breve descrizione del flusso di lavoro che fa riferimento alla Figura 1:

  1. Pub/Sub utilizza l'API Storage per inviare 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 dei batch in base alle dimensioni dell'oggetto e al tempo trascorso dalla creazione dell'oggetto.

  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 finalizzato 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 nella sottoscrizione, il messaggio viene spostato nell'argomento messaggi non recapitabili.

Proprietà di un abbonamento per Cloud Storage

Quando crei una sottoscrizione Cloud Storage, devi specificare alcune proprietà aggiuntive. Queste proprietà includono proprietà di sottoscrizione comuni, requisiti di nome file e formato, requisiti di archiviazione e altro ancora. Per saperne di più su queste proprietà, consulta Proprietà dell'abbonamento per l'archiviazione Cloud Storage.

Gestire gli errori relativi ai messaggi

Quando non è possibile scrivere un messaggio Pub/Sub in un bucket Cloud Storage, il messaggio non può essere riconosciuto. Per inoltrare questi messaggi non recapitabili, configura un argomento messaggi non recapitabili nella sottoscrizione Cloud Storage.

Se Pub/Sub non riesce a scrivere i messaggi in Cloud Storage, esegue il backoff della consegna dei messaggi in modo simile al comportamento di backoff push.

Quote

Le limitazioni delle quote si applicano alla velocità effettiva del sottoscrittore Cloud Storage per ogni regione. Per informazioni sulle quote per le sottoscrizioni Cloud Storage, consulta Limiti delle quote dei sottoscrittori dell'esportazione in Quote e limiti di Pub/Sub.

Prezzi

Per informazioni sui prezzi delle sottoscrizioni Cloud Storage, consulta la pagina dei prezzi di Pub/Sub.

Passaggi successivi