Applicable only to Microsoft Azure SQL Data Warehouse destinations, the _sdc_primary_keys table contains a list of the tables in an integration schema and the columns those tables use as Primary Keys. Every integration schema created by Stitch will contain this table.

In this guide, we’ll cover:

Usage in replication

Because Azure SQL Data Warehouse destinations don’t have native support for Primary Keys, Stitch uses the _sdc_primary_keys table to store Primary Key information and de-dupe data during loading incrementally-replicated tables.

Replication Methods and de-duping data

De-duplicating data only applies to tables using an Incremental Replication Method. This ensures that only the most recent version of a record is loaded into the table.

Tables using Full Table Replication are not de-duped, but loaded in full during each replication job.

Determining Primary Keys

Depending on the data source type, Primary Keys are determined in one of two ways:

  • For database integrations, Primary Keys are defined by you in the source database. This will usually be columns with a Primary Key constrant or some other equivalent, depending on the type of database being used.

    Note: For database views you set to replicate in Stitch, the Primary Key will be the field you define for the view during setup.

  • For SaaS integrations, Primary Keys are pre-defined by Stitch. Refer to the schema documentation for your SaaS integration for info on the Primary Keys Stitch uses for specific tables.

In every schema created by a Stitch integration will be a _sdc_primary_keys table. The Primary Key data for every table set to replicate will be stored in this table.

Primary Keys table schema

The _sdc_primary_keys table contains the following columns:

Column name Data type Description
table_name STRING

The name of the table in the integration schema.

Example data: emails
column_name STRING

The name of the column used as the table’s Primary Key. If a table uses multiple columns as a composite Primary Key, there will be a row for each column the table uses.

Example data: email_id
ordinal_position INTEGER

When Stitch receives data, Primary Keys are provided in an array. For example: ["email_id", "created_at", "customer_id"]

The value of this column corresponds to the index of the column in the array Stitch receives.

Example data: 0

Example table

For every column a table uses as a Primary Key, the _sdc_primary_keys table will contain a row containing the table’s name, the name of the column, and the column’s position in the Primary Key array Stitch receives.

For example: If Stitch received the array ["email_id", "updated_at", "customer_id"] for an emails table, the _sdc_primary_keys table would contain the following records:

table_name column_name ordinal_position
emails email_id 0
emails updated_at 1
emails customer_id 2

When Stitch loads data for the emails table, it will reference these records in _sdc_primary_keys to de-duplicate the data. This will ensure that only the most recent version of a record exists in the emails table.

Effects of Primary Key changes

Replication issues can arise if Primary Keys in the source change, or if data in the _sdc_primary_keys is incorrectly altered or removed.

Along with being unable to load data, Stitch will surface the following error if this occurs:

Primary Keys for table do not match Primary Keys of incoming data

If you recieve this error, you should reset the table(s) mentioned in the error. This will queue a full re-replication of the table, which will ensure Primary Keys are correctly captured and used to de-dupe data when loading.

Questions? Feedback?

Did this article help? If you have questions or feedback, feel free to submit a pull request with your suggestions, open an issue on GitHub, or reach out to us.