Skip to main content

​
Overview

Artie supports schema evolution out of the box, which means:
  • We automatically create tables in your destination if they don’t exist
  • We detect and add new columns automatically
  • We can drop deleted columns from the source (optional feature)

​
How do we know the right data types? 🔍

You can enable this feature by setting Enable hard deletes for columns to true in your destination’s advanced settings.Enable hard deletes for columns
For safety reasons, columns are not automatically dropped from destination tables since this operation is nearly irreversible. While some destinations support undos, we implement a strict safety check process:
  1. When a column is deleted from the source, the first row that omits this column marks it for potential removal
  2. We then monitor CDC events for 4 hours to ensure the column is consistently omitted
  3. Only after this verification period will we proceed with dropping the column
This safety mechanism helps prevent accidental data loss and ensures the column is truly no longer needed.

​
Advanced Features 🛠️

We provide additional configuration options to give you more control over schema evolution:
Use column exclusion to prevent specific columns from being added to your destination. This is particularly useful for:
  • Excluding sensitive data columns (e.g., PII, passwords)
  • Preventing unnecessary columns from being synced
  • Managing storage costs by excluding large or unused columns
To use this feature, simply specify the columns you want to exclude in your table’s advanced settings.
Column inclusion allows you to explicitly define which columns should be synced to your destination. This feature:
  • Gives you complete control over your destination schema
  • Helps maintain a clean, minimal dataset
  • Requires manual management of new columns
Column inclusion is mutually exclusive with column exclusion. When using this feature, you’ll need to manually add any new columns to your destination schema as they appear in the source.

​
Automatic schema changes

A company admin can enable Automatically apply supported schema changes from Settings > Company. This runs a separate reconciliation job that compares an eligible source table with its existing destination table and applies supported differences.

​
Which sources are supported?

Automatic schema changes apply to sources with authoritative column schemas: PostgreSQL, CockroachDB, MySQL, PlanetScale, Microsoft SQL Server, Oracle, and Amazon Keyspaces (Cassandra). The job also requires a destination that supports column metadata and an existing destination table.

​
When does the job run?

Artie schedules the job daily between 7:00 and 8:00 AM Pacific Time. It also queues reconciliation after an eligible pipeline redeploys, but not after a pipeline’s first deployment. Reconciliation runs asynchronously and does not determine whether a deployment succeeds. The scheduled job only processes eligible running, unlocked pipelines and applies a two-hour cooldown per pipeline, so repeated checks or redeployments do not necessarily start another reconciliation immediately. Redeploy-triggered reconciliation also does not enqueue when the pipeline’s data plane is locked.

​
Run a check on demand

Use the Dashboard API when you need to request reconciliation before the next scheduled run:
  • POST /company/automatic-schema-changes requests checks for every eligible running pipeline in the authenticated company. An environment-scoped API key only includes pipelines in that environment.
  • POST /pipelines/{uuid}/automatic-schema-changes requests a check for one eligible pipeline.
Both requests return 202 Accepted after Artie queues or coalesces the work; they do not wait for schema reconciliation to finish. The company setting must be enabled, and a pipeline request requires a running, unlocked pipeline. Existing source and destination prerequisites, column inclusion and exclusion rules, hard-delete settings, and the two-hour cooldown still apply.

​
Does it only add columns?

By default, yes: the job adds source columns that are missing from an existing destination table. It does not rename columns or change the type of an existing destination column. It can also drop a destination column only when Enable hard deletes for columns is enabled in the destination’s advanced settings. Column inclusion and exclusion still determine which source columns Artie can add. Dropping columns remains subject to the safety process below.