Sottoscrizioni Cloud Storage

Una sottoscrizione Cloud Storage è un tipo di sottoscrizione di esportazione che scrive i messaggi man mano che vengono ricevuti in un bucket Cloud Storage esistente. Non è necessario configurare un client abbonato 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 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 dell'esecuzione di un job Dataflow non è necessario quando i messaggi non richiedono ulteriori elaborazioni prima dell'archiviazione in un bucket Cloud Storage. Puoi utilizzare una sottoscrizione Cloud Storage.

Tuttavia, è comunque consigliata una pipeline Dataflow per i sistemi Pub/Sub in cui è necessaria una trasformazione dei dati prima che i dati vengano archiviati in un bucket Cloud Storage.

Per scoprire come trasmettere flussi di dati da Pub/Sub a Cloud Storage con la trasformazione utilizzando Dataflow, vedi Trasmettere messaggi da Pub/Sub utilizzando Dataflow.

Prima di iniziare

Prima di leggere questo documento, assicurati di acquisire familiarità con quanto segue:

Flusso di lavoro della sottoscrizione 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 dati al bucket Cloud Storage. Dopo il completamento 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 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 in un oggetto. La seconda risposta OK viene inviata quando l'oggetto contenente il messaggio è stato finalizzato. Un messaggio diventa visibile nel bucket solo dopo che l'oggetto Cloud Storage che lo contiene è stato finalizzato correttamente.

  4. In caso di errori durante l'operazione di scrittura, il messaggio Pub/Sub stesso viene confermato negativamente. Il messaggio viene quindi inviato di nuovo. Se l'operazione di scrittura del messaggio ha esito negativo per un certo numero di volte e hai configurato un argomento messaggi non recapitabili nella sottoscrizione, il messaggio viene spostato nell'argomento messaggi non recapitabili.

Proprietà di una sottoscrizione Cloud Storage

Quando crei una sottoscrizione a 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à, vedi Proprietà degli abbonamenti Cloud Storage.

Autorizzazioni per gli account di servizio Pub/Sub

Per creare una sottoscrizione 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 maggiori informazioni, consulta Assegnare ruoli di Cloud Storage all'account di servizio Pub/Sub.

Gestire gli errori relativi ai messaggi

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

Quote

Le limitazioni di quota si applicano alla velocità effettiva dell'abbonato Cloud Storage per ogni regione. Per informazioni sulle quote per gli abbonamenti a Cloud Storage, consulta l'articolo sui limiti delle quote degli abbonati in Quote e limiti di Pub/Sub.

Prezzi

Per informazioni sui prezzi degli abbonamenti a Cloud Storage, consulta la pagina dei prezzi di Pub/Sub.

Passaggi successivi