Documentation

Handling Schema Changes

Abstract

SummaryAn explanation of how to handle schema changes and related settings.

Your data's schema, and thus your event, is very likely to change. That's why Alooma's schema change handling gives you the option for how to handle such changes.

You can decide how Alooma will behave when a new field arrives or an existing field is changed in your data. Alooma will either automatically map the field (based on schema or data heuristics, depending on the input source) and add it to your data destination, or it will leave the field unmapped, which will send the event to the Restream Queue for you to decide how to handle at your convenience.

You can change this setting globally as well as override for any specific event type. Any event type that is coming from an input you created with OneClick will have new fields mapped automatically.

Global default setting

You can set the default handling of new unmapped event fields for all event types. If you choose to override the setting for a particular event type, the default will no longer apply to it.

  1. Click Mapper Configuration

    blackgear.png

    at the top left of the Mapper screen.

  2. In the Mapper Configuration screen, select one of the following options:

    • Strict: Default. All the events of an event type that contain unmapped fields are sent to the Restream queue (and not replicated into the data destination). A notification message is generated directing you to map this new event type.

    • Flexible: Each unmapped field of an event is discarded and the rest of the event is handled according to the defined mapping. This means that all mapped fields are replicated into the data destination and all unmapped fields are discarded.

    • Auto-mapped: Each new field in an event is automatically assigned a name compliant with the data destination and a data type suited to the field’s values or schema, based on Alooma’s auto-mapping logic. A new column is automatically created in the target table and this event field’s data is replicated into it.

Per event type setting

You can choose to override the global mapping setting per event type.

  1. Click the configuration gear

    gear.png

    next to an event type name.

  2. Select how you want this specific event type to be handled. The same options are provided as in the global setting. Selections made here are not reset by changes to the global setting.

Search results

    No results found