Skip to main content
Data versioning and deprecation
Updated over a month ago

The Mapiq Data Connections feature allows customers to directly connect to their data to perform custom analyses using their preferred client application (such as Power BI or Tableau). The purpose of this policy is to minimize impact on businesses by allowing client applications to transition smoothly to the latest versions of data connections tables, as old versions of tables become deprecated.

Versioning strategy

Tables are versioned with a single major version number digit, included as suffix in the table names.

Example: dim_area_v1

In the event that breaking/backward incompatible changes need to be made to a table, the old table will be deprecated, and a new version of the table will be introduced with an incremented version number.

Example: dim_area_v2

Examples of breaking/backward incompatible changes include:

  • Removal of columns;

  • Column changes that would likely break client applications.

Examples of non-breaking/backward compatible changes include:

  • Addition of new columns;

  • Column changes that would be unlikely to break client applications.

Sunset policy

Deprecated tables will continue to be supported until a grace period has expired.

Unless stated otherwise on a case-by-case basis, the grace period for a deprecated table is 90 days. This means the table will continue to be available and receive data updates during the grace period.

Once the grace period has expired, the table may be removed from the data connections platform and may not receive data updates any longer.

As such, client applications must be transitioned to latest versions of tables prior to the grace period’s end date.

Notifications

Customers using the data connections platform will be provided with advance notice via e-mail, at least 30 days before a table is marked as deprecated.

Notifications will include the grace period start and end dates, and a technical migration guide intended to support the customer’s staff performing the transition, detailing the planned changes.

An additional final warning will be provided 30 days before the grace period end date.

Changes to Data Connection Versioning Policy

Mapiq reserves the right to modify, amend, or update this policy at its sole discretion. Changes may be made from time to time, and Mapiq will make reasonable efforts to notify customers of any significant modifications. It is the responsibility of the users to regularly review the policy for any updates. Continued use of Mapiq after the effective date of any modifications shall constitute acceptance of the modified policy.


💬 Need More Help?

If you’d like extra assistance, reach out via the Messenger (question mark in the corner) and chat with our support team, or email us at [email protected].

We’re always ready to help! 😉

Did this answer your question?