Una suscripción de Cloud Storage es un tipo de suscripción de exportación que escribe mensajes en un segmento de Cloud Storage a medida que se reciben. No es necesario configurar un cliente de suscriptor independiente. Usa la Google Cloud consola, la CLI de Google Cloud, las bibliotecas de cliente o la API Pub/Sub para crear, actualizar, enumerar, separar o eliminar una suscripción de Cloud Storage.
Si no tienes el tipo de suscripción de Cloud Storage, necesitas una suscripción de extracción o de inserción y un suscriptor (como Dataflow) que lea los mensajes y los escriba en un segmento de Cloud Storage. No es necesario incurrir en la sobrecarga de ejecutar un trabajo de Dataflow cuando los mensajes no requieren un procesamiento adicional antes de almacenarlos en un segmento de Cloud Storage. En su lugar, puedes usar una suscripción de Cloud Storage.
Sin embargo, sigue siendo recomendable usar una canalización de Dataflow en sistemas de Pub/Sub en los que se requiera alguna transformación de datos antes de que estos se almacenen en un segmento de Cloud Storage.
Para saber cómo transmitir datos de Pub/Sub a Cloud Storage con transformación mediante Dataflow, consulta Transmitir mensajes de Pub/Sub mediante Dataflow.
Antes de empezar
Antes de leer este documento, asegúrate de que conoces los siguientes conceptos:
Cómo funciona Pub/Sub y los diferentes términos de Pub/Sub.
Cuáles son los diferentes tipos de suscripciones y por qué te puede interesar usar una suscripción a Cloud Storage.
Cómo funciona Cloud Storage.
Flujo de trabajo de suscripción a Cloud Storage
En la siguiente imagen se muestra el flujo de trabajo entre una suscripción de Cloud Storage y Cloud Storage.
Imagen 1. Flujo de trabajo de una suscripción a Cloud Storage
A continuación, se incluye una breve descripción del flujo de trabajo que se muestra en la imagen 1:
Pub/Sub usa la API de Cloud Storage para enviar datos al segmento de Cloud Storage. Cuando se completa correctamente una operación de escritura, la API devuelve una respuesta
OK
.Los mensajes se envían en lotes al segmento de Cloud Storage. Un solo lote corresponde a un objeto que se almacena en el segmento de Cloud Storage. Puede configurar los ajustes de lote en función del tamaño del objeto y del tiempo transcurrido desde que se creó.
El flujo de trabajo para escribir un objeto en un segmento de Cloud Storage requiere dos respuestas
OK
. La primera respuestaOK
se envía cuando se escribe un mensaje en un objeto correctamente. La segunda respuestaOK
se envía cuando se finaliza el objeto que contiene el mensaje. Un mensaje solo se hace visible en el segmento después de que se haya finalizado correctamente el objeto de Cloud Storage que lo contiene.Si se produce algún fallo durante la operación de escritura, el mensaje de Pub/Sub se confirma de forma negativa. Después, se vuelve a enviar el mensaje. Si la operación de escritura del mensaje falla suficientes veces y tienes configurado un tema de mensajes fallidos en la suscripción, el mensaje se moverá al tema de mensajes fallidos.
Propiedades de una suscripción a Cloud Storage
Cuando creas una suscripción de Cloud Storage, debes especificar algunas propiedades adicionales. Estas propiedades incluyen propiedades comunes de las suscripciones, requisitos de nombre de archivo y formato, requisitos de almacenamiento y más. Para obtener más información sobre estas propiedades, consulta Propiedades de suscripción de Cloud Storage.
Gestionar fallos de mensajes
Cuando no se puede escribir un mensaje de Pub/Sub en un segmento de Cloud Storage, no se puede confirmar. Para reenviar estos mensajes que no se pueden entregar, configura un tema de mensajes fallidos en la suscripción de Cloud Storage.
Si Pub/Sub no puede escribir mensajes en Cloud Storage, Pub/Sub retrocede en la entrega de mensajes de forma similar al comportamiento de retroceso de inserción.
Cuotas
Se aplican limitaciones de cuota al rendimiento de suscripción de Cloud Storage en cada región. Para obtener información sobre las cuotas de las suscripciones de Cloud Storage, consulta los límites de cuota de suscriptor de exportación en Cuotas y límites de Pub/Sub.
Precios
Para obtener información sobre los precios de las suscripciones de Cloud Storage, consulta la página de precios de Pub/Sub.
Siguientes pasos
- Crea una suscripción a Cloud Storage.
Soluciona problemas con una suscripción a Cloud Storage.
Explora las herramientas de configuración de Pub/Sub:
- Comandos de la CLI de
gcloud
- APIs de Pub/Sub
- Bibliotecas de cliente de Pub/Sub
- Comandos de la CLI de