Skip to main content
Version: 10.x (Current)

Bucket Storage Support Overview

This page presents an overview of a new Fast Data add-on feature, named Bucket Storage Support.


Application data can be stored in multiple locations and different types of database systems. Data get useful especially when they can be easily accessed by users, aggregated, transformed and stored again to provide further functionalities and additional insights. To foster this speed and fulfill business requirements, data are moved across different systems using streaming platforms, such as Apache Kafka, so that applications can access only the portion of information relevant to them and in the more appropriate format.

Sometimes, messages employed to transfer data across systems must be retained for a long period of time which might be longer than the data access life itself (e.g. for legal reasons). On the contrary, sometimes no requirement is set on message retention, but the system might need the ability to replay certain messages if requested, either to reload specific data that might have already been deleted or update details that might have fallen into an inconsistent state. Exploiting the messages channel as a retention solution could be feasible, but that depends on the adopted technologies. Moreover, channels are usually tailored for near real-time application that deals with a huge amount of data in transit, making them a potentially expensive solution compared to other approaches where data are offloaded to external systems. Lastly, accessing very specific data might not be as easy and straightforward as the application requirements would demand (for example it could require processing sequentially a lot of unnecessary messages before reaching the interested one).

Taking into account all the previous reasons and considerations, Mia-Platform decided to develop a new functionality, the Bucket Storage Support, which can be integrated within any event-driven system, in particular Mia-Platform Fast Data product. Bucket Storage Support feature enables storing messages flowing through a channel into an external object storage system, such as a Google Cloud Storage bucket or any bucket compatible with Amazon AWS S3 interface.
The external archiving system can be configured to retain saved messages for a very long time and it enables a large array of different applications and processing over the stored data, promoting different types of access to the messages. The main feature that it is already available through the Bucket Storage Support is the ability to replay onto a channel messages that were previously read and stored in the bucket.

In the context of Fast Data, Bucket Storage Support can be seamlessly integrated attaching it to the same projections ingestion topics, which are the ones populated by a Change Data Capture (CDC) system and read by the Real-Time Updater. In this manner, beside supporting the near-real time data flow, Fast Data messages can be archived for future usage, either for performing analytics over those data or reloading them into the system to recreate Projections and Single Views that might have been deleted due to business requirements. More details can be found in the dedicated page.

Main Components

Bucket Storage Support feature involves multiple services, each of them in charge of a specific operation.

Ingestion Storer

The Ingestion Storer works following a series of steps:

  • consume ingestion messages (the ones that come from the CDC)
  • store them inside a configured bucket storage
  • produce a message on a dedicated topic representing the event of file written to the storage
  • optionally forwards as-is the ingestion messages to post-ingestion topic, depending on the input topic

Ingestion Reloader

The Ingestion Reloader is responsible for re-publishing, on the dedicated topic one or more messages. Depending on the adopted architecture, the service may rely on the post-ingestion topics or a set new ones for the specific for reingestion operation. It is important to notice that reingestion topics are configurable when the reingestion request is issued to allow a greater flexibility in selecting target topics.
This service exposes a series of REST APIs to cover different messages re-publishing use cases such as:

  • reloading messages from a single file stored on the bucket
  • reloading messages of a specific topic
  • reloading messages of a specific topic in a time rage
  • reloading messages with a specific key

Optionally the reingestion process of a specific topic can be stopped before its completion using the dedicated API.

Additional Components

Bucket Storage Support feature is configured so that further services can be connected to the system, so that they can process the files written into the bucket according to their own business logic. Components that acts on the files, combining messages from the initials, should be identified as Data Organizer plugins. In the following sections are reported the Data Organizer services that are already offered out of the box and that can be attached directly to the events emitted by the Ingestion Storer.

Data Organizer By Key

The Data Organizer By Key is responsible for keeping the bucket clean and organized, as the name suggests. This service will keep organizing the messages on the bucket, by clustering them based on their message key and by removing duplicated messages (with the same key and payload), retaining only last created message of these groups. This operation is carried out since accessing the last updated value of messages can sometimes be more relevant than retrieving all their historical values.


The original files are not deleted nor modified by this service. They are just reorganized into different files, so that multiple processing can occur over the original files.

Architecture Example

In the following image is provided the diagram of a possible architecture that employed all the three components. The Ingestion Storer is connected to a set of input topics, store consumed messages on a bucket storage, emit events related to those files written into the bucket and re-publish the input messages as is on the corresponding output topics. The Ingestion Reloader is configured to read from the bucket and it is connected to the output topics, so that downstream systems can read both the input messages and the re-published ones, whenever a reingestion operation is requested.

Bucket Storage Support Overview